Home / Docs / Installation

Installation

From Binary #

One command on Linux and macOS. The install script downloads the latest release, detects your platform, verifies checksums, and installs both binaries — thurbox (the TUI) and thurbox-cli (the headless one) — to ~/.local/bin .

bash 
curl -fsSL https://raw.githubusercontent.com/Thurbeen/thurbox/main/scripts/install.sh | sh

Then run it:

bash 
thurbox

The script handles:

  • Platform detection (Linux/macOS, x86_64/aarch64)
  • Automatic version fetching with API rate limit fallback
  • SHA256 checksum verification
  • Creating ~/.local/bin if needed
  • Post-install instructions

export is not optional for the environment variables below. In VAR=x curl … | sh the assignment binds to curl, and the sh reading from the pipe never sees it — so the setting is silently ignored. Export it on its own line first.

Custom install directory

bash 
export INSTALL_DIR=/usr/local/bin
curl -fsSL https://raw.githubusercontent.com/Thurbeen/thurbox/main/scripts/install.sh | sh

Specific version

bash 
export VERSION=v2.5.4
curl -fsSL https://raw.githubusercontent.com/Thurbeen/thurbox/main/scripts/install.sh | sh

Without a pin you get the newest release. Every version is on the releases page.

Windows (PowerShell)

Windows uses psmux, not tmux. Every Windows route needs psmux, a drop-in tmux clone on ConPTY that speaks the same control-mode protocol, installed separately. (A WSL distro is a remote host and runs tmux inside the distro.) psmux is the newer of the two and a bit less stable, so please report anything you hit.

On native Windows the install script is PowerShell, and it is the recommended route — unlike the winget and Chocolatey packages below, it always carries the newest release. It installs to %LOCALAPPDATA%\Programs\thurbox (added to your user PATH).

powershell 
irm https://raw.githubusercontent.com/Thurbeen/thurbox/main/scripts/install.ps1 | iex

Set $env:THURBOX_VERSION = 'v2.5.4' before that line to pin a specific version instead of taking the newest.

Available platforms

Platform Architecture Artifact
Linux (glibc) x86_64 thurbox-v{ver}-x86_64-unknown-linux-gnu.tar.gz
Linux (musl) x86_64 thurbox-v{ver}-x86_64-unknown-linux-musl.tar.gz
macOS Apple Silicon thurbox-v{ver}-aarch64-apple-darwin.tar.gz
Windows x86_64 thurbox-v{ver}-x86_64-pc-windows-msvc.zip

winget (Windows) #

On Windows, install the prebuilt x86_64 binaries with winget (Microsoft's package manager, bundled with Windows 10/11):

powershell 
winget install Thurbeen.thurbox

Installs thurbox.exe and thurbox-cli.exe from the GitHub Release as portable commands on your PATH . Needs psmux as the multiplexer, installed separately.

Release cadence. winget-pkgs is manually reviewed, so thurbox submits a new winget version on every release, but skips a submission while its previous one is still an open PR — wingetcreate can't update a pending PR, and a submission waits on review before it goes live. The latest build always ships immediately via the PowerShell installer above and GitHub Releases , so irm … install.ps1 | iex stays the recommended route on Windows; the winget channel intentionally trails a little.

Chocolatey (Windows) #

On Windows, install the prebuilt x86_64 binaries from the Chocolatey community repository :

powershell 
choco install thurbox

Installs thurbox.exe and thurbox-cli.exe from the GitHub Release and shims them onto your PATH . Needs psmux as the multiplexer, installed separately (there is no Chocolatey package for it). New versions go through community-repo moderation before they appear.

Release cadence. Unlike winget, the Chocolatey community repo is rate-limited on a calendar, so thurbox pushes a new Chocolatey version at most once every 30 days (intermediate releases are coalesced into the next push). The latest build always ships immediately via the PowerShell installer above and GitHub Releases , so irm … install.ps1 | iex stays the recommended route on Windows; the Chocolatey channel intentionally trails a little.

Homebrew #

On macOS or Linux, install the prebuilt binaries from the thurbox tap :

bash 
brew install thurbeen/thurbox/thurbox

This installs thurbox and thurbox-cli , pulling in tmux and git as dependencies. Supported on macOS Apple Silicon and Linux x86_64 (Intel macOS and aarch64 Linux have no release binary — use the one-liner or build from source there).

Arch Linux (AUR) #

Thurbox is on the AUR as thurbox (builds from source) and thurbox-bin (prebuilt release binary). Install with your AUR helper:

bash 
paru -S thurbox-bin   # prebuilt binary (fastest)
paru -S thurbox       # build from source

tmux is pulled in as a dependency. Swap paru for yay or your preferred helper.

From Source #

bash 
git clone https://github.com/Thurbeen/thurbox.git
cd thurbox
cargo build --release

The binary will be at target/release/thurbox . Requires Rust 1.75+.

Prerequisites #

Dependency Required Purpose
tmux >= 3.2 (or psmux on Windows) Yes Session backend
A coding-agent CLI Yes e.g. claude , codex, antigravity, opencode, aider, copilot, vibe, pi, or omp — whichever agents you plan to run
git Yes Worktree features
Rust 1.75+ Optional Building from source

Quick Start #

  1. Launch Thurbox — run thurbox in your terminal. You'll see the session sidebar and a terminal panel.
  2. Create a session — press Ctrl+N to open the repo picker. Pick repos (optionally a worktree), name the session, then choose an agent.
  3. Work with the agent — the terminal panel shows the live agent session. All keys are forwarded to the PTY.
  4. Navigate — Ctrl+L / Ctrl+H cycle pane focus, Ctrl+J / Ctrl+K switch sessions.
  5. Quit — Ctrl+Q detaches all sessions (tmux keeps them running). They resume on next launch.
  6. Make it yours — Ctrl+, then ] lists every pane and lets you turn one off, Ctrl+Y changes the palette, F1 rebinds any chord. Or just ask an agent — see just ask for it .

Configuration #

Session state is stored in SQLite at ~/.local/share/thurbox/thurbox.db ( $XDG_DATA_HOME respected). Agent definitions live in ~/.config/thurbox/agents.toml (seeded on first run). Logs go to ~/.local/share/thurbox/thurbox.log .

Uninstall #

Remove the binary, depending on how you installed it:

bash 
rm ~/.local/bin/thurbox        # curl one-liner / manual install
brew uninstall thurbox         # Homebrew
paru -R thurbox thurbox-bin    # Arch (AUR)
winget uninstall Thurbeen.thurbox  # winget (Windows)
choco uninstall thurbox        # Chocolatey (Windows)

Sessions outlive Thurbox in tmux, so stop them too — and optionally delete state and config (this erases session history, theme, and agents.toml ):

bash 
tmux -L thurbox kill-server    # ends all running agent sessions
rm -rf ~/.local/share/thurbox ~/.config/thurbox   # optional: wipe state