Command Reference

Core commands available from bwt.

Worktree commands

bwt list [-R <repo>] [--json]
bwt create <name> [-R <repo>] [--branch <branch>] [--base <base>] [--path <dir>] [--json]
bwt delete <name|path> [-R <repo>] [--yes] [--force]

• bwt list shows every tracked worktree for a repo.
• bwt create creates a new worktree with branch and base controls.
• bwt delete removes by worktree name or absolute path.

Repo commands

bwt repo list
bwt repo add <path> [--name <alias>]
bwt repo remove <path>
bwt repo use <path>
bwt repo set-copy <path> --rule <from[:to]> [--rule <from[:to]> ...]

• Add repositories once, then select them by alias with -R.
• Use copy rules to bring required files into new worktrees automatically.

How saved repos and copy rules work in the TUI

• Open a repo path, then press M to save it for future sessions.
• Press U on a saved repo to remove it from saved repos.
• Press P to open Repo Settings for the active repo.
• Add copy rules in Settings using from[:to] format (example: .env.local:.env.local).
• When you create a new worktree for that repo, configured rules are applied and files are copied automatically.

TUI keys

j / k or arrows  move selection
Enter            open repo/select
a                add repo or create worktree
d                delete selected worktree
x                remove saved repo
r                refresh
s                switch to repo picker
?                help
q                quit

Open the TUI with bun run start, then use these keys immediately.