Start here
Use it on your platform
MindrianOS runs on three: the terminal (Claude Code), Claude Desktop for chat, and Cowork for teams. They share the same brain but they are not the same experience. Pick the one that matches how you work, then follow its install and its way of working.
When you want to run MindrianOS where you actually work, you want to the install and the usage that fit your platform, so you can you are not forcing a terminal workflow into a chat app, or the reverse.
In plain terms
Claude Code (the terminal)
The full-power platform. Every feature works: hooks fire, scripts run, the Data Room updates as you talk. This is where MindrianOS was built to live.
Install
npx @mindrian_os/cliSee the full install guide for per-OS steps. Verify with /mos:help.
How you use it
Run claude in a project folder and talk. Type /mos: commands when you want a specific method, or just describe what is stuck and let Larry route. The room folder fills in as you go. Open the same folder in Cursor or VS Code to watch the files appear in real time.
Best for
Claude Desktop (chat)
The conversational platform. Larry's personality reads cleaner here. Best when you are exploring an idea before you commit to a project structure.
Install
Desktop speaks the MCP protocol. Connect the Brain by editing claude_desktop_config.json and adding the server, then restart Claude Desktop:
{
"mcpServers": {
"mindrian-brain": {
"url": "https://mindrian-brain.onrender.com/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}How you use it
Talk to Larry in plain language. The methods come through as you describe what you are doing. Fewer keystrokes, more conversation. The Data Room still records what matters.
Best for
Cowork (co-work, for teams)
The shared platform. Same plugin, one room, many people. Your team writes into a single Data Room and Larry sees what everyone added.
Install
The plugin loads the same way. The difference is the shared context folder (00_Context/) that holds the team's common state. Everyone on the workspace reads and writes the same room.
How you use it
Work as you would alone, but the room is collective. Decisions, meetings, and artifacts from every teammate land in one place. Larry surfaces contradictions and convergence across the whole team, not just your own thread.
Best for