Every new Cursor session starts blank. I got tired of re-explaining my project
architecture, decisions, and what we built last session. So I built a fix.
Run mindlink init in your project. It creates a .brain/ folder:
- MEMORY.md — permanent facts: architecture decisions, conventions, what was built and why
- SESSION.md — current session state, updated as Cursor works
- LOG.md — full history of every session ever run
The .cursorrules file it generates tells Cursor to read .brain/ at startup and
write to it as it works. No MCP server, no API key, no cloud. Just markdown files
your project already tracks.
Two things that surprised me building this:
-
Committing .brain/ to git means new teammates’ Cursor is fully briefed on
git pull. No onboarding session, no “let me catch you up.” -
It works across 12 agents from the same memory. Cursor in the morning,
Claude Code in the afternoon — both read the same .brain/. Switch tools without
losing context.
Install: npm install -g mindlink
Then: mindlink init in your project directory
MIT license, open source. Happy to answer questions.