1-click worktrees

The feature that makes parallel agents safe. New Task (⇧⌘N) creates an isolated git branch, its own working directory and an agent to work in it — without touching the code in front of you.

What one click does

1. Creates a branch from your current HEAD.
2. Creates a real git worktree in its own directory, so the files are physically separate.
3. Opens a terminal panel already inside it, with the agent running.
4. Assigns the task a colour that follows it everywhere.

Tasks run side by side, each on its own branch and in its own directory, and none of them can step on the file you have open. How many at once is the one thing the plan decides — two on Free, as many as the machine takes on Pro (see the limits below).

The colour is the point

The same colour marks the task in the sidebar, on its dock tabs and on its territory on the canvas. When four agents are talking at once, colour is what tells you which branch a given panel belongs to before you read a single word.

Territories

Turn on Settings, Worktrees, Worktree Territories and every panel belonging to a task is enclosed in a coloured island. Panels of the same branch merge into one shape; a panel dragged out of the group takes its colour with it.

It is off by default: on a busy canvas the islands are information, and on a quiet one they are decoration. The switch is yours.

Finishing a task

The branch is an ordinary git branch and the worktree is an ordinary git worktree. Review the diff in Monaco, merge it the way your project merges anything, and remove the worktree when you are done.

Nothing about the task is proprietary — if you uninstalled Catenary right now, git worktree list would still show exactly what it created.

Limits