Index a codebase into evidence-backed memory so agents can answer with citations
Use AtlasMemory when an agent keeps losing repo context and needs indexed, evidence-linked answers with file and line anchors instead of re-reading the whole codebase every session.
Prerequisites
Node.js 18+; npm or npx; a local codebase to index; an MCP-compatible client; optional Claude CLI or OpenAI Codex CLI access if you want AtlasMemory's semantic enrichment features.
Installation
Use the upstream install or setup path that matches your environment:
- npx atlasmemory index . # Step 1: Index (automatic)
- npx atlasmemory enrich --all # Step 2: AI-enhance all files
- npx atlasmemory generate # Step 3: Generate AI instructions
- npx atlasmemory status # Check your AI Readiness Score
Requirements and caveats from upstream:
- How it works: AtlasMemory uses Claude CLI or OpenAI Codex (running locally) to analyze files. Requires an active Claude or OpenAI subscription with CLI access.
Basic usage or getting-started notes:
After indexing, run enrichment for maximum AI readiness:
| 0-50 (Fair) | Keyword only | Run atlasmemory enrich — dramatically improves results |
| 50-80 (Good) | Partial semantic | Run atlasmemory enrich --all for full coverage |
Extracted from upstream docs: https://raw.githubusercontent.com/Bpolat0/atlasmemory/HEAD/README.md