Frequently Asked Questions

Short answers to the most common questions about Thurbox. For depth, follow the links into the rest of the docs.

What is Thurbox?

Thurbox is a multi-session TUI orchestrator that runs any coding-agent CLI — Claude Code, Codex, Antigravity, opencode, aider, GitHub Copilot CLI, Vibe, pi, Oh My Pi, or any CLI you define — inside persistent tmux panes. Sessions, agents, and git worktrees are first-class citizens, and sessions survive crashes, restarts, and reboots because tmux keeps the processes alive.

How is Thurbox different from other parallel coding-agent tools?

Unlike tools such as Conductor, Claude Squad, or Cursor, Thurbox uses real tmux as its session backend rather than a re-implemented multiplexer, runs as a lightweight terminal UI rather than an Electron or native desktop app, and launches the unmodified vendor CLI rather than its own model. A single session can span multiple repositories, and every pane of the interface is a Lua file you can edit, turn off or replace. Agents are defined as data, so any CLI works with no recompile. See the comparison for the full breakdown.

Which coding agents does Thurbox support?

Thurbox is agent-neutral. It ships built-in definitions for Claude Code, Codex, Antigravity, opencode, aider, GitHub Copilot CLI, Vibe, pi, and Oh My Pi, and you can add any other CLI by editing agents.toml — no recompile required. Thurbox only knows how to launch each CLI with the right command and arguments; it never touches the agent's model, prompts, or permissions.

How do I install Thurbox?

On Linux or macOS, run curl -fsSL https://raw.githubusercontent.com/Thurbeen/thurbox/main/scripts/install.sh | sh. It is also available via Homebrew (brew install thurbeen/thurbox/thurbox), the AUR (thurbox or thurbox-bin), and on Windows via winget (winget install Thurbeen.thurbox) or Chocolatey (choco install thurbox). Both of those channels are moderated and lag behind the newest release — Chocolatey by up to 30 days, winget by however long its manifest PR waits for review — so the PowerShell installer (irm https://raw.githubusercontent.com/Thurbeen/thurbox/main/scripts/install.ps1 | iex) is the recommended route on Windows. You can also build from source with cargo build --release. See installation for details.

Which platforms does Thurbox run on? Does it support remote machines?

Thurbox runs on Linux, macOS, and Windows. It requires tmux 3.2+ on Linux/macOS and psmux on Windows. It can also run sessions on a remote host over SSH while the TUI runs locally — remote hosts are declared in hosts.toml.

Do my sessions survive a crash or restart?

Yes. Each session runs inside a persistent tmux session, so the agent processes keep running even if Thurbox crashes or you close and reopen it. Session state is stored in SQLite and re-adopted on restart.

Is Thurbox free and open source?

Yes. Thurbox is open source under the MIT license and free to use.

Can I use Thurbox without the TUI, headlessly?

Yes. A second binary, thurbox-cli, drives the same SQLite-backed, tmux-hosted sessions headlessly — create, list, send to, capture, restart, and delete sessions, plus automations and tasks — sharing the database with the TUI. This makes Thurbox scriptable for automation and CI.