Brain OS
Local-first MCP server that stores project decisions, blockers, plans and priorities across sessions.
Tested on Linux
Use it
Linux x86_64
You need first
- Runtimes:
Node.js 20 or newer - Keys or accounts: OPENAI_API_KEY
Install brain-os globally via npm
npm install -g brain-os
Add it to your agent
claude mcp add brain-os -- brain-os serveJSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"brain-os": {
"command": "brain-os",
"args": [
"serve"
]
}
}
}Run brain-os init <folder> in your project folder, then add brain-os serve as an MCP server in your MCP client.
What it does
- Track projects with status and blockersTested
How to use it
- Run
brain-os init <folder>in your project folder. - Connect your MCP client to
brain-os serve. - Call the entity_update tool with a project ID and its status, blockers and next moves.
- Run
- Check a proposed action against active decisionsTested
How to use it
- Run
brain-os init <folder>in your project folder. - Connect your MCP client to
brain-os serve. - Call the decision_check tool with your proposed action and the project ID.
- Run
- Get prioritized recommendations on what to work onTested
How to use it
- Run
brain-os init <folder>in your project folder. - Connect your MCP client to
brain-os serve. - Call the focus_get tool with no arguments.
- Run
- Log decisions with the alternatives you rejectedNot tested
How far pickfit got
Linux x86_64
- Installs
- Connects
- 3 of 4 features work
- Works offline
Good for
- check a proposed action against logged decisions
- log strategic decisions with reasoning and rejected alternatives
- get prioritized recommendations on what to work on
- search project memory by meaning
- save session state changes at end of session
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
An MCP client called one of its tools
- Replayed from scratch
- Works offline
- Checked on 31 Oct 2026
- Version 0.11.0
An MCP client handshake over stdio listed 24 tools, and a call to entity_update returned a result.
Differences the test machine hit
- README: npm install brain-os openai for semantic search
In the test: global install npm install -g brain-os required for probe; npx launcher would fetch on each run and fail offline