zz-jason/Otter Reviewer
Run an agent CLI on a self-hosted runner and post GitHub PR inline review comments as a GitHub App.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| app-id | GitHub App ID for the Otter Reviewer app. | yes | — |
| private-key | GitHub App private key in PEM form. Escaped newlines are accepted. | yes | — |
| installation-id | Optional GitHub App installation ID. If omitted, it is resolved from the current repository. | no | "" |
| max-inline-comments | Maximum number of inline comments to post. | no | 10 |
| post-empty-review | Post a visible review when the agent finds no actionable inline comments. | no | true |
| dry-run | Print the GitHub review payload instead of posting it. | no | false |
| codex-home | CODEX_HOME directory containing config.toml. | no | "" |
| codex-profile | Optional Codex config profile. | no | "" |
| codex-model | Optional Codex model override. | no | "" |
| review-instructions | Optional extra review instructions appended to the agent prompt. | no | "" |
| agent-command | Optional executable for a custom review agent. It receives the review prompt on stdin and must output JSON matching schema/review.schema.json. When omitted, Codex is used. | no | "" |
| agent-args-json | JSON array of custom agent arguments. Supports {repoRoot}, {schemaPath}, {outputPath}, {promptPath}, and {maxComments} placeholders. | no | [] |
| agent-env-pass | Comma-separated environment variable names to pass to a custom agent in addition to the default safe environment. | no | "" |
| agent-timeout-seconds | Maximum seconds to wait for the agent CLI. | no | 900 |
| max-diff-bytes | Maximum PR diff bytes to send to the agent. | no | 250000 |
| allow-fork-prs | Allow reviewing fork pull requests. Use only with isolated runners and no sensitive agent credentials. | no | false |
| review-drafts | Review draft pull requests. | no | false |
| pr-number | Optional pull request number. Useful for workflow_dispatch and reusable workflow callers. | no | "" |
Outputs
no outputs