wt-cli

wt is a Bun-powered CLI for fast Git worktree workflows. It wraps common git worktree operations with concise commands, readable output, and optional shell integration for jumping into created or selected worktrees.

Requirements

• Bun 1.0 or newer
• Git
• zsh or bash for optional shell integration

Installation

npm install -g @ishakantony/wt-cli

After installation, the package exposes two binaries:

• wt: the user-facing command
• wt-bin: the underlying binary used by shell integration

Quick Start

Show the command reference:

wt

Create a new branch worktree:

wt new feature/my-change

List worktrees:

wt list
wt ls

Jump to a worktree path:

wt cd feature-my-change

Without shell integration, wt cd prints the path. With shell integration, it changes the current shell directory.

Shell Integration

Install shell integration for zsh or bash:

wt init

Then restart your shell or source your shell config. After shell integration is active, commands such as wt new, wt review, and wt cd can change your current directory.

Remove shell integration:

wt init --uninstall

Commands

wt new <branch>          create a branch worktree
wt review <branch>      create a detached review worktree
wt remove <name>        remove a worktree
wt rm <name>            alias for remove
wt list                 list worktrees
wt ls                   alias for list
wt cd <name>            print or jump to a worktree path
wt dir                  show worktree directory configuration
wt info                 show repository/worktree context
wt prune                prune stale worktree metadata
wt init                 install shell integration
wt help                 show command reference

Configuration

wt uses WT_DIR to choose where linked worktrees are created.

If WT_DIR is unset, it defaults to .., resolved relative to the Git repository root.

Example:

export WT_DIR="$HOME/worktrees"

Inspect the effective configuration:

wt dir
wt info

Development

Install dependencies:

bun install

Run tests:

bun test

Run typechecking:

bun run typecheck

Run the CLI from source:

bun run src/wt.ts

Preview the npm package contents:

npm pack --dry-run

License

MIT