Give Claude a Mind

Memory for Claude Code that persists across sessions. Decisions, learnings, and reminders. Install with 2 commands. Free forever.

mind_recall()
_
Get Started

Why Mind?

Without memory, Claude starts every session blank. These problems go away.

Rabbit Holes

Claude goes down the wrong path for an hour before you notice. Mind tracks what's been tried so it doesn't loop.

Doesn't Remember You

Your preferences, your stack, your way of doing things - gone every session. Mind remembers who it's working with.

Session Memory Lost

Terminal closes. All that context? Vanished. Mind persists what matters between sessions.

Forgets What's Built

Claude references features that don't exist, or rebuilds things you have. Mind tracks what's done vs not.

Spaghetti Code

No memory means disconnected updates. Claude patches on patches. Mind keeps the full picture for coherent changes.

2 Commands to Fix All This

pip install, mind init. These problems stop. Fully automated after.

How It Works

MCP tools run locally, filtering what's worth remembering into the right place.

Claude Code
Working on your project
calls MCP tools
Mind MCP Server
mind_recall() mind_log() mind_search() mind_blocker() mind_remind() mind_edges()
12 commands Claude can call when needed
filters & routes
.mind/ folder
Long-term Memory
MEMORY.md
decisions learnings problems solved
Persists forever. Worth remembering.
Short-term Memory
SESSION.md
experiences assumptions current blockers
Clears on session end. Working memory.
injects context
CLAUDE.md
Fresh context loaded every session

The Filtering Logic

When Claude logs something, Mind decides where it goes based on whether it's useful long-term:

"We decided to use Zustand for state"
→
MEMORY.md future sessions need this
"Trying the flexbox approach now"
→
SESSION.md only matters right now
"Safari doesn't support :has() in older versions"
→
MEMORY.md gotcha worth keeping

Smart Reminders

Time-based or context-triggered. Never forget what matters.

Time-Based
"tomorrow" Next day
"in 3 days" Relative date
"next session" On next recall
"2025-12-25" Specific date
Context-Based
"when I mention auth" Keyword trigger
"when we work on API" Topic trigger
Surfaces automatically when relevant keywords appear in conversation.

12 MCP Tools

Click a command to see what it does

Core
Reading
Actions
mind_recall()
## Memory: Active
Last captured: 2 hours ago

## Reminders Due
- Review auth flow when we work on login

## Recent Decisions
- file-based storage (simpler, git-trackable)

## Continue From
Last: two-layer memory system

Loads everything Claude needs to remember about your project - past decisions, learnings, what you were working on, and any reminders.

Auto Called automatically at the start of every session
Manual Call manually if context feels stale or after long breaks

Ready to Give Claude a Mind?

2 commands. Zero friction.

1. Install Mind
pip install vibeship-mind
2. Initialize in your project
cd your-project mind init
3. Connect to Claude Code
Add to your MCP config:
{
  "mcpServers": {
    "mind": {
      "command": "mind",
      "args": ["mcp"]
    }
  }
}
Then say: "Let's run The Mind"
View on PyPI GitHub