Claude Manager

A terminal UI (TUI) for managing multiple Claude Code sessions organized by projects and tasks. Built with Rust using ratatui.

Claude Manager uses tmux to run Claude Code sessions in the background, letting you organize them into projects and tasks, monitor their status, preview diffs, and attach/detach freely.

Prerequisites

• Cargo (Rust 1.85+) — install via rustup
• tmux — brew install tmux (macOS) or apt install tmux (Linux)
• Claude Code CLI (claude) — must be installed and available in your PATH
• git — for worktree and branch management
• gh (optional) — GitHub CLI, for PR creation features

Installation

cargo install claude-manager

Or build from source:

git clone git@github.com:Bendzae/claude-manager.git
cd claude-manager
cargo install --path .

Usage

claude-manager

Launch from any directory. Configuration is stored in ~/.claude-manager/config.toml.

Concepts

• Project — A git repository you want to manage Claude sessions for. Added by its filesystem path.
• Task — A unit of work within a project, tied to a git branch. Each task can have multiple Claude sessions.
• Session — A Claude Code instance running in a tmux session. Sessions can be created with an optional initial prompt.

Keybindings

All keybindings are customizable via ~/.claude-manager/keybindings.toml. The tables below show the defaults. See keybindings.example.toml for a full template.

Global

Key	Action	Config key
j/k or Up/Down	Navigate	move_down / move_up
Enter	Attach to session / expand item	—
Space	Collapse/expand project or task	toggle_collapse
a	Open context menu	context_menu
p	Add project	add_project
Tab	Toggle preview mode (diff/context)	—
J/K	Scroll preview pane	scroll_preview_down / scroll_preview_up
q	Quit	quit

Context Menu (press a to open)

The context menu shows actions relevant to the selected item. Press the hotkey character to execute directly, or navigate with j/k and confirm with Enter. Context menu keys are configured under the [context_menu_keys] section.

Project actions:

Key	Action	Config key
t	Add task	add_task
R	Rename	rename
d	Delete	delete

Task actions:

Key	Action	Config key
n	New session (with worktree)	new_session
N	New session (without worktree)	new_session_no_worktree
u	Update/rebase branch onto main	update
P	Push branch	push
b	Checkout branch in project dir	checkout
o	Open/create PR	open_pr
R	Rename	rename
d	Delete	delete

Session actions:

Key	Action	Config key
m	Merge into task branch	merge
u	Update/rebase onto task branch	update
c	Create terminal window	create_terminal
k	Kill terminal window	kill_terminal
R	Rename	rename
d	Delete	delete

Session Status Indicators

Sessions display their current status:

• Running — Claude is actively working
• Waiting for input — Claude is waiting for your response
• Waiting for permission — Claude needs tool approval
• Finished — Claude has completed its work

Worktrees

When creating a session with n (via the context menu on a task), Claude Manager creates a git worktree so each session works on an isolated copy of the codebase. Use N to skip worktree creation and work directly in the project directory.

You can configure file patterns to copy into new worktrees (e.g. .env files) by adding copy_patterns to your project config:

[[projects]]
name = "My App"
path = "/path/to/my-app"
copy_patterns = [".env", ".env.local"]

Configuration

The config file at ~/.claude-manager/config.toml is managed automatically through the TUI, but can also be edited manually:

[[projects]]
name = "My App"
path = "/home/user/my-app"
copy_patterns = [".env"]

[[projects.tasks]]
name = "fix-auth-bug"
branch = "fix/auth-bug"

[[projects.tasks]]
name = "add-dark-mode"
branch = "feature/dark-mode"

Custom Keybindings

Create ~/.claude-manager/keybindings.toml to override any default keybinding. Only the keys you specify are overridden; everything else keeps its default. Example:

quit = "Q"
context_menu = "o"

[context_menu_keys]
delete = "x"