Getting Started

Install bwt from npm, run the TUI for daily flow, and use one-off commands for automation.

Install

npm install -g better-worktree

Or run without global install:

npx better-worktree --help

Run the TUI

bwt

This launches the interactive workflow for browsing repos, creating worktrees, and cleanups.

Save repos in the TUI

In the TUI, open a repository path, then press M to save it. Saved repos stay in your config so you can reopen and manage them quickly later. Press U on a saved repo to remove it.

Use Settings copy rules for new worktrees

Press P to open repo settings, then add copy rules (for example .env.local:.env.local). Every time you create a worktree for that repo, these files are copied automatically into the new worktree.

Run one-off CLI commands

bwt list
bwt create feature-a -R app

Configuration file

Global settings live in ~/.config/bwt/config.json. Store repo aliases, preferred default branch, naming templates, and copy rules there.

Next step

Continue to Commands for the full reference and key bindings. If you want to build from source or contribute, see Contributing.