Give Claude a Mind

Memory for Claude Code that persists across sessions. Decisions, learnings, and reminders. Install in 2 minutes with 2 prompts. Free for now.

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 Minutes to Fix All This

3 commands to install. 2 prompts to configure. 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?

4 commands + 1 prompt. Zero friction.

0. Install uv (if needed)

# macOS/Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Windows (PowerShell) powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Skip if you already have uv installed

1. Install Mind

git clone https://github.com/vibeforge1111/vibeship-mind.git cd vibeship-mind uv sync uv run mind init

2. Tell Claude Code to connect

Add Mind MCP server to my config

Then in any Claude project: "Let's run The Mind"

View on GitHub