Install the Melso CLI

Five steps to install the Melso CLI and connect your computer as a local runtime.

You need: a Melso account, and Node.js with npm for step 3.

1. Install

On macOS and Linux:

curl -fsSL https://downloads.melso.ai/install.sh | bash

On Windows, in PowerShell:

irm https://downloads.melso.ai/install.ps1 | iex

Open a new terminal and check that it works:

melso version

2. Sign in

melso login

A browser window opens. The Melso account you sign in with becomes the owner of this computer.

3. Install the agents

melso worker local setup

This installs Codex, Claude, and Pi under your Melso profile. It does not change any copy you already have.

4. Start the worker

melso worker local start

Leave this terminal open. Closing it takes the computer offline.

5. Check it in Melso

Open Settings → Computers. Your computer appears under its hostname, labelled Yours. It can take up to 30 seconds to show as Online.

To use it, open the Run on menu in the Task composer and pick your computer.

Good to know

• AI accounts: Tasks use the accounts connected in Settings → AI providers. You do not need to sign in to Claude or Codex on the computer. See Provider accounts.
• Updates: the worker updates itself when no Run is active. To update by hand, run melso update. Updating does not upgrade Codex, Claude, or Pi; run melso worker local setup again for that.
• Older install: if you installed the CLI before automatic updates, run melso update once.

For sharing a computer with teammates and troubleshooting, see Local runtimes.