DEV Community

Sean K
Sean K

Posted on

Memento: Give Claude Code Persistent Memory So You Stop Repeating Yourself

If you use Claude Code, you've probably had this experience:

You: Install the dependencies
Claude: npm install
You: No, use pnpm in this project
Claude: pnpm install
Enter fullscreen mode Exit fullscreen mode

Next session? Same thing. Claude has no memory between conversations.

The Problem

Claude Code reads CLAUDE.md files at the start of each session - that's how it learns your project conventions. But manually maintaining these files is tedious, and you often forget to document the corrections you make during coding sessions.

The Solution: Memento

I built Memento - a Claude Code command that analyzes your conversations and extracts actionable insights automatically.

Named after the Christopher Nolan film where the protagonist leaves notes for his future self (because he can't form new memories), Memento helps you leave notes for future Claude sessions.

How It Works

At the end of any coding session, run:

/memento
Enter fullscreen mode Exit fullscreen mode

Memento will:

  1. Analyze your conversation for corrections, preferences, and learnings
  2. Filter for actionable insights (not vague observations)
  3. Categorize into project-specific vs. personal preferences
  4. Present suggestions for you to approve

You select which ones to keep, and they're appended to the appropriate CLAUDE.md file.

What Makes a Good Suggestion?

Memento focuses on actionable insights:

✅ Actionable ❌ Not Actionable
"Use pnpm, not npm" "Check package manager"
"Tests are in __tests__/" "This was a good session"
"Always show command before running" "Be more careful"

Installation

One-liner:

mkdir -p ~/.claude/commands && curl -fsSL https://raw.githubusercontent.com/SeanZoR/claude-memento/main/.claude/commands/memento.md -o ~/.claude/commands/memento.md
Enter fullscreen mode Exit fullscreen mode

That's it! The command is now available in all your Claude Code sessions.

Try It Out

Give it a spin and let me know what you think! Issues and PRs welcome.

GitHub logo SeanZoR / claude-memento

Extract session memories into CLAUDE.md - because Claude forgets, but your notes don't

███╗   ███╗███████╗███╗   ███╗███████╗███╗   ██╗████████╗ ██████╗
████╗ ████║██╔════╝████╗ ████║██╔════╝████╗  ██║╚══██╔══╝██╔═══██╗
██╔████╔██║█████╗  ██╔████╔██║█████╗  ██╔██╗ ██║   ██║   ██║   ██║
██║╚██╔╝██║██╔══╝  ██║╚██╔╝██║██╔══╝  ██║╚██╗██║   ██║   ██║   ██║
██║ ╚═╝ ██║███████╗██║ ╚═╝ ██║███████╗██║ ╚████║   ██║   ╚██████╔╝
╚═╝     ╚═╝╚══════╝╚═╝     ╚═╝╚══════╝╚═╝  ╚═══╝   ╚═╝    ╚═════╝

Extract session memories into CLAUDE.md
Because Claude forgets, but your notes don't.

License GitHub stars Claude Code

Quick StartHow It WorksExamplesRoadmapContributing


The Problem

Claude has no memory between sessions. Every time you start a new conversation, it's a blank slate. You've probably noticed yourself repeating the same instructions:

  • "Use pnpm, not npm"
  • "Tests go in __tests__/ folders"
  • "I prefer TypeScript over JavaScript"

Sound familiar?

The Solution

Memento is a Claude Code command that analyzes your coding sessions and extracts actionable insights into your CLAUDE.md files. Future Claude sessions automatically read these files, giving Claude "memory" of your preferences and project conventions.

Like Leonard in the film Memento, Claude has no






Have you built any tools to improve your Claude Code workflow? I'd love to hear about them in the comments!

Top comments (0)