Skip to main content
MindrianOS

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.

The job this does

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

Think of one engine in three cars. The engine is the same: Larry, the Data Room, the methods. The car is the platform. A terminal is a race car, full control. The desktop app is a sedan, smooth and conversational. Cowork is a bus, everyone rides together. Same engine, different ride.

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/cli

See 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

Power users, real venture work, anyone who wants every feature and lives in a terminal.

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:

claude_desktop_config.json
{
  "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

Thinking out loud, early exploration, anyone who prefers a chat window to a terminal.

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

Teams, cohorts, and workshops where several people build one venture together.