claustre

A TUI for orchestrating multiple Claude Code sessions

Claustre is a terminal dashboard for managing AI-assisted development workflows. It spins up isolated git worktrees, embeds native PTY terminals, and wires up Claude Code hooks so you can run parallel coding sessions across your projects without conflicts.

Install

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

Quick start

# Launch the dashboard — everything is managed from the TUI
claustre

Press a to add a project, n to create a task, l to launch it. Navigate with vim-style keys.

Features

Multi-project dashboard

Manage tasks and sessions across all your repositories from one place.

Git worktree isolation

Each Claude session gets its own worktree, so parallel work never conflicts.

Embedded terminals

Native PTY-based terminal panes with configurable layouts.

Automatic PRs

Claude commits, pushes, and opens a pull request when a task finishes.

Real-time status

Hooks fire after each Claude turn to sync state back to the TUI.

Task queue

Create tasks, assign them to sessions, and watch them flow through statuses.

Task modes

Supervised (one-at-a-time) or autonomous (auto-chains next task).

Subtasks

Break tasks into ordered steps that Claude works through sequentially.

Voice notifications

Get notified when tasks complete.

Config inheritance

Global + per-project CLAUDE.md and hooks, merged into every worktree.

Rate limit awareness

Polls the Anthropic OAuth API, pauses tasks when limits are hit.

Usage dashboard

Real-time 5h and 7d usage window bars with color-coded thresholds.

Skills management

Browse, install, and manage skills.sh packages from the TUI.

Project stats

Track time, tokens, and cost per project.

Documentation

Getting Started

Install claustre and launch your first task.

Architecture

How sessions, hooks, and the SQLite store fit together under the hood.

Configuration

Customize layouts, notifications, rate limit thresholds, and CLAUDE.md merging.

CLI Reference

All subcommands for managing projects, tasks, skills, and stats from the terminal.

TUI Guide

Keybindings, views, session tabs, and the embedded terminal workflow.

Tasks

Task lifecycle, statuses, modes, subtasks, and the autonomous chain runner.