Cursor memory for project state

Cursor can help inside a coding session. Brain OS gives it a durable operational memory layer for work that spans days: decisions, blockers, plans, tradeoffs, and what matters next.

Short answer

To give Cursor persistent memory, use an MCP memory server that stores structured project state. Brain OS stores that state locally in .brain/ so Cursor and other MCP clients can read the same decisions, plans, blockers, and next moves.

Why Cursor memory needs structure

Old chat context can remind Cursor what was discussed. It cannot reliably tell Cursor what became true about the project. That distinction matters when a codebase has unsettled migrations, paused refactors, product decisions, and recurring blockers.

Without operational memory, the agent keeps rediscovering the same context. It may reopen decisions you already made, miss blockers that explain stalled work, or suggest plans that conflict with the current direction.

What Brain OS stores for Cursor

Decisions Choices, reasons, rejected alternatives, and review dates.
Plans Ordered steps that can be advanced, completed, or skipped.
Blockers What is stopping progress and what must happen next.
Patterns Repeated loops, stale projects, and drift from intent.

Cursor can use Brain OS through MCP to inspect this state before acting. The useful memory is not a transcript archive. It is the current working model of the project.

Install

Then add Brain OS to Cursor through your MCP configuration:

{ "brain-os": { "command": "npx", "args": ["brain-os"] } }

Read how the MCP memory layer works

When this helps

Use Brain OS when Cursor is helping on a project with history.

It is most useful when you need the agent to remember why decisions were made, what is blocked, and what plan is active.

Skip it for one-off edits.

If the task has no future state and fits in one chat, normal context is enough.

Try it

Use Brain OS on one real Cursor project for a week. The Brain OS pilot is open for developers testing agent memory in real workflows.