revisor

name	revisor
description	Runs revisor for codex-powered github pull request review, issue debugging, and issue fixing. Use when the user asks to review a github pr, diagnose a github issue or bug report, fix an issue with a pr, or use revisor from an agent workflow.

revisor

quick start

use revisor when the task is centered on a github pr or issue and the user wants a disposable codex-powered review, diagnosis, or fix.

revisor review https://github.com/owner/repo/pull/123
revisor debug https://github.com/owner/repo/issues/456
revisor fix https://github.com/owner/repo/issues/456 --yes

choose the command

command	use when	behavior
review	the target is a github pull request	clones the pr into a temp checkout and runs a read-only codex review
debug	the user wants root cause analysis or a non-mutating answer	runs codex read-only and returns diagnosis, evidence, suspected files, and smallest fix
fix	the user wants the issue fixed	clones the repo, runs codex, commits the diff, pushes a branch, and opens or updates a pr
issue	the user says issue but wants a fix	alias for fix

prefer debug when the user asks what is wrong, why something fails, or wants an explanation. prefer fix when the user asks to repair, patch, implement the issue, or open a pr.

agent usage

for non-interactive agent runs, pass json and no-prompt flags:

revisor debug https://github.com/owner/repo/issues/456 --no-input --json
revisor fix https://github.com/owner/repo/issues/456 --yes --no-input --json

use --dry-run --json before a mutating fix when you need to inspect the planned codex prompt and github actions:

revisor fix https://github.com/owner/repo/issues/456 --dry-run --yes --no-input --json

use --patch-only when the user wants the fix but does not want a branch pushed or pr opened:

revisor fix https://github.com/owner/repo/issues/456 --patch-only --patch ./issue-456.patch --yes

safety checks

• confirm codex, git, and gh are installed before real runs.
• do not use fix without user intent to mutate github state. it opens or updates a pr by default.
• use debug for read-only diagnosis.
• use review only for pull request urls.
• use --keep only when the user needs the temp checkout; revisor deletes temp workspaces by default.
• if a command fails, report the revisor command, exit code, and the relevant stderr/stdout lines.

output handling

when --json is used, treat the json summary as the stable completion artifact. progress and codex output can still appear on stdout or stderr, so do not parse free-form logs as the contract.