Memory for AI Coding Agents — Persistent Memory That Survives Sessions

Why AI Coding Agents Need Memory

AI coding agents like Claude, Cursor, and OpenCode are powerful — but they have a critical limitation: no memory between sessions.

Every time you start a new session, your agent:

• Forgets the architecture decisions from yesterday
• Doesn’t remember the bug fixes you discovered
• Can’t recall the patterns your team established
• Has to re-learn your project from scratch

This wastes tokens, burns time, and leads to frustrating repetition.

The Solution: Persistent Memory for AI Agents

toon-memory gives your AI coding agent a persistent memory that:

1. Survives restarts — memory persists across sessions
2. Works offline — no cloud, no API calls, no LLM needed
3. Saves tokens — 22% fewer tokens than JSON
4. Scales — 80% fewer tool calls per session
5. Works everywhere — 15+ agents supported

What Can AI Agents Remember?

Decisions

memory_remember({
  category: "decision",
  key: "use-zod",
  content: "Use Zod for validation — simpler than Joi, better TS support"
})

Bug Fixes

memory_remember({
  category: "bug",
  key: "redis-pool-fix",
  content: "Redis pool exhaustion — fix was max_connections=20"
})

Patterns

memory_remember({
  category: "pattern",
  key: "api-versioning",
  content: "Always use /api/v1/ prefix for REST endpoints"
})

Knowledge

memory_remember({
  category: "knowledge",
  key: "deploy-process",
  content: "Deploy script lives in scripts/deploy.sh, runs on CI merge to main"
})

How Memory Improves AI Agent Performance

Metric	Without Memory	With toon-memory	Improvement
Tokens per session	2,411	972	-60%
Tool calls per session	25	5	-80%
Cost per session (GPT-4)	$0.072	$0.029	-60%
Context reconstruction	Manual	Automatic	100%

Memory Features

• 35 MCP tools — remember, recall, forget, stats, summary, archive, diff, suggest, smart_recall, encrypt, decrypt, and more
• Graph-aware recall — connects related entries with links and references
• Quality scoring — automatically rates entry quality (0-1)
• Merge-dedup — saves with the same key, merges automatically
• TTL — entries can expire after 7d, 30d, or custom dates
• Encryption — AES-256-GCM for sensitive data

Supported Agents

toon-memory works with 15+ AI coding agents:

• OpenCode — Plugin-based, SessionStart hooks
• Claude Code — Full hook support (SessionStart, PostToolUse, Stop)
• Cursor — MCP configuration
• Windsurf — MCP configuration
• VS Code / Copilot — MCP configuration
• Codex CLI — TOML config + hooks
• Gemini CLI — JSON config + hooks
• Zed — JSONC config
• And more — Cline, Continue, Antigravity, Aider, KiloCode, OpenClaw, Kiro

Get Started

npm install -g toon-memory
npx toon-memory  # Interactive installer

Your agent will have persistent memory in the next session.