embed
axiom-wiki embed [options]Axiom Wiki supports Hybrid Search, combining traditional keyword matching with modern vector embeddings. This allows the AI agent to find relevant context even if the exact keywords don’t match.
Options
Section titled “Options”| Option | Description |
|---|---|
--setup | Launch the interactive setup wizard to pick a provider and model. |
--reindex | Force a full re-index of all wiki pages. |
--status | Show the current embedding configuration and index size. |
Providers
Section titled “Providers”Axiom supports three embedding providers:
- Google Gemini (Recommended): High performance, generous free tier. Uses
text-embedding-004. - OpenAI: Industry standard. Uses
text-embedding-3-small. - Ollama: Total privacy, local-first. Uses
nomic-embed-text.
How it works
Section titled “How it works”When enabled, Axiom generates a vector embedding for every wiki page and stores them in a local Orama index (search.index).
Search queries are automatically converted to vectors, and the results are merged with keyword matches using Reciprocal Rank Fusion (RRF). This ensures that exact matches still rank highly while semantically related pages are surfaced.
Migration for Existing Users
Section titled “Migration for Existing Users”If you already have an Axiom Wiki but haven’t enabled semantic search:
- Upgrade: Ensure you are on
axiom-wiki@0.7.0or higher. - Setup: Run
axiom-wiki embed --setup. - Index: The wizard will guide you through picking a provider and will automatically trigger a full re-index of your existing pages.
Once complete, your AI agent will automatically start using hybrid search for all planning and context retrieval tasks.
Indexing Maintenance
Section titled “Indexing Maintenance”Indexing happens automatically during:
axiom-wiki ingestaxiom-wiki autowikiaxiom-wiki sync- Real-time updates via MCP
notify_code_change