Introduction
ccwt is a small command-line helper for managing coding-agent git worktrees.
An agent works best in a worktree of its own, one per task, under
<repo-root>/.claude/worktrees/<name>. ccwt lets you create, list, jump between, and
tear down those worktrees from your own shell, with a table saying what each one is about
and whether something is running in it.
It started out as a Claude Code helper, and Claude Code
is still hardcoded in a handful of places: the .claude/worktrees/ layout and the
adjective-verb-noun naming scheme (which is what keeps ccwt and claude --worktree
interoperable), the AGENT column, which looks for running Claude Code processes, and
TOPIC, the freshness sort and the worklog's session page, which all read Claude Code
transcripts. The rest — the worktrees, the table, the tui, the queue, the ✳ marker —
doesn't care which agent you run, and task_command is
where you say which one that is.
How this book is laid out
- Getting started installs
ccwtand hooks it into your shell. - Worktrees is the commands you type: making, listing and removing worktrees, and asking where their reviews stand.
- The tui is the full-screen view a bare
ccwtopens, which keeps that list up to date and queues the work that comes next. - Herdr is what changes when Herdr is running. None of it is needed for the rest.
- Setting up covers the config file and running Claude Code through
ccwt. - Commands lists every command and flag in one place.
- The map is ccwt's own map of its components, published next to this book.