🧠 Claude Memory System (claude-mem)

Remember that one thing? Neither do we… but claude-mem does! 😵‍💫

Stop repeating yourself. claude-mem remembers what you and Claude Code figure out, so every new chat starts smarter than the last.

⚡️ 10‑Second Setup

npm install -g claude-mem && claude-mem install

That’s it. Restart Claude Code and you’re good. No config. No tedious setup or dependencies.

✨ What You Get

• Remembers key insights from your chats with Claude Code
• Starts new sessions with the right context
• Works quietly in the background
• One-command install and status check
• 🎭 Shakespeare's Memory Theatre: Transform operations into theatrical magnificence!

🎭 NEW: Shakespeare's Memory Theatre

"All the world's a stage, And all memory merely players"

Experience claude-mem operations as a dramatic performance! Choose from five theatrical acts:

claude-mem theatre                    # Full theatrical experience
claude-mem theatre --act I           # Tragedy of Defensive Validation
claude-mem theatre --act II          # Romeo and Chroma_Add  
claude-mem compress-theatrical file   # Compress with Shakespearean flair
claude-mem status-theatrical          # Check status dramatically

Interactive Features:

• 🎪 Choose dialogue responses
• 🍅 Throw tomatoes at bad code
• 👏 Standing ovation meter
• 📜 Soliloquy generator
• 🎺 Trumpet fanfares

📖 Full Shakespeare Theatre Documentation

🗑️ Smart Trash™ (Your Panic Button)

Delete something by accident? It’s not gone.

• Everything goes to ~/.claude-mem/trash/
• Restore with a single command: claude-mem restore
• Timestamped so you can see when things moved

🎯 Why It’s Useful

• No more re-explaining your project over and over
• Pick up exactly where you left off
• Find past solutions fast when you face a familiar bug
• Your knowledge compounds the more you use it

🧭 Minimal Commands You’ll Ever Need

claude-mem install          # Set up/repair integration
claude-mem status           # Check everything’s working
claude-mem load-context     # Peek at what it remembers
claude-mem logs             # If you’re curious
claude-mem uninstall        # Remove hooks

# Extras
claude-mem trash-view       # See what’s in Smart Trash™
claude-mem restore          # Restore deleted items
# 🎭 Shakespeare's Memory Theatre Commands
claude-mem theatre          # Experience memory operations dramatically
claude-mem compress-theatrical file.jsonl  # Theatrical compression
claude-mem status-theatrical              # Dramatic status check

📁 Where Stuff Lives (super simple)

~/.claude-mem/
├── index/      # memory index
├── archives/   # transcripts
├── hooks/      # integration bits
├── trash/      # Smart Trash™
└── logs/       # diagnostics

✅ Requirements

• Node.js 18+
• Claude Code

🆘 If Something’s Weird

claude-mem status           # quick health check
claude-mem install --force  # fixes most issues

📄 License

This software is free to use but is NOT open source. See LICENSE.

---

Ready to remember more and repeat less?

npm install -g claude-mem
claude-mem install

Your future self will thank you. 🧠✨