Skip to content

Quick start

This page takes you from nothing to a first reply from an agent that runs on your own computer. You can read all of it before you sign up.

  • A computer that stays on while your agents work: macOS, Linux or Windows, with a terminal you can paste a command into.
  • Node.js 22 or newer on that computer. Check with node -v. If you do not have it, see Install Node.js below.
  • A Claude subscription, or an Anthropic API key. If Claude Code is already signed in on that computer, that login is used. If not, you sign in at step 3. You do not need to install Claude Code yourself: MonoClaw brings its own copy.
  1. Open command.monoclaw.ai in a browser on the computer you want to connect.
  2. Enter your email address. There is no password.
  3. Enter the six-digit code from the email.

You should see the setup screen with five steps, the first one ticked.

  1. Under Connect your computer, copy the command.
  2. Paste it into a terminal on that computer and press Enter. It is the same on macOS, Linux and Windows.

Sign in to get your command. It ends with a one-time token that works for an hour, which is why it is only shown inside the app. This is its shape, so you know what you will be running:

Terminal window
npx -y @monoclaw/machine@latest connect <token>

npx comes with Node.js. It fetches the MonoClaw machine program from npm and runs its connect command, which does five things in order:

  1. It installs the program for good with npm install -g, without running any install scripts. From then on the command is monoclaw.
  2. It connects the computer to your account with the one-time token.
  3. It makes a folder called command in your home folder, if there is none, for your agents to work in.
  4. It starts the machine in the background, now and every time you log in.
  5. It runs monoclaw doctor and prints what is ready and what is not.

If you would rather watch the machine run, choose Run it in this terminal instead. That command stops before the background step, and you start the machine yourself. It stops when you close the terminal:

Terminal window
monoclaw start

You should see Waiting for your computer… in the app give way, by itself, to the next step, Add Claude, with your computer’s name on it. The terminal ends with Connected. Go back to MonoClaw in your browser: it has moved on by itself.

“MonoClaw needs Node.js 22 or newer. Install it, open a new terminal and run this again.” Your Node.js is older than 22. If the terminal says npx is not found, Node.js is not installed at all. Either way, install it as described under Install Node.js, open a new terminal and paste the same command again.

“npm isn’t allowed to install here (permission denied).” npm reported EACCES. Do not use sudo. Install Node.js with Homebrew on macOS or with nvm on Linux, which keep it in your own folders, then run the command again. See Troubleshooting.

“That enrolment token was not found or has expired. Make a new one from Add a machine.” The command is more than an hour old, or it has been used once already. Go back to the app and copy the command it shows now. See Troubleshooting.

The machine does not appear and the app keeps waiting. The terminal says why. Scroll up to the first error and look it up in Troubleshooting.

monoclaw doctor lists things to fix. The computer is connected all the same. The usual line is Not logged in to Claude, which the next step deals with. See how to read doctor.

On macOS, with Homebrew:

Terminal window
brew install node

Without Homebrew, download the LTS installer from nodejs.org and open it.

On Linux, install nvm, which needs no sudo:

Terminal window
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

Then open a new terminal and install Node.js:

Terminal window
nvm install 22

On Windows, in PowerShell:

Terminal window
winget install OpenJS.NodeJS.LTS

Or download the LTS installer from nodejs.org.

When node -v shows 22 or newer, open a new terminal and paste the MonoClaw command again.

A new machine can do nothing until it has a module. Agents need Claude.

  1. Choose Add Claude to followed by your machine’s name.

If Claude Code is signed in on that computer, you should see Claude become ready and the setup move on to the next step.

The page says what is missing and checks again by itself. On that computer, run:

Terminal window
monoclaw claude auth login

This signs in the copy of Claude Code that MonoClaw uses. Follow what it prints, then go back to the app.

On a server with no browser the same command works: it prints a link: open the link on any device, sign in, and paste the code it gives you back into the terminal.

To use an Anthropic API key instead of a subscription, open the machine’s page and add the Claude (API key) module. More under Troubleshooting.

  1. Choose Create your first agent. The New project page opens.
  2. Project name is optional. Leave it blank and the agent suggests one.
  3. Give the agent a Name, such as Lead Developer.
  4. Under Runs on, check the Machine and the Connection (your Claude login). With one machine these are filled in for you.
  5. Check the Folder the agent works in, its Permissions and its Access. The defaults are the folder from step 2, Auto and Full. Read Security before you give an agent Full access to a folder that matters.
  6. Choose Start.

You should see the project open as a chat with your agent’s name on it.

  1. Type a message in the box at the bottom, or choose one of the suggested first messages.
  2. Send it.

You should see the agent start working and its reply appear in the chat. If the agent wants to do something its permissions do not cover, you see a card with Allow and Deny.

On the computer you connected, run:

Terminal window
monoclaw doctor

Each line starts with ✓ (fine), • (a note, not a problem) or ✗ (something to fix, with the fix on the next line). You should see All good. at the end. That means Node.js is new enough, the program is installed properly, Claude Code is there and signed in, the computer is connected to your account, its folders exist, and every module on it is ready.

In the app, Machines should list your computer as Online.

To use your phone, open command.monoclaw.ai in its browser and sign in with the same email. The conversation is the same on every device.