Copy page

CLI

CLI installation

The Tomba CLI, tomba, is a single binary for macOS, Linux, and Windows. After you install it, sign in as described in Authentication.

Install

Release builds are available for macOS (amd64, arm64), Linux (386, amd64, armv6, arm64, ppc64), and Windows (386, amd64, arm64).

Install script (macOS and Linux)

Code
curl -sSL https://releases.tomba.io/install.sh | sh

The script downloads the latest release for your platform from GitHub Releases, checks its SHA-256 checksum, installs tomba to /usr/local/bin (with sudo if that directory isn't writable), and sets up completion for bash, zsh, or fish. If it can't download the checksum file or find sha256sum or shasum, it prints a warning and installs without checking; to check the archive yourself, see Verify the download.

To pin a version or install to another directory, pass --version or --dir:

Code
curl -sSL https://releases.tomba.io/install.sh | sh -s -- --version 1.2.3 --dir "$HOME/.local/bin"

PowerShell (Windows)

Code
irm https://releases.tomba.io/install.ps1 | iex

The script checks the SHA-256 checksum, installs tomba.exe to %LOCALAPPDATA%\tomba, adds that folder to your user PATH, and adds PowerShell completion to your profile.

Homebrew

Code
brew install --cask tomba-io/tap/tomba

Scoop (Windows)

Code
scoop bucket add tomba https://github.com/tomba-io/scoop-bucket.git
scoop install tomba

Snap (Linux)

Code
sudo snap install tomba

Linux packages

Each release includes .deb, .rpm, .apk, and Arch Linux (.pkg.tar.zst) packages. For example, on Debian or Ubuntu:

Code
curl -LO https://github.com/tomba-io/tomba/releases/latest/download/tomba_amd64.deb
sudo apt install --no-install-recommends ./tomba_amd64.deb

The packages depend on git and systemd and recommend golang; --no-install-recommends skips the Go toolchain. They install shell completion, a man page, and a systemd unit, tomba.service, which runs tomba serve as www-data and is enabled at boot. If you don't use the local server, disable the unit:

Code
sudo systemctl disable --now tomba

Go

Requires Go 1.25 or later.

Code
go install github.com/tomba-io/tomba@latest

The binary goes to $(go env GOPATH)/bin, which must be on your PATH. Builds from go install report their version as dev.

Verify the download

Every release publishes tomba_checksums.txt with the SHA-256 checksum of each archive and package. To install from an archive and check it first:

Code
VERSION=1.2.3
curl -LO "https://github.com/tomba-io/tomba/releases/download/v${VERSION}/tomba_linux_amd64.tar.gz"
curl -LO "https://github.com/tomba-io/tomba/releases/download/v${VERSION}/tomba_checksums.txt"
sha256sum --ignore-missing -c tomba_checksums.txt
tar -xzf tomba_linux_amd64.tar.gz tomba
sudo install -m 0755 tomba /usr/local/bin/tomba

On macOS, use shasum -a 256 --ignore-missing -c tomba_checksums.txt and the tomba_darwin_arm64 or tomba_darwin_amd64 archive. The check prints OK next to the archive name; any other result means the file doesn't match the release, so don't install it.

Verify the installation

Code
tomba version

Code
tomba 1.2.3
  built:    2026-09-27T14:29:29Z
  commit:   0949b31
  go:       go1.27.1
  os/arch:  linux/amd64

tomba --version prints the version on one line (tomba version 1.2.3).

Shell completion

The install scripts, Homebrew, and the Linux packages set up completion for you. To load it yourself for the current session:

Code
# bash (requires the bash-completion package)
source <(tomba completion bash)

# zsh
source <(tomba completion zsh)

# fish
tomba completion fish | source

Code
tomba completion powershell | Out-String | Invoke-Expression

To load completion in every new session, follow the steps that tomba completion <shell> --help prints for your shell.

Update

Code
tomba update

tomba update (alias upgrade) looks up the latest release on GitHub, downloads the archive for your platform, checks its SHA-256 checksum when the checksum file is available, and replaces the tomba binary in place. If the binary is in a directory you can't write to, the command fails with Cannot rename current binary (may need sudo); run it with sudo.

If you installed with a package manager, update with the same tool so it keeps track of the version:

Uninstall

The CLI keeps saved credentials in ~/.tomba.json and custom skills in ~/.tomba/skills/. Removing the binary leaves them in place; delete them with:

Code
rm -rf ~/.tomba.json ~/.tomba