Up and running in seconds

Tamer is a lightweight CLI that wraps your favorite AI agents. Install once via npm, then prefix any agent command with tamer.

Linux & macOS

Requires Node.js 20+. Check with node --version.

npm install -g tamer-cli
Linux sandbox: tamer uses bubblewrap (bwrap) for kernel-level isolation. Install it if not present:
sudo apt install bubblewrap   # Debian/Ubuntu
sudo dnf install bubblewrap   # Fedora/RHEL macOS uses sandbox-exec (built-in). No extra install needed.

Windows

Requires Node.js 20+ and a PowerShell or Command Prompt session.

npm install -g tamer-cli
Note: the Linux kernel sandbox (bwrap) is Linux-only. On Windows, tamer uses the Windows Job Object sandbox instead. For the best experience — especially with Linux-only agents — we recommend running tamer inside WSL 2 (Windows Subsystem for Linux).

First Steps

  1. 1

    Connect to your server

    tamer init

    Links your CLI to your Tamer server and registers your phone.

  2. 2

    Run any agent

    tamer claude tamer gemini,claude

    Prefix any agent command with tamer. Chain multiple agents with commas — tamer hands off automatically when one hits its token limit.

  3. 3

    Watch the log stream

    tamer-log

    Opens the real-time session log viewer — token usage, approvals, and agent output in one terminal.

Legacy install (curl | bash)

Node.js is now the required runtime for tamer-cli (Node.js 20+). New installs should use npm install -g tamer-cli.

Linux & macOS

npm install -g tamer-cli

Windows (PowerShell)

npm install -g tamer-cli

Self-Hosting?

Want to run your own Tamer server? Our server is lightweight and distributed as a Docker image.

Deploy your own Server