Trylle Documentation

Inspect diffs, leave inline feedback, resolve conversations, and submit review decisions.

Trylle's standard review page keeps the changed-file tree, diff, comments, and review decision in one workflow. Use it for every pull request; Zen review is an optional focused view for eligible changes.

Review a pull request

Read the context

Confirm the pull request's base and head branches, description, current checks, requested reviewers, and existing review decisions before opening the diff.

Inspect every changed file

Navigate with the file tree and choose a unified or split diff. Move between comments from the review controls instead of losing your place in a large change.

Leave inline feedback

Add comments to changed lines. Inline comments remain pending until you submit the review, which lets related notes arrive together.

Submit one decision

Choose Comment, Approve, or Needs changes, add a summary when it helps the author, and submit the review.

An approval or needs-changes decision is different from an ordinary pull request comment. Branch protection evaluates submitted review decisions when it counts approvals or blocks on rejected and outstanding reviews.

From the CLI, submit exactly one decision:

try pr review NUMBER -R OWNER/NAME \
  --approve \
  --body-file review.md

Replace --approve with --request-changes or --comment. Inline CLI comments also require the current pull request head SHA through --commit-id; see the command reference before scripting them.

Continue conversations

Replies to native inline comments form review conversations. Resolve a conversation after its concern has been addressed, and unresolve it when new work reopens the concern. Resolution records discussion state; it does not replace the review decision required by a branch rule.

New commits can make existing approvals stale when the matching branch rule is configured to dismiss or restrict them. Re-check the review summary after every substantial push.

Viewed files are session-local

The standard review page can track files viewed during the current session, but that progress is not durable server state. Reloading or starting another session may not preserve it, and other reviewers do not receive it as shared completion data.

Use Zen review

Zen review provides a focused review experience backed by a generated and cached AI changelog. It is available only when:

you own the repository or are a direct repository collaborator; and
the pull request is below the current changed-line limit.

Team-based or other inherited access alone does not satisfy the direct collaborator requirement. Generating the changelog can consume hosted AI credit. The standard review page remains available when Zen is ineligible or when you do not want to use hosted AI.

Review from the terminal

Read the pull request and open the interactive viewer:

try pr view NUMBER -R OWNER/NAME
try diff --pr NUMBER --origin OWNER/NAME

The terminal viewer's annotations and viewed markers are local session state; they are not published as native review comments. See diff reviews for navigation, annotations, and the review hand-off workflow.

Code Review