toon-memory
Persistent memory for AI coding agents
Remember decisions, patterns, and bugs between sessions
11 MCP Tools + 3 Resources
Full memory management via MCP — remember, recall, forget, stats, summary, archive, diff, suggest, encrypt, decrypt. Plus resources for direct context reading.
Multi-Agent
Works with all major AI coding agents. OpenCode, VS Code, Claude, Cursor, Windsurf, Cline, Continue — zero configuration.
TOON Format
40% fewer tokens than JSON. Custom encoding designed for LLM comprehension and token efficiency.
Smart Memory
Auto-tag inference, related entry suggestions, memory diff, and configurable TTL for temporary context.
Encryption
AES-256-GCM for sensitive data. Auto-archive old entries. Watch mode for automatic backup every N minutes.
Memory Tips
Get the most out of toon-memory with these patterns
Save decisions immediately
When you make a choice, save it right away. Add context on why you chose option A over B — future you will thank yourself.
Use consistent keys
Prefix keys by domain: db:redis-config, auth:jwt. Makes recall faster and avoids collisions.
Tags auto-infer
Leave tags empty and the system infers them from content — redis, auth, api, db, and 16+ more categories. Or add them manually for precise control.
Use TTL for temp context
Deadlines, sprints, time-sensitive notes — set a ttl: "7d" and they auto-expire. No manual cleanup needed.
Before vs After
See how toon-memory changes your workflow
Before
- Repeat explanations every session
- Forget why a decision was made
- Hunt through git history for context
- Copy-paste notes between chats
After
- Agent remembers everything
- Decisions are one query away
- Patterns persist across projects
- Zero context loss between sessions
Quick Example
// Save a decision (with auto-tag inference)
memory_remember({
category: "decision",
key: "use-zod",
content: "Use Zod for validation",
file: "src/types.ts"
})
// 🏷️ Tags inferidos: types
// Save with TTL (expires in 7 days)
memory_remember({
category: "knowledge",
key: "sprint-deadline",
content: "Sprint ends July 18",
ttl: "7d"
})
// See what changed since last session
memory_diff({ since: "24h" })
// Search memory
memory_recall({ query: "redis" })
// [bug] redis-pool-fix (i9j0k1l2)
// Added max_connections=20Quick Install
# npm
npm install -g toon-memory
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/LuiggiVal08/toon-memory/main/install.sh | sh
# Windows (PowerShell)
irm https://raw.githubusercontent.com/LuiggiVal08/toon-memory/main/install.ps1 | iex