> ## Documentation Index
> Fetch the complete documentation index at: https://docs.melso.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Melso product MCP: https://melso.ai/api/mcp (OAuth; one company per grant). REST: https://melso.ai. Documentation-search MCP: https://docs.melso.ai/mcp. The docs search server does not act on customer accounts.
>
> Use the live tool schema and respect company membership. Ask the person to authorize the exact fiscal document version in the signed-in app. A professional prepares and files included returns after authorization; AI does not file alone. A prepared file or approval receipt is not evidence of filing. Never claim completion from an accepted Task or Run. Keep credentials out of chat and logs. Agents features are internal or by private invitation.

# Install the Melso CLI

> Install the CLI and connect your computer so Tasks can run on it.

<Info>Melso Agents is available only internally or by private invitation. Agents-specific features require existing access. For the autónomo fiscal service, see [Get started](/essentials/quickstart).</Info>

Five steps to install the Melso CLI and connect your computer as a [local runtime](/cli/local-runtimes).

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

<Warning>
  A local runtime executes Task code on your computer. Anyone who controls that computer can inspect its files and processes, including data used by a Run. Grant teammate access only when you trust both the work they will run and the computer owner.
</Warning>

## 1. Install

On macOS and Linux:

```bash theme={null}
curl -fsSL https://downloads.melso.ai/install.sh | bash
```

On Windows, in PowerShell:

```powershell theme={null}
irm https://downloads.melso.ai/install.ps1 | iex
```

Open a new terminal and check that it works:

```bash theme={null}
melso version
```

## 2. Sign in

```bash theme={null}
melso login
```

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

## 3. Install the agents

```bash theme={null}
melso worker local setup
```

This installs the supported Codex, Claude, and Pi packages under your Melso profile. Existing installations and their configuration are left unchanged.

## 4. Start the worker

```bash theme={null}
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

* **Pi:** always uses Melso credits; it does not use a connected subscription account.
* **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](/concepts/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](/cli/local-runtimes).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.