Troubleshooting

The snags people hit most, and the fix for each. If none of these match, start with the doctor: it checks the install and names what is wrong.

Start with the doctor

Inside Claude Code:

Command

/mos:doctor

It checks the install and reports each problem. Add --fix to repair what it can:

Command

/mos:doctor --fix

Windows: the Node installer checkbox

Uncheck "Automatically install the necessary tools".

The Node.js installer offers it as Tools for Native Modules. m:os ships no native modules and needs none of it. Leaving it checked starts a long, unrelated Visual Studio Build Tools install in a separate window. If that window already opened, you can close it; your Node install is done.

Windows: "claude is not recognized"

Windows does not know where Claude landed yet. The installer put it in C:\Users\YourName\.local\bin. Add that folder to PATH for this window:

PowerShell

$env:Path += ";C:\Users\YourName\.local\bin"

Command Prompt

set PATH=%PATH%;C:\Users\YourName\.local\bin

To make it permanent: press the Windows key, search Environment Variables, edit the user Path variable and add both C:\Users\YourName\.local\bin and C:\Users\YourName\AppData\Roaming\npm. Then reopen the terminal.

If your Command Prompt does not accept Ctrl+V, try right-clicking to paste.

"Marketplace not found"

Use the one-command installer, which adds the marketplace for you:

terminal

npx @mindrian_os/cli

Or add it yourself inside Claude Code:

Command

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

"git is not found" (Windows)

The marketplace needs Git. Install it, reopen the terminal, and try again:

Command

winget install --id Git.Git -e --source winget

Do not use sudo with npm

Never put sudo in front of npm or npx.

Installing with sudo causes permission problems that are hard to undo.

Theo is unreachable

The connection diagnostic identifies the failed stage. Keep unavailable method guidance explicit while you check the connection; do not treat an unsourced answer as a sourced method.

Find the cause:

Command

/mos:doctor --brain-smoke

It checks the path to Theo step by step and names the step that fails, including an old connector added by hand that hides the plugin's own.

Then repair what it can:

Command

/mos:doctor --fix

If you set MINDRIAN_DISABLE_AUTO_REGISTER=1, your install cannot register with Theo. Remove it and restart Claude Code.

How Theo connects, and what it sees, is on the Theo page.

PreviousAll commands NextDocumentation home