​
axguard: command not found

Activate the venv:
Reinstall with pip install -e . from the clone root.

​
Slash commands missing in the agent

Re-run:
Restart the agent. Skills and commands load at startup.

​
Zero findings on a real project

  • Confirm you are scanning source, not a build/dist tree
  • Sanity-check the toolchain:
Expect findings (on current main, the bundled app reports on the order of dozens).

​
Too many findings

Or use /axguard-triage in an agent. Prefer evidence over deleting signal blindly.

​
MCP tools missing

The mcp command is hidden when the extra is absent. Ensure the host config points at the same axguard binary as the venv. See AI agents.

​
Audit finished but a diagnostic section is empty

By design the audit continues if a soft stage fails. Re-run the stage directly:

​
GitHub bot validate fails

Check env vars named in .axguard.yml exist (not the secrets in the YAML file). Run axguard github status . and axguard github test .. See GitHub.

​
Looking for axguard preship or axguard diff

Those CLI commands are not shipped. See Pre-ship and Security Diff.