Reference/CLI Commands Reference
DocsReference

CLI Commands Reference

Complete listing of all Athena CLI commands and descriptions.

Commands Matrix

CommandWhat it does
athena initAnalyze the project and create .athena/ knowledge
athena analyzeRe-analyze and refresh generated knowledge (your edits are preserved)
athena syncReview and apply knowledge updates for changes since the last analysis
athena watchWatch files and propose knowledge updates as they change
athena openStart the local web UI
athena context "<task>"Show which knowledge an agent should read for a task, and why
athena graph / athena architectureInspect or summarize the project graph
athena agents · agents add <id> · agents remove <id>List, add or remove agent integrations
athena activityShow agent activity observed through hooks
athena mcpServe Athena over MCP (stdio); add --allow-write to allow update_knowledge to write
athena securityRun your ecosystems' audit tools and report secret findings (--fail-on <severity>, --no-audit, --last)
athena reviewCheck the current git diff (--base <ref> for a branch or PR)
`athena git-hook install\uninstall\status`Manage the pre-commit knowledge check (new in v0.2.0)
athena rulesList and edit project rules
athena statusKnowledge health and changes since the last analysis
athena doctorCheck the installation, project and integrations
athena ai status / athena ai enrichOptional AI provider setup and INFERRED suggestions
athena cleanRemove .athena/ and Athena's agent integrations (asks first; --yes to skip, --keep-agents to keep integrations)
athena versionPrint the Athena version