Optional AI Providers
Configuring Anthropic, OpenAI, Gemini, or Ollama for enriched suggestions.
The provider is chosen in .athena/config.json. Check the setup with athena ai status.
athena ai enrich sends redacted knowledge documents to the provider and writes the answer to a separate file, .athena/ai-suggestions.md, labeled INFERRED. It never edits your knowledge documents.
Flags: --docs <list> (default: project, architecture, database, api), --dry-run (shows exactly what would be sent and sends nothing), and --consent (required before sending anything to a remote provider).
Default models: Anthropic claude-sonnet-5, OpenAI gpt-4.1-mini, Google gemini-2.5-flash, Ollama llama3.1. API keys are read from ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY (or GOOGLE_API_KEY). Ollama runs locally.
$ athena ai enrich --dry-run
Provider: Ollama (local) · model llama3.1
Would send: project.md, architecture.md, database.md, api.md (redacted)
Nothing sent (dry run).