Install MindrianOS
Install MindrianOS in Claude Code, check your prerequisites and open your first DataRoom. Includes verification, recovery and alternative setup guidance.
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/cliBeing tested We are testing this path on the live marketplace now. The steps can still change.
- Open Claude Desktop and go to Customize, then Plugins.
- Choose Add marketplace and enter
jsagir/mindrian-marketplace. - Install MindrianOS, the
mos-desktopentry. - 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.
Claude Code needs a Pro, Max, Ultra, Team or Enterprise plan, or a Console account. The free plan does not include it.
How you know it worked
- Quit Claude Code and open a new session. Plugins load at start.
- At the bottom of the terminal, look for the line that starts with
⬡ MindrianOS. If it is missing, run/mos:doctor --fix. - Type
/mos:onboardto 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?
EvidencedSource: The steps on this page
Text version of the diagram
- Terminal
- Install the host
- Install the local package
- Inside Claude Code
- Restart Claude Code
- Guided setup starts
- 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 | bashOn Windows PowerShell, install Claude Code with one command.
Windows PowerShell
irm https://claude.ai/install.ps1 | iexClaude 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 --versionExpected 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/cliClaude 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:igniteMaterial choices stop at a gate: approve, reject with a reason, or defer.
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.
Update an existing installation
The installer registers the marketplace, refreshes its catalog, then installs and updates the plugin.
Terminal
npx @mindrian_os/cliKeep the command names exact
The plugin is published in one marketplace.
Terminal
claude plugin marketplace add jsagir/mindrian-marketplaceThe plugin installs from that marketplace under one identifier.
Terminal
claude plugin install mos@mindrian-marketplaceNext step
Check Node.js, Claude Code and the first command.
Previous: Using m:os