Multi-Session Agent Orchestrator

Run parallel Claude instances in persistent tmux panes. Sessions survive crashes and restarts.

MIT License Built with Rust
thurbox

Features

Everything you need to run Claude Code at scale

🖥

Session Orchestration

Run multiple Claude Code instances side-by-side, each in its own tmux pane. Sessions persist across crashes, restarts, and multiple concurrent Thurbox instances.

🌳

Git Worktrees

Spawn sessions in isolated git worktrees for branch-level isolation. Auto-sync with origin/main and automatic worktree cleanup on session close.

📦

Container Sessions

Run sessions inside Docker or Podman containers with customizable Containerfile templates and optional firewall-restricted network egress.

🔒

VM Sandbox

Full OS-level isolation via QEMU/KVM virtual machines. Debian 13 VMs with 2 CPUs, 2 GB RAM, pre-installed Claude CLI, and automatic session restoration.

🛡

Role System

Define per-project permission profiles that control Claude's behavior. Configure permission modes, allowed/denied tools, and scope patterns like Bash(git:*) .

🔌

MCP Server

The thurbox-mcp binary exposes project, role, and session management over the Model Context Protocol. Manage everything conversationally via the Admin session.

How It Works

Four steps from install to coding

1

Install

One command to download and install the latest release.

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

Launch

Start Thurbox. The Admin session appears automatically.

bash
$ thurbox
3

Create a Project

Press Ctrl+N to create a project with one or more repository paths.

thurbox
# With the project list focused:
Ctrl+N  Create new project
# Enter name: my-app
# Enter path: ~/projects/my-app
4

Start Coding

Create sessions, choose a mode (Normal, Worktree, Container, or VM), and start working with Claude.

thurbox
Ctrl+N  New session (select mode)
Ctrl+L  Cycle focus to terminal
Ctrl+J  Switch between sessions
Ctrl+E  Edit project (roles, repos)

Installation

Get up and running in seconds

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

Installs the latest release to ~/.local/bin . Auto-detects platform, verifies checksums.

Custom Directory

INSTALL_DIR=/usr/local/bin curl ...

Specific Version

VERSION=v0.1.0 curl ...

From Source

cargo build --release

Prerequisites

  • tmux >= 3.2 — session backend
  • claude CLI github.com/anthropics/claude-code
  • git — required for worktree features
  • Docker or Podman — for container sessions (optional)
  • QEMU/KVM — for VM sandbox sessions (optional)
  • Rust 1.75+ — only for building from source (optional)