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.
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.
Homebrew
Install Script
Debian / Ubuntu
First, add the Tolmo tap to Homebrew, then install the CLI:brew tap tolmohq/tolmo https://github.com/tolmohq/tolmo
brew install tolmo
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:tolmo skill install
tolmo skill status
Run the official install script with a single command:curl -fsSL https://tolmo.com/install.sh | sh
/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:TOLMO_INSTALL_DIR="$HOME/.local/bin" curl -fsSL https://tolmo.com/install.sh | sh
PATH. Add the following line to your shell profile (~/.bashrc, ~/.zshrc, etc.) if it is not already present:export PATH="$HOME/.local/bin:$PATH"
Download the .deb package for your architecture from the latest GitHub release, then install it with dpkg:sudo dpkg -i tolmo_<version>_<arch>.deb
<version> with the release version number (for example, 0.9.1) and <arch> with your architecture (amd64 or arm64). Nightly builds
Nightly builds track the latest development changes and are published automatically from the main branch.
Homebrew:
brew install tolmo@nightly
curl -fsSL https://tolmo.com/install.sh | sh -s -- --nightly
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.
Verify installation
After installing, confirm the CLI is available and check the 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:
Install script: Re-run the install script and it will replace the existing binary with the latest release:
curl -fsSL https://tolmo.com/install.sh | sh