Skip to content
Thrum

Install Thrum

Free

Install Thrum on your machine, add its plugin to Claude Code, and check that both work. After that, the quickstart starts your first coordinator, the agent you talk to, which starts the other agents, hands out work and reports back to you.

Before you install

Section titled “Before you install”
  • macOS or Linux
  • Git, and a repository with at least one commit: git --version
  • A Git identity, set globally or in the repository: git config user.name && git config user.email (both must print a value). If either prints nothing, set it with git config --global user.name "Your Name" and git config --global user.email "you@example.com".
  • tmux, because Thrum runs its agents in tmux sessions: tmux -V
  • Claude Code: claude --version
  • jq, which the Thrum plugin uses at session start: jq --version. Without jq, an agent does not load its briefing (the summary it reads when it starts) by itself. You then type /thrum:prime in its Claude Code session to load it.

Install Thrum

Section titled “Install Thrum”

With Homebrew, on macOS or Linux:

Terminal window
brew install --cask thrum-team/tap/thrum-pro

Without Homebrew, run the install script. It downloads the file for your platform from the release, checks its checksum and puts thrum in ~/.local/bin:

Terminal window
curl -fsSL https://raw.githubusercontent.com/thrum-team/thrum-pro/main/install.sh | VERSION=v1.0.0 bash

VERSION=v1.0.0 picks the release to install. Leave it out and the script installs the latest release.

When it finishes, it prints the checksum result and where it put thrum:

Checksum OK
Installed thrum -> ~/.local/bin/thrum

Or download the file for your platform yourself from the latest release, unpack it, and move thrum onto your PATH. The file is named thrum_<version>_<os>_<arch>.tar.gz, where <os> is linux or darwin (macOS) and <arch> is amd64 or arm64. For example:

Terminal window
tar -xzf thrum_*.tar.gz
mkdir -p ~/.local/bin
mv thrum ~/.local/bin/

If your shell can’t find thrum afterwards, add ~/.local/bin to your PATH.

When the install finishes, check it:

Terminal window
thrum --version

Licence terms

Section titled “Licence terms”

Thrum is licensed under the Thrum End User License Agreement (EULA) (https://my.thrum.team/legal/eula). The first time you run thrum, it shows you the EULA and asks you to type yes to accept it. Free features need no account and no payment. On a US time zone Thrum then shows a notice about a one-time install count; anywhere else it asks you. What it sends.

The prompt shows the EULA’s title, version, checksum and web address, and asks again whenever the EULA version in your release changes. The first run of thrum --version or thrum --help does not ask.

For CI or scripts, set THRUM_ACCEPT_EULA to the EULA version the prompt shows. Setting it accepts that version of the EULA without the prompt, so read the EULA first. Without a terminal, Thrum stops and prints the exact variable to set.

Add the Thrum plugin to Claude Code

Section titled “Add the Thrum plugin to Claude Code”

The plugin is what makes each Claude Code session start briefed as a Thrum agent. Do this once per machine. thrum-team/thrum-pro is where the plugin is distributed from. It holds the plugin’s text files, not the Thrum program.

  1. Add the plugin:

    Terminal window
    claude plugin marketplace add thrum-team/thrum-pro
    claude plugin install thrum@thrum

  2. Check that Claude Code installed it. If you had Claude Code open during the install, restart it.

    Terminal window
    claude plugin list

    The list shows thrum@thrum as installed and enabled.

To remove the plugin later, see Remove the plugin.

Already using Thrum and installing a new version? Follow Update Thrum afterwards.

Next steps

Section titled “Next steps”