Skip to content

Commands

The monoclaw command comes with the host, the npm package @monoclaw/machine. It runs on your machine: it connects the machine to your account, runs the host, and manages modules, folders and the background service.

Add --help to any command to see the same on your machine:

Terminal window
monoclaw --help
monoclaw modules --help

One computer can be connected to several spaces, for example your own and an organisation’s. Each connection is a profile with its own settings, keys, logs and background service. Modules you have downloaded are shared between them.

Put --profile <name> before the command to choose one:

Terminal window
monoclaw --profile guestlab status

Without --profile, a command acts on the first enrolment. A profile name is 1 to 30 characters: lowercase letters, numbers and hyphens.

Option What it does
-V, --version Output the version number
--profile <name> Which enrolment on this computer (one per space): monoclaw --profile guestlab start. Default: the first enrolment.
Variable What it does
MONOCLAW_PROFILE Which enrolment on this computer to use. The same as --profile <name>.
MONOCLAW_HOST_HOME The folder the host keeps its settings, keys and logs in, instead of ~/.monoclaw/host.
MONOCLAW_NO_UPDATE Set to 1 to skip optional updates when the host starts. An update the server requires still happens.
MONOCLAW_CLAUDE_PATH The path of a claude program to use instead of the copy of Claude Code the host brings.
CLAUDE_CODE_OAUTH_TOKEN A long-lived Claude sign-in token (from monoclaw claude setup-token), read from the environment the machine runs in. It is passed to Claude Code.
MONOCLAW_SECRET_STORE Set to file to keep keys in a file in the host’s folder instead of the system keychain.

Set this computer up in one go with the token from Add a machine in the app: install, connect, start in the background, check.

Terminal window
monoclaw connect [options] [token]
Option What it does
--router <url> The MonoClaw server
--no-service Don’t start it in the background; run monoclaw start yourself afterwards
--root <path...> Folders agents may work in (default on a new computer: ~/command)
--name <name> Name shown in the app (default: this computer’s name)
--from <package> Install this instead of the current version from npm
--insecure Allow an http:// server (development only)

Connect this machine to your MonoClaw account with a token from Add a machine in the app.

Terminal window
monoclaw enrol [options] [token]
Option What it does
--router <url> The MonoClaw server
--name <name> Name shown in the app (default: hostname)
--root <path...> Folders to expose (you can add more later with roots add)
--token-stdin Read the token from standard input instead of the command line (keeps it out of the process list)
--insecure Allow an http:// router (development only)
-y, --yes Don’t ask: when this computer is already enrolled for another space, enrol it again under a new profile

What this machine can do: agent engines, voices, transcription, images (keys stay on this machine).

Terminal window
monoclaw modules list [options]
monoclaw modules add <ids...>
monoclaw modules remove <id>
monoclaw modules connect [options] <module>
monoclaw modules key <connectionId>
monoclaw modules cap [options] <connectionId>

The modules on this machine and their connections; –all shows what you can add.

Terminal window
monoclaw modules list [options]
Option What it does
--all Also list every module you can add

Add modules (local ones download their models, with progress).

Terminal window
monoclaw modules add <ids...>

Remove a module with its connections and their keys.

Terminal window
monoclaw modules remove <id>

Add an API key connection to a module (prompts for the key, typed blind, or reads it from stdin).

Terminal window
monoclaw modules connect [options] <module>
Option What it does
--name <name> Name shown in the app, e.g. “Studio key”
--id <id> Use this id (the server’s pac_ id for a connection the app already knows)

Enter or replace a connection’s key (typed blind, or piped on stdin).

Terminal window
monoclaw modules key <connectionId>

Set a monthly cap on a connection: –usd N (claude-api, fal), –characters N (elevenlabs), or –off.

Terminal window
monoclaw modules cap [options] <connectionId>
Option What it does
--usd <n> Most US dollars a month
--characters <n> Most characters a month
--off No cap

Folders this machine exposes to your chats.

Terminal window
monoclaw roots list
monoclaw roots add <path...>
monoclaw roots remove <path>
Terminal window
monoclaw roots list
Terminal window
monoclaw roots add <path...>
Terminal window
monoclaw roots remove <path>

Show enrolment, exposed folders and provider readiness.

Terminal window
monoclaw status

Run the host and stay connected to the router (checks for updates first; MONOCLAW_NO_UPDATE=1 skips optional ones).

Terminal window
monoclaw start

Run the Claude Code this machine uses, with whatever follows: monoclaw claude auth login signs it in, monoclaw claude auth status shows who is signed in.

Terminal window
monoclaw claude [arguments...]

Everything after claude is handed on as it is, options included.

Check and repair what a working host needs: Node, the host’s copy of Claude Code, your Claude login, folders, the service.

Terminal window
monoclaw doctor [options]
Option What it does
--no-repair Only report; do not install anything

Update the host app now (to the router’s latest, or –to <version>).

Terminal window
monoclaw update [options]
Option What it does
--to <version> Exact version to install

Local policy the router cannot override.

Terminal window
monoclaw config show
monoclaw config set <key> <value>
Terminal window
monoclaw config show

Keys: allowedPermissionModes (comma list; default auto,acceptEdits,default,plan), allowRemoteInputEdits (on|off), maxSessions (1-64), allowInsecure (on|off).

Terminal window
monoclaw config set <key> <value>

Run the host in the background at login.

Terminal window
monoclaw service install [options]
monoclaw service uninstall

Install and start the background service (re-run to restart it on the current version).

Terminal window
monoclaw service install [options]
Option What it does
--print Only write the service file and print the commands, without running them

Stop and remove the background service.

Terminal window
monoclaw service uninstall