Home / Docs / Installation

Installation

From Binary #

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=v1.0.0 curl -fsSL https://raw.githubusercontent.com/Thurbeen/thurbox/main/scripts/install.sh | sh

Windows (PowerShell)

Experimental. Windows support is experimental for now — the core works (psmux as the multiplexer, a native ConPTY backend, WSL distros as remote hosts), but it sees less testing than Linux/macOS. Expect rough edges and please report issues.

On native Windows the install script is PowerShell. It installs to %LOCALAPPDATA%\Programs\thurbox (added to your user PATH) and uses psmux as the multiplexer.

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

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

Pending review. The winget package has been submitted to microsoft/winget-pkgs but is not yet merged , so winget install Thurbeen.thurbox will not resolve until the PR is approved. Use the PowerShell installer above in the meantime.

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 at most once every 30 days (intermediate releases are coalesced into the next submission). The latest build always ships immediately via the PowerShell installer above and GitHub Releases ; 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. Like winget, the Chocolatey community repo is moderated and rate-limited, 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 ; 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 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)
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