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

# Install the Tolmo CLI: Homebrew, Script, and Debian

> Install the Tolmo CLI via Homebrew, the install script, or a Debian package. Supports macOS and Linux on amd64 and arm64 architectures.

Tolmo runs on macOS and Linux and supports both amd64 and arm64 architectures. Choose the installation method that fits your workflow: Homebrew is the easiest option for interactive use, the install script works on any system without a package manager, and the Debian package integrates with `dpkg`-based systems.

<Tabs>
  <Tab title="Homebrew">
    First, add the Tolmo tap to Homebrew, then install the CLI:

    ```bash theme={null}
    brew tap tolmohq/tolmo https://github.com/tolmohq/tolmo
    brew install tolmohq/tolmo/tolmo
    ```

    <Note>
      The Homebrew formula installs the Tolmo CLI binary only. It does **not** automatically modify Claude Code or other coding-agent directories. If you want to use Tolmo as an agent skill, run the following after installation:

      ```bash theme={null}
      tolmo skill install
      tolmo skill status
      ```
    </Note>
  </Tab>

  <Tab title="Install Script">
    Run the official install script with a single command:

    ```bash theme={null}
    curl -fsSL https://tolmo.com/install.sh | sh
    ```

    The script automatically selects a writable install directory. When `/usr/local/bin` is not writable — the common case on macOS without admin rights — it falls back to a user-level directory, so you typically do not need `sudo`.

    To install to a custom directory, set the `TOLMO_INSTALL_DIR` environment variable before running the script:

    ```bash theme={null}
    TOLMO_INSTALL_DIR="$HOME/.local/bin" curl -fsSL https://tolmo.com/install.sh | sh
    ```

    After installation, make sure the install directory is on your `PATH`. Add the following line to your shell profile (`~/.bashrc`, `~/.zshrc`, etc.) if it is not already present:

    ```bash theme={null}
    export PATH="$HOME/.local/bin:$PATH"
    ```
  </Tab>

  <Tab title="Debian / Ubuntu">
    Download the `.deb` package for your architecture from the [latest GitHub release](https://github.com/tolmohq/tolmo/releases/latest), then install it with `dpkg`:

    ```bash theme={null}
    sudo dpkg -i tolmo_<version>_<arch>.deb
    ```

    Replace `<version>` with the release version number (for example, `0.9.1`) and `<arch>` with your architecture (`amd64` or `arm64`).
  </Tab>
</Tabs>

## Nightly builds

Nightly builds track the latest development changes and are published automatically from the main branch.

**Homebrew:**

```bash theme={null}
brew install tolmohq/tolmo/tolmo-nightly
```

**Install script:**

```bash theme={null}
curl -fsSL https://tolmo.com/install.sh | sh -s -- --nightly
```

<Note>
  Nightly builds may be unstable and are not recommended for production use. Use them to preview upcoming features or reproduce bugs against the latest code.
</Note>

## Verify installation

After installing, confirm the CLI is available and check the version:

```bash theme={null}
tolmo --version
```

You should see the installed version number printed to stdout. If the command is not found, check that the install directory is on your `PATH`.

## Update

Keep the CLI up to date to access the latest features and fixes.

**Homebrew:**

```bash theme={null}
brew upgrade tolmo
```

**Install script:** Re-run the install script and it will replace the existing binary with the latest release:

```bash theme={null}
curl -fsSL https://tolmo.com/install.sh | sh
```