DEV Community

Sean K
Sean K

Posted on

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

#claude #opensource #productivity #ai

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

Memory tools for Claude Code: /memento extracts session learnings, /brag generates social content ideas 

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

Memory tools for Claude Code
Because Claude forgets, but your notes don't.

License GitHub stars Claude Code

Install

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

Commands

/memento — Extract session memories

Run at the end of any Claude Code session to capture learnings into your CLAUDE.md files.

/memento [--project PATH] [--user PATH]
Argument Description
--project PATH Custom project memory location (default: ./CLAUDE.md)
--user PATH Custom user memory location (default: ~/.claude/CLAUDE.md)

What it does:

  • Analyzes your conversation for mistakes, corrections, and preferences
  • Filters for actionable insights only
  • Sorts into Project Memory (./CLAUDE.md) vs User Memory (~/.claude/CLAUDE.md)
  • Lets you pick which suggestions…
View on GitHub

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

Top comments (0)