better-worktree
Quick Start

Documentation

What better-worktree does

Git worktree workflow

Ship branches faster without path juggling.

bwt keeps repositories and worktrees in one keyboard-first flow so creating, switching, and cleaning up branches is always one command away.

TUI preview

A quick look at the interactive better-worktree terminal UI.

better-worktree TUI showing repositories, worktrees, and commands

What we do

better-worktree combines scriptable CLI commands with an interactive TUI so teams can move between branch tasks without losing context.

CLI for quick operations

Use one-off commands in scripts or terminal sessions to list, create, and remove worktrees with predictable output.

TUI for daily flow

Launch without arguments to manage repos, inspect status, and create worktrees without leaving the keyboard.

Repo-aware defaults

Store repository aliases and copy rules in config so each new worktree starts with the files and defaults your team expects.

How to do it

1. Install and open

Install bwt from npm and launch the TUI workflow.

npm install -g better-worktree
bwt

2. Register repos

Save repository paths once so worktree creation is faster next time.

bwt repo add /path/to/repo --name app
bwt repo list

3. Create and clean worktrees

Spin up task branches quickly, then remove stale worktrees safely.

bwt create feat-login -R app --branch feat/login
bwt delete feat-login -R app