Reference
codingassist review
Run a deterministic review on a pull request from your terminal.
codingassist review [pr] [flags]Triggers a review on a single PR and prints the verdict to stdout. Exit code is non-zero when the verdict is escalate or declined, making it CI-friendly.
Synopsis
# Review the current branch's PR
codingassist review
# Review a specific PR
codingassist review 42
# JSON output, no colour
codingassist review 42 --json --no-colorFlags
| Flag | Default | Description |
|---|---|---|
--pr <n> | current branch | PR number to review |
--ticket <id> | auto | Override the ticket binding |
--policy <name> | tenant default | Run with a non-default policy |
--fail-on <list> | escalate,declined | Comma-separated verdicts that exit non-zero |
--json | false | Emit JSON instead of human output |
--trace | false | Print the full reasoning trace |
--dry-run | false | Do everything except persist the verdict |
Exit codes
| Code | Meaning |
|---|---|
0 | Verdict allowed (per --fail-on) |
1 | Verdict blocked |
2 | Misconfiguration (no token, repo not connected) |
3 | Network or platform error |
Examples
Block merge unless auto-approved
codingassist review --fail-on "human-review,escalate,declined"Review every open PR in a script
gh pr list --json number -q '.[].number' | \
xargs -I{} codingassist review {} --jsonRelated
Was this page helpful?