Axon Shaft docs

Overrides and audit

Every way to override a review or skip one, who can use it, where it's recorded, and what carries over to the next push.

An override changes what Axon Shaft does on a pull request. None of them changes a past run: a run's page keeps the card it had, and each commit keeps its own check runs.

The ways to override

OverrideWho can use itWhat it doesRecorded inCarries over to the next push
/reviewWrite accessReviews a pull request that an event setting, the forks setting, a filter or a skip label held back.GitHub: the commentNo: the next push follows the settings again
A skip labelAnyone GitHub lets add labelsSkips reviews on pull request events.GitHub: the label eventYes, until the label is removed
Resolving an inline threadAnyone who can resolve threads on GitHubCloses the thread. The finding isn't posted again inline, but the next review still lists it in the summary if it still finds it.GitHubYes
Settings and automations on the dashboardThe account's admin, or the Admin or Maintain role on the repoChanges what every later run does: checklists, filters, gates, rules, model and the rest.The audit logYes
Pausing the projectThe account's admin, or the Admin or Maintain role on the repoStops every run on the repo, commands included.The audit logYes, until it's resumed
Turning a checklist offThe account's admin, or the Admin or Maintain role on the repoIts chip shows ➖ and it posts no check run.The audit logYes

Commands from someone without write access start nothing, and axonshaft[bot]'s own comments and other bots' comments never start a run.

An override isn't an ignore

/review and the skip settings decide whether a review runs. They don't hide a finding. When a review runs, it reports what it finds, and a finding stays in the summary comment until a review finds it fixed.

There's no way to dismiss one finding so that later reviews leave it out. To stop one kind of finding on a project, turn off its checklist, or add a review rule on the dashboard that says what not to flag.

The audit log

The audit log records every change made on the dashboard: projects added, removed, paused and resumed, automations added, changed, reset and removed, Claude tokens saved and deleted, settings changed, and workflow files added or updated. Each entry names who made it, the project and the fields that changed, never the values. The account's admin reads it in the account's settings. Entries are kept for 3 months. See Audit log.

Past runs

  • A run's page keeps the card, findings and reply it had, for 7 days. The workflow run stays on GitHub.
  • The summary comment on the pull request shows only the latest review, since each push edits it.
  • Each commit keeps the check runs its review posted. A later push posts new ones on the new commit and doesn't change the old ones.

Last updated on