Commands
@gittensory command reference
The full PR and issue-comment control surface: Q&A verbs, maintainer digests, and PR action commands. Roles reflect the shipped default policy; maintainers can override per command in .gittensory.yml.
Gate vs auto-review
Commands never flip the gate to advisory and never bypass the one-shot disposition.
pause and resume affect only auto-review scheduling — not gate enforcement. See How reviews work for the gate/review split.Syntax
Post a comment on a pull request (or issue thread) mentioning @gittensory followed by a verb. Trailing free text becomes the command argument where noted (for example @gittensory ask what should I fix first?).
@gittensory <verb> [argument or reason]Public Q&A commands
| Syntax | Effect | Default roles |
|---|---|---|
| @gittensory help | Show public-safe @gittensory command help. | maintainer, collaborator, confirmed_miner (default policy) |
| @gittensory ask | Answer contribution-quality questions from connected cached sources with citations. | maintainer, collaborator, confirmed_miner |
| @gittensory preflight | Summarize public PR hygiene and validation readiness. | maintainer, collaborator, confirmed_miner |
| @gittensory blockers | Explain public-safe readiness blockers. | maintainer, collaborator, confirmed_miner |
| @gittensory duplicate-check | Summarize duplicate and in-progress overlap caution. | maintainer, collaborator, confirmed_miner |
| @gittensory miner-context | Confirm public Gittensor miner context when available. | maintainer, collaborator, confirmed_miner |
| @gittensory next-action | Suggest the next public-safe action. | maintainer, collaborator, confirmed_miner |
| @gittensory reviewability | Summarize maintainer-friendly PR readiness without private review internals. | maintainer, collaborator, confirmed_miner |
| @gittensory repo-fit | Summarize public-safe repository fit signals. | maintainer, collaborator, confirmed_miner |
| @gittensory packet | Prepare public-safe PR packet guidance. | maintainer, collaborator, confirmed_miner |
Maintainer queue digests
| Syntax | Effect | Default roles |
|---|---|---|
| @gittensory queue-summary | Post a maintainer-only queue digest from cached GitHub metadata. | maintainer, collaborator |
| @gittensory confirmed-miners | List open PRs whose authors are confirmed in the official-miner cache. | maintainer, collaborator |
| @gittensory review-now | List cached PRs that look ready for maintainer review. | maintainer, collaborator |
| @gittensory needs-author | List cached PRs that need author cleanup before detailed review. | maintainer, collaborator |
| @gittensory duplicate-clusters | List duplicate or WIP clusters visible from cached GitHub metadata. | maintainer, collaborator |
| @gittensory burden-forecast | Project maintainer review load and queue-growth risk from cached metadata. | maintainer, collaborator |
| @gittensory intake-health | Summarize contributor-intake health from cached queue and config signals. | maintainer, collaborator |
| @gittensory outcome-patterns | Summarize what this repo actually merges vs closes from cached PR outcomes. | maintainer, collaborator |
| @gittensory noise-report | Highlight queue noise sources maintainers should triage first. | maintainer, collaborator |
PR action commands
| Syntax | Effect | Default roles |
|---|---|---|
| @gittensory gate-override | Record a maintainer override for this commit's gate check only (does not persist across new commits). | maintainer, collaborator |
| @gittensory review | Request an auto-review run on the current PR head (`@gittensory re-review` is an alias). | maintainer, collaborator, confirmed_miner |
| @gittensory pause | Pause auto-review for this PR with an optional reason; does not change gate enforcement. | maintainer, collaborator |
| @gittensory resume | Resume auto-review for this PR with an optional reason; does not change gate enforcement. | maintainer, collaborator |
| @gittensory resolve | Mark a review finding as resolved, optionally naming the finding in trailing text. | maintainer, collaborator |
| @gittensory configuration | Show the effective resolved review configuration for this repository. | maintainer, collaborator |
| @gittensory explain | Explain a specific review finding; supply the finding reference in trailing text. | maintainer, collaborator |
Per-command authorization overrides
Default allowed roles ship in the worker configuration. A maintainer can tighten or widen a single verb via commandAuthorization in .gittensory.yml (resolved in the same order as other per-repo settings: manifest → database → defaults).
commandAuthorization:
default: [maintainer, collaborator, confirmed_miner]
commands:
review: [maintainer, collaborator, confirmed_miner]
pause: [maintainer, collaborator]
gate-override: [maintainer, collaborator]Maintainer-only digest verbs ignore a plain pr_author role even when widened — only maintainer, collaborator, and confirmed_miner survive the clamp for those commands.
Related docs
- Maintainer workflow — when to invoke commands in a PR thread
- How reviews work — gate, dual-AI review, and unified comment
- Tuning your reviews — per-repo review and agent execution modes