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 x86_64 thurbox-v{ver}-x86_64-apple-darwin.tar.gz
macOS Apple Silicon thurbox-v{ver}-aarch64-apple-darwin.tar.gz

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
claude CLI Yes AI coding assistant ( install )
git Yes Worktree features
Docker or Podman Optional Container sessions (Podman preferred)
QEMU/KVM Optional VM sandbox sessions
Rust 1.75+ Optional Building from source

For VM sessions, you need qemu-system-x86_64 , /dev/kvm , and genisoimage (or mkisofs ).

Quick Start #

  1. Launch Thurbox — run thurbox in your terminal. The Admin session appears automatically.
  2. Create a project — press Ctrl+N with the project list focused. Enter a name and repository paths.
  3. Create a session — select your project, press Ctrl+N again. Choose a session mode (Normal, Worktree, Container, or VM).
  4. Work with Claude — the terminal panel shows the live Claude Code session. All keys are forwarded to the PTY.
  5. Navigate — Ctrl+L cycles focus, Ctrl+H jumps to project list, Ctrl+J / Ctrl+K switch items.
  6. Quit — Ctrl+Q detaches all sessions (tmux keeps them running). They resume on next launch.

Configuration #

All state (projects, sessions, roles) is stored in SQLite at ~/.local/share/thurbox/thurbox.db ( $XDG_DATA_HOME respected). Logs go to ~/.local/share/thurbox/thurbox.log .

Container templates are stored at ~/.local/share/thurbox/admin/containerfiles/ . A default/ template (Debian Bookworm-based) is created on first run.

VM base images are cached at ~/.local/share/thurbox/images/ . Per-VM state lives under ~/.local/share/thurbox/vms/ .