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:
monoclaw --helpmonoclaw modules --helpProfiles
Section titled “Profiles”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:
monoclaw --profile guestlab statusWithout --profile, a command acts on the first enrolment. A profile name is 1 to 30 characters: lowercase letters, numbers and hyphens.
Global options
Section titled “Global options”| 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. |
Environment variables
Section titled “Environment variables”| 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. |
monoclaw connect
Section titled “monoclaw connect”Set this computer up in one go with the token from Add a machine in the app: install, connect, start in the background, check.
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) |
monoclaw enrol
Section titled “monoclaw enrol”Connect this machine to your MonoClaw account with a token from Add a machine in the app.
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 |
monoclaw modules
Section titled “monoclaw modules”What this machine can do: agent engines, voices, transcription, images (keys stay on this machine).
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>monoclaw modules list
Section titled “monoclaw modules list”The modules on this machine and their connections; –all shows what you can add.
monoclaw modules list [options]| Option | What it does |
|---|---|
--all |
Also list every module you can add |
monoclaw modules add
Section titled “monoclaw modules add”Add modules (local ones download their models, with progress).
monoclaw modules add <ids...>monoclaw modules remove
Section titled “monoclaw modules remove”Remove a module with its connections and their keys.
monoclaw modules remove <id>monoclaw modules connect
Section titled “monoclaw modules connect”Add an API key connection to a module (prompts for the key, typed blind, or reads it from stdin).
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) |
monoclaw modules key
Section titled “monoclaw modules key”Enter or replace a connection’s key (typed blind, or piped on stdin).
monoclaw modules key <connectionId>monoclaw modules cap
Section titled “monoclaw modules cap”Set a monthly cap on a connection: –usd N (claude-api, fal), –characters N (elevenlabs), or –off.
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 |
monoclaw roots
Section titled “monoclaw roots”Folders this machine exposes to your chats.
monoclaw roots listmonoclaw roots add <path...>monoclaw roots remove <path>monoclaw roots list
Section titled “monoclaw roots list”monoclaw roots listmonoclaw roots add
Section titled “monoclaw roots add”monoclaw roots add <path...>monoclaw roots remove
Section titled “monoclaw roots remove”monoclaw roots remove <path>monoclaw status
Section titled “monoclaw status”Show enrolment, exposed folders and provider readiness.
monoclaw statusmonoclaw start
Section titled “monoclaw start”Run the host and stay connected to the router (checks for updates first; MONOCLAW_NO_UPDATE=1 skips optional ones).
monoclaw startmonoclaw claude
Section titled “monoclaw claude”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.
monoclaw claude [arguments...]Everything after claude is handed on as it is, options included.
monoclaw doctor
Section titled “monoclaw doctor”Check and repair what a working host needs: Node, the host’s copy of Claude Code, your Claude login, folders, the service.
monoclaw doctor [options]| Option | What it does |
|---|---|
--no-repair |
Only report; do not install anything |
monoclaw update
Section titled “monoclaw update”Update the host app now (to the router’s latest, or –to <version>).
monoclaw update [options]| Option | What it does |
|---|---|
--to <version> |
Exact version to install |
monoclaw config
Section titled “monoclaw config”Local policy the router cannot override.
monoclaw config showmonoclaw config set <key> <value>monoclaw config show
Section titled “monoclaw config show”monoclaw config showmonoclaw config set
Section titled “monoclaw config set”Keys: allowedPermissionModes (comma list; default auto,acceptEdits,default,plan), allowRemoteInputEdits (on|off), maxSessions (1-64), allowInsecure (on|off).
monoclaw config set <key> <value>monoclaw service
Section titled “monoclaw service”Run the host in the background at login.
monoclaw service install [options]monoclaw service uninstallmonoclaw service install
Section titled “monoclaw service install”Install and start the background service (re-run to restart it on the current version).
monoclaw service install [options]| Option | What it does |
|---|---|
--print |
Only write the service file and print the commands, without running them |
monoclaw service uninstall
Section titled “monoclaw service uninstall”Stop and remove the background service.
monoclaw service uninstall