Home / Docs / Installation

Installation

From Binary (Recommended) #

The install script downloads the latest release, detects your platform, and verifies checksums automatically.

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

This installs to ~/.local/bin by default. 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

Custom install directory

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

Specific version

bash 
$ VERSION=v0.1.0 curl -fsSL https://raw.githubusercontent.com/Thurbeen/thurbox/main/scripts/install.sh | sh

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

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 Yes Session backend
A coding-agent CLI Yes e.g. claude , codex, gemini, opencode, aider, or vibe — 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 and a model.
  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.

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)

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