wtt - Work Tree Tool

Status: Pre-1.0 - exists to serve mbj/mrs monorepo, expect breaking changes without notice.

Overview

CLI tool for managing git worktrees using bare clones.

Installation

From a repository checkout:

cargo install --path wtt

Paths

Branch names containing / become subdirectories (e.g., feature/login → ~/devel/myrepo/feature/login/).

Configuration

Configuration is loaded from ~/.config/wtt.toml by default. All fields are optional.

bare_clone_dir = "/path/to/bare/clones"
worktree_dir = "/path/to/worktrees"

CLI Flags

Commands

setup

Create bare clone and prepare worktree directory.

wtt setup <URL> [--repo <REPO>]

• <URL> - Git remote URL to clone
• --repo <REPO> - Optional: Local name for the repository (defaults to repo name extracted from URL)
• Clones bare repo to ~/.local/share/wtt/bare/<repo>.git
• Creates empty ~/devel/<repo>/ directory

Examples:

# Auto-extract repo name from URL (will use 'my-repo')
wtt setup git@github.com:user/my-repo.git

# Specify custom repo name
wtt setup git@github.com:user/my-repo.git --repo custom-name

teardown

Remove a repository completely (inverse of setup).

wtt teardown [OPTIONS] <REPO>

• <REPO> - Repository name to remove
• --force - Force removal of worktrees with uncommitted changes
• Removes all worktrees
• Removes bare clone at ~/.local/share/wtt/bare/<repo>.git
• Removes worktree directory at ~/devel/<repo>/

add

Create a worktree.

wtt add [OPTIONS] <BRANCH>

• <BRANCH> - Branch name for the new worktree
• --base <BASE> - Base ref for new branches (default: remote default branch)
• --repo <REPO> - Repository name (default: auto-detected from current directory)
• Auto-detects existing vs new branch:
  • If branch exists (local/remote): checkout
  • If branch doesn't exist: create from base
• Configures upstream tracking to origin/<branch> via git config, so git push and git pull work without additional flags, even for new branches that don't exist on the remote yet

list

List worktrees.

wtt list [OPTIONS]

• --repo <REPO> - Repository name (default: auto-detected, or list all if outside worktree)

remove

Remove a worktree.

wtt remove [OPTIONS] <BRANCH>

• <BRANCH> - Branch name of the worktree to remove
• --repo <REPO> - Repository name (default: auto-detected from current directory)
• Deletes worktree directory only, does not delete the branch