Commands
@loopover 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 .loopover.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 @loopover followed by a verb. Trailing free text becomes the command argument where noted (for example @loopover ask what should I fix first?).
@loopover <verb> [argument or reason]Public Q&A commands
| Syntax | Effect | Default roles |
|---|---|---|
| @loopover help | Show public-safe @loopover command help. | maintainer, collaborator, confirmed_miner (default policy) |
| @loopover ask | Answer contribution-quality questions from connected cached sources with citations. | maintainer, collaborator, confirmed_miner |
| @loopover chat | Answer a question in natural prose from cached decision-pack facts via local Ollama (maintainer/collaborator; read-only). | see policy |
| @loopover preflight | Summarize public PR hygiene and validation readiness. | maintainer, collaborator, confirmed_miner |
| @loopover blockers | Explain public-safe readiness blockers. | maintainer, collaborator, confirmed_miner |
| @loopover duplicate-check | Summarize duplicate and in-progress overlap caution. | maintainer, collaborator, confirmed_miner |
| @loopover miner-context | Confirm public Gittensor miner context when available. | maintainer, collaborator, confirmed_miner |
| @loopover next-action | Suggest the next public-safe action. | maintainer, collaborator, confirmed_miner |
| @loopover reviewability | Summarize maintainer-friendly PR readiness without private review internals. | maintainer, collaborator, confirmed_miner |
| @loopover repo-fit | Summarize public-safe repository fit signals. | maintainer, collaborator, confirmed_miner |
| @loopover packet | Prepare public-safe PR packet guidance. | maintainer, collaborator, confirmed_miner |
Maintainer queue digests
| Syntax | Effect | Default roles |
|---|---|---|
| @loopover queue-summary | Post a maintainer-only queue digest from cached GitHub metadata. | maintainer, collaborator |
| @loopover confirmed-miners | List open PRs whose authors are confirmed in the official-miner cache. | maintainer, collaborator |
| @loopover review-now | List cached PRs that look ready for maintainer review. | maintainer, collaborator |
| @loopover needs-author | List cached PRs that need author cleanup before detailed review. | maintainer, collaborator |
| @loopover duplicate-clusters | List duplicate or WIP clusters visible from cached GitHub metadata. | maintainer, collaborator |
| @loopover burden-forecast | Project maintainer review load and queue-growth risk from cached metadata. | maintainer, collaborator |
| @loopover intake-health | Summarize contributor-intake health from cached queue and config signals. | maintainer, collaborator |
| @loopover outcome-patterns | Summarize what this repo actually merges vs closes from cached PR outcomes. | maintainer, collaborator |
| @loopover noise-report | Highlight queue noise sources maintainers should triage first. | maintainer, collaborator |
PR action commands
| Syntax | Effect | Default roles |
|---|---|---|
| @loopover gate-override | Record a maintainer override for this commit's gate check only (does not persist across new commits). | maintainer, collaborator |
| @loopover review | Request an auto-review run on the current PR head (`@loopover re-review` is an alias). | maintainer, collaborator, confirmed_miner |
| @loopover pause | Pause auto-review for this PR with an optional reason; does not change gate enforcement. | maintainer, collaborator |
| @loopover resume | Resume auto-review for this PR with an optional reason; does not change gate enforcement. | maintainer, collaborator |
| @loopover resolve | Mark a review finding as resolved, optionally naming the finding in trailing text. | maintainer, collaborator |
| @loopover configuration | Show the effective resolved review configuration for this repository. | maintainer, collaborator |
| @loopover explain | Explain a specific review finding; supply the finding reference in trailing text. | maintainer, collaborator |
| @loopover generate-tests | Generate an AI E2E test for this PR's changed behavior and post it as a reply comment (maintainer-only). | see policy |
Per-command authorization overrides
Default allowed roles ship in the worker configuration. A maintainer can tighten or widen a single verb via commandAuthorization in .loopover.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