Skip to main content
m:os

Install MindrianOS

Set up the plugin in Claude Code, then bring a hard problem or hypothesis into your first DataRoom. Follow each command in the place named above it.

Install and start

You need Node.js 22.18 or newer, Git and access to Claude Code. The account used by Claude is separate from an account on this website. The final website-account step below is optional for this installation flow.

  1. Step 01

    Node.js

    Next unchecked step

    Install Node.js 22.18 or newer (check the version before continuing) from nodejs.org. The m:os installer runs through npx.

    Windows: uncheck “Automatically install the necessary tools” in the Node installer. Why

    Check: node -v prints a version number.

    If this step fails
  2. Step 02

    Claude Code

    Install it, then run claude and sign in.

    Needs a Claude Pro, Max, Team or Enterprise subscription, or a Claude Console account. The free claude.ai plan does not include Claude Code.

    Terminal · macOS, Linux, WSL
    curl -fsSL https://claude.ai/install.sh | bash
    PowerShell · Windows
    irm https://claude.ai/install.ps1 | iex

    Check: claude --version prints a version number.

    If this step fails
  3. Step 03

    m:os

    Run the installer in the terminal. Claude asks you to approve each step; we tell you what each approval is for. Restart Claude Code afterwards.

    Terminal
    npx @mindrian_os/cli
    1. Adding the marketplace: Claude asks to add jsagir/mindrian-marketplace, where the m:os plugin is published, to its plugin sources.
    2. Installing the plugin: Claude asks to install mos from that marketplace. This installs the local MindrianOS plugin and its methods.
    3. Bringing the plugin current: Claude asks to update mos, so you start on the newest release. Your first DataRoom comes at step 4, when you approve its blueprint.

    If it fails, or you are already inside Claude Code and want the two plugin commands, see Troubleshooting.

    If this step fails
  4. Step 04

    Your first DataRoom

    Go to your project folder with cd, run claude, then type /mos:ignite. The setup asks what you are working on. Review the proposed DataRoom blueprint before approving it.

    Terminal
    claude
    Claude Code
    /mos:ignite

    Your first DataRoom, step by step

    If this step fails
  5. Step 05

    Website account (optional)

    Optional: create a website account. This is separate from your Claude account and does not verify the plugin installation.

    Create an account

Check before starting your room

After installing the plugin and restarting Claude Code, complete installation verification. A copied command or checked box does not prove the installation succeeded.

Desktop and Cowork

The existing alternative setup prompt is below. Host support and execution permissions vary; review what Claude can actually perform before approving it. If it cannot install the plugin, use the Claude Code path above.

Setup request to paste into Claude
Help me install MindrianOS (m:os). First check whether this host supports the required plugin commands.
1. Add the plugin marketplace and install the plugin: /plugin marketplace add jsagir/mindrian-marketplace then /plugin install mos@mindrian-marketplace.
2. Open my first room with /mos:ignite and ask me what I am working on.
3. Before each approval you ask for, tell me in one line what it is for.

These are the plugin commands used by the setup request. They require a host that supports Claude plugin commands:

Claude plugin commands
/plugin marketplace add jsagir/mindrian-marketplace
/plugin install mos@mindrian-marketplace

A Theo connector alone does not install the full local plugin. See where to use m:os for the distinction.

Update an existing installation

Run the installer again in your terminal and follow its prompts:

Terminal
npx @mindrian_os/cli

Restart Claude Code after updating, then repeat the verification checks. If an update fails, use the troubleshooting guide before continuing.

Keep the command names exact

The npm package is @mindrian_os/cli. The Claude plugin identifier is mos@mindrian-marketplace. Product naming does not change these identifiers.
PreviousUsing m:osNextVerify your installation