Skip to content
toon-memory logotoon-memory

CLI Commands

Commands

Section titled “Commands”
Terminal window
npx toon-memory              # Interactive installer
npx toon-memory init         # Quick setup (no prompts)
npx toon-memory mcp          # Run MCP server directly
npx toon-memory status       # Check installation status
npx toon-memory stats        # View memory statistics
npx toon-memory export       # Export memory to JSON
npx toon-memory import <file> # Import memory from JSON
npx toon-memory watch [opts] # Auto-backup with options
npx toon-memory upgrade      # Update to latest version
npx toon-memory uninstall    # Remove from all agents

Watch Options

Section titled “Watch Options”
Option Description Default
[interval] Backup interval in minutes 5
-c, --compress Enable gzip compression off
-l, --log [path] Enable file logging off
-m, --max-backups <n> Max backups to keep (0=unlimited) 10

Examples

Section titled “Examples”

Stats

Section titled “Stats”
Terminal window
$ npx toon-memory stats


🧠 toon-memory stats


📊 Memory Stats
━━━━━━━━━━━━━━━━━━
Total entries: 45
├── decision: 12
├── pattern: 18
├── bug: 8
└── knowledge: 7
Last updated: 2026-07-10
File size: 12.4 KB

Export

Section titled “Export”
Terminal window
$ npx toon-memory export


🧠 toon-memory export


Exported 45 entries to:
  /path/to/project/toon-memory-export.json

Import

Section titled “Import”
Terminal window
$ npx toon-memory import backup.json


🧠 toon-memory import


Imported 3 new entries
Skipped 2 duplicates

Watch

Section titled “Watch”
Terminal window
$ npx toon-memory watch 15 -c -m 20


🧠 toon-memory watch


Watching memory file every 15 minutes...
Max backups: 20
Compression: enabled
Logging: disabled
Press Ctrl+C to stop


📦 Backup #1 created: 2026-07-11T16-00-00-000Z
📦 Backup #2 created: 2026-07-11T16-15-00-00-000Z
^C
✅ Watch stopped. 2 backups created.