Support ~ Nuntius

Permissions

Minimum repository permissions for review, merge, and apply:

Metadata: read
Pull requests: read & write
Issues: read & write
Contents: read & write

Everything else can remain at no access. Comment-level access alone is not enough for write operations.

Webhook events

Pull request
Issue comment
Pull request review comment

The third event enables commands posted as inline file comments on the Files changed tab.

Commands

/analyze           Start or refresh a review
/analyze --force-review   Repost inline suggestions
/apply             Apply code suggestions when authoring is enabled
/merge             Merge with a merge commit
/squash            Squash and merge
/rebase            Rebase and merge
/pause             Stop auto analysis on new commits
/resume            Re-enable auto analysis
/status            Show current analysis state
/help              List available commands

Commands work from conversation comments and, when enabled, inline file comments. Write-capable commands require write or admin access.

Fixes shipped

Symptom	Cause	Resolution
`/apply` returned 500 with pr unbound	Code path used `pr` when there were no suggestions	Fetch repo and pr before branching; added tests
`/analyze` skipped due to existing analysis for SHA	Dedup logic applied to manual reruns	Use `/analyze --force-review` to repost inline suggestions
PR comment posted but no inline suggestions	Analysis did not produce valid suggestion blocks	Keep the main analysis comment, skip empty review creation
Inline `/analyze` comment on Files changed ignored	Webhook handler only processed issue comments	Added handling for pull request review comment events
`/apply` said no code suggestions found	Parser expected `--- a/` headers; deletions unsupported	Support simplified diff blocks and deletion operations
`/apply` ran for external contributors	Missing permission gating	Require authoring enabled and write or admin access
Wanted multi-line inline review comments	Only single-line comments supported	Added optional range comments gated by environment variable
Need to stop auto reviews on a noisy PR	No per-PR control for auto triggers	Introduced `/pause` and `/resume` using a PR label

Quota cooldown

When Gemini returns a quota or rate-limit error, Nuntius posts a notice and skips auto-analysis for a configurable window.

NUNTIUS_QUOTA_COOLDOWN_SECONDS=1800

Use 300 (5 minutes), 1800 (30 minutes, default), or 0 to disable.

Range comments

By default, inline review comments anchor to a single line. Enable range comments for GitHub's block-level comment UI.

NUNTIUS_ENABLE_RANGE_COMMENTS=1

Leave this off if single-line suggestions are enough. Range comments can be helpful for block-level guidance.

Validation checklist

Create a PR with a small code change
Comment /analyze in conversation or as an inline file comment
Verify the main analysis comment updates
Test /analyze --force-review to repost inline suggestions
When authoring is enabled, test /apply and confirm a commit lands on the PR branch
Test merge commands: /merge, /squash, /rebase
Pause and resume: /pause, /resume

Found something unexpected? Report an issue.