<!--
Full-page Markdown export (rendered HTML → GFM).
Source: https://neotoma.io/docs
Generated: 2026-04-26T19:09:31.097Z
-->
# Documentation
All Neotoma documentation organized by category. Start with getting started if you are new, or jump to the reference section for API, MCP, and CLI details.
## Getting started
- [
EvaluateHave your agent read this page to decide whether Neotoma fits your workflow
](/evaluate)
- [
InstallInstall and initialize Neotoma locally
](/install)
- [
WalkthroughEnd-to-end example across operating, building, and debugging
](/walkthrough)
## Integrations
- [
Claude CodePersistent memory for Claude Code's local CLI agent
](/neotoma-with-claude-code)
- [
ClaudeStructured state alongside Claude platform memory
](/neotoma-with-claude)
- [
ChatGPTDeterministic memory for ChatGPT conversations
](/neotoma-with-chatgpt)
- [
CodexCross-task memory and CLI fallback
](/neotoma-with-codex)
- [
CursorPersistent memory alongside Cursor context
](/neotoma-with-cursor)
- [
OpenClawUser-owned memory for OpenClaw agents
](/neotoma-with-openclaw)
## Reference
- [
InstallInstall and initialize Neotoma locally
](/install)
- [
REST APIOpenAPI endpoints and parameters
](/api)
- [
MCP serverModel Context Protocol actions
](/mcp)
- [
CLICommands, flags, and REPL
](/cli)
- [
Memory guaranteesAll memory properties on one page
](/memory-guarantees)
- [
Memory modelsPlatform, retrieval, file-based, and deterministic memory compared
](/memory-models)
- [
FoundationsPrivacy-first architecture and cross-platform design
](/foundations)
- [
Agent instructionsMandatory behavioral rules for agents using Neotoma
](/agent-instructions)
- [
ArchitectureState flow, guarantees, and principles
](/architecture)
- [
TerminologyGlossary of key concepts
](/terminology)
- [
Schema managementDefine, inspect, and evolve schema constraints safely
](/schema-management)
- [
TroubleshootingCommon failure modes and practical fixes
](/troubleshooting)
- [
ChangelogRelease history and documentation updates
](/changelog)
- [
All pages (Markdown)Every indexable route as Markdown (SEO summaries)
](/site-markdown)
## Where the tax shows up
- [
Context janitorYou re-explain context every session. State that persists across tools.
](/operating)
- [
Inference varianceCorrections don’t stick. Deterministic state for agent pipelines.
](/building-pipelines)
- [
Log archaeologySame inputs, different state. Replayable timelines and diffs.
](/debugging-infrastructure)
## Compare
- [
Build vs buyWhen to adopt a state-integrity layer instead of building around observability alone
](/build-vs-buy)
- [
Neotoma vs platform memoryConvenience inside one AI product versus portable, auditable state across tools
](/neotoma-vs-platform-memory)
- [
Neotoma vs Mem0Retrieval memory for prompt augmentation versus deterministic entity state
](/neotoma-vs-mem0)
- [
Neotoma vs ZepKnowledge-graph retrieval versus versioned, schema-bound state
](/neotoma-vs-zep)
- [
Neotoma vs RAGRelevant chunk retrieval versus exact state reconstruction
](/neotoma-vs-rag)
- [
Neotoma vs file-based memoryMarkdown and JSON portability versus structured guarantees and provenance
](/neotoma-vs-files)
- [
Neotoma vs database memoryCRUD rows versus append-only observations and deterministic reducers
](/neotoma-vs-database)
## External
- [
GitHub repositorySource code, README, and issues
](https://github.com/markmhendrickson/neotoma)
- [
npm packageInstall via npm
](https://www.npmjs.com/package/neotoma)