Get /m:osBook a Demo

Install MindrianOS

Install MindrianOS in Claude Code, check your prerequisites and open your first DataRoom. Includes verification, recovery and alternative setup guidance.

Where do you use Claude?

Get MindrianOS

Inside your coding agent

Read https://raw.githubusercontent.com/jsagir/mindrian-marketplace/master/plugins/get-mindrian/skills/get-mindrian/SKILL.md and set up MindrianOS for me.

Paste it into Claude, ChatGPT or any AI assistant. It installs MindrianOS for you, or walks you through it step by step.

See exactly what your agent will do

The guide tells your agent to show you what the install changes and to ask before it installs anything.

On a phone, select the sentence and send it to the computer where you use Claude.

Or run the installer yourself in a terminal:

Terminal

npx @mindrian_os/cli

Being tested We are testing this path on the live marketplace now. The steps can still change.

  1. Open Claude Desktop and go to Customize, then Plugins.
  2. Choose Add marketplace and enter jsagir/mindrian-marketplace.
  3. Install MindrianOS, the mos-desktop entry.
  4. In Cowork or the Code tab, type /mos:onboard.

Hooks and the status line exist only in Claude Code.

MindrianOS does not run inside ChatGPT or another chat app, and nothing installs there.

Use Claude Code or a coding agent

Or use Claude Desktop, which is being tested.

Claude Code needs a Pro, Max, Ultra, Team or Enterprise plan, or a Console account. The free plan does not include it.

Open the Claude Code setup guide

When Claude Code runs, come back and use the first choice.

How you know it worked

  1. Quit Claude Code and open a new session. Plugins load at start.
  2. At the bottom of the terminal, look for the line that starts with ⬡ MindrianOS. If it is missing, run /mos:doctor --fix.
  3. Type /mos:onboard to start your first session.

Still stuck? Paste the error into your agent. Remove any keys or passwords from it first.

Read the Troubleshooting table at the end of the install guide

Supported setup
Node.js 22.18 or newer. Claude Code, installed with the official installer (setup guide). Claude Code needs a paid plan or a Console account, and the free plan does not include it.

Where does each step run?

Where does each step run?Four steps in order. In the terminal: install the host, then install the local package. Inside Claude Code: restart, then guided setup starts.TerminalInstall the hostInstall the local packageInside Claude CodeRestart Claude CodeGuided setup startsExpected result
Two steps run in the terminal. The next steps run inside Claude Code.

EvidencedSource: The steps on this page

Text version of the diagram

  1. Terminal
  2. Install the host
  3. Install the local package
  4. Inside Claude Code
  5. Restart Claude Code
  6. Guided setup starts
  7. Expected result

Install and start

The package states the lowest Node.js version that it supports.

Claude Code needs a paid plan or a Console account, and the free plan does not include it.

Goal: Install the host

Where to act: In the terminal for your operating system

Purpose: Make the host and its version command available.

Exact action

On macOS, Linux and WSL, install Claude Code from a terminal with one command.

Terminal

curl -fsSL https://claude.ai/install.sh | bash

On Windows PowerShell, install Claude Code with one command.

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

Claude Code asks you to log in on first use.

To check the installation, run the version command; a working installation prints a version number.

Terminal

claude --version

Expected observation: A working installation prints a version number.

Verify: Read the printed version output.

If absent: Return to the host setup guide and inspect the command path. Troubleshooting

Next step: Go to the next step

Goal: Install the local package

Where to act: In your terminal

Purpose: Install and update the local package from its marketplace.

Exact action

The installer runs from the terminal with one command.

Terminal

npx @mindrian_os/cli

Claude Code asks you to approve each shell command as it runs.

The installer registers the marketplace, refreshes its catalog, then installs and updates the plugin.

Restart Claude Code after the install.

Expected observation: The installer registers the marketplace, refreshes its catalog, then installs and updates the plugin.

Verify: Restart Claude Code after the install.

If absent: Keep the exact error text and follow the matching recovery. Troubleshooting

Next step: Go to the next step

Goal: Begin a room

Where to act: Inside Claude Code, in your project folder

Purpose: Bring your starting point to its approval gates.

Exact action

The ignite command starts a room through one front door, with gates for the starting point, the blueprint and the first win.

Inside Claude Code

/mos:ignite

Material choices stop at a gate: approve, reject with a reason, or defer.

Follow the first-session guide

Expected observation: Guided setup reaches the starting-point, blueprint and first-win gates.

Verify: Review the blueprint before choosing to approve, reject with a reason, or defer.

If absent: Keep the gap explicit and follow the connection checks. Troubleshooting

Next step: Continue

Website account (optional)

The installer needs no key to paste and no account to create first.

Desktop and Cowork

Plugins can be added and used in chat on the web, in the Chat tab of Claude Desktop and in Claude Cowork.

Hooks and sub-agents of a plugin run in Cowork and Claude Code, not in chat.

Compare the supported hosts

Update an existing installation

The installer registers the marketplace, refreshes its catalog, then installs and updates the plugin.

Terminal

npx @mindrian_os/cli

Recover before continuing

Keep the command names exact

The plugin is published in one marketplace.

Terminal

claude plugin marketplace add jsagir/mindrian-marketplace

The plugin installs from that marketplace under one identifier.

Terminal

claude plugin install mos@mindrian-marketplace
Rest

Next step

Check Node.js, Claude Code and the first command.

Previous: Using m:os