All docs
Docs/Columns/14

Worktrees

A repository's worktrees, live: what changed in each, the agents in them, and new ones.

The list

Add a Worktrees column from Start, in a folder of a repository. It lists the repository's worktrees as they change: each one's branch, its uncommitted changes, its commits not in the base, and the agents working in it. All, Changed, Ahead and Clean narrow the list, and Order sorts it by Recent or Name. Click a row for its path, its changed files by folder and its commits.

Making one

New worktree takes a Branch, a new one or one that exists, and From, the branch a new one starts from. It's made beside the main worktree, named after the repository and the branch. Then opens an agent in it, with no prompt or one of the repository's prompts.

Agents in a worktree

An agent working in a worktree shows on its row; click it to go there. Open an agent in it starts one there, with no prompt or one of the prompts.

Removing one

Remove it asks first. Its branch goes too when nothing on it would be lost. The row says what removing it loses, uncommitted files or commits not in the base, and asks once more for those. Agents working in it are settled. The main worktree, and the one the column works in, stay.

Settings

Settings holds what the worktrees are compared against (the main worktree's branch unless you pick another), the repository's prompts, which can use {branch}, {path}, {repo} and {base}, and the files to copy into every new worktree, like .env: one path or glob per line.

Close the other windows.

Get ORVEN