Getting Started

Claustre is a terminal dashboard for orchestrating multiple Claude Code sessions across your projects. It manages git worktrees, task queues, and embedded terminal panes so you can run autonomous and supervised coding agents side by side.

Prerequisites

Make sure you have the following installed before setting up claustre:

• Rust (edition 2024) — install via rustup
• Claude Code — Anthropic's CLI agent. See the documentation
• gh — GitHub CLI, used by hooks to detect PRs. Install via brew install gh
• Node.js / npx — required for skills.sh integration (optional)

Installation

Install the latest release with the install script:

curl -fsSL https://claustre.pmbrull.me/install.sh | bash

Or build from source:

git clone https://github.com/pmbrull/claustre.git
cd claustre
cargo install --path .

Quick Start

Just run claustre — it creates the config directory automatically on first launch.

claustre

The dashboard opens showing your projects and task queue. Press a to add a project, n to create a task, l to launch it. Navigate with vim-style keys.

Alternatively, you can manage projects and tasks from the CLI. See the CLI Reference for all available commands.

First Task Walkthrough

Follow these steps to run your first task from start to finish:

1. Launch the dashboard: claustre
2. Add a project: Press a and enter the project name and path to your git repository
3. Create a task: Press n in the TUI
   • Title — short description of the work
   • Description — full prompt that Claude will receive
   • Mode — supervised (interactive) or autonomous (hands-off)
   • Use Tab to cycle fields, Enter to create
4. Launch the task: Focus the tasks panel (2), select a pending task, press l
   • Creates a git worktree
   • Opens a session tab with embedded terminal panes
   • Starts Claude with the task description
5. Monitor: The dashboard shows real-time status with indicators
   • • working
   • ◔ in review
   • ✓ done
   • ✗ error
6. Review: When Claude opens a PR, press o to open it in the browser, then r to mark the task done

What Happens When You Launch

When you press l on a pending task, claustre orchestrates several steps behind the scenes:

1. Git worktree created — a new branch is checked out in an isolated worktree under the project repo, keeping your main branch clean
2. CLAUDE.md + hooks merged — global and project-level configuration files are combined and copied into the worktree so Claude has full context
3. Session row created in SQLite — claustre tracks the session's status, token usage, and git diff stats in its local database
4. Embedded terminal tab opens — a new tab appears in the TUI with shell and Claude panes side by side
5. Claude starts working — in autonomous mode, claustre chains tasks automatically via feed-next; in supervised mode, you interact with Claude directly in the embedded terminal