wtree
| Crates.io | wtree |
| lib.rs | wtree |
| version | 0.1.0 |
| created_at | 2026-01-23 16:38:53.865379+00 |
| updated_at | 2026-01-23 16:38:53.865379+00 |
| description | Git worktree CLI |
| homepage | |
| repository | https://github.com/imqdee/wtree |
| max_upload_size | |
| id | 2064939 |
| size | 37,765 |
qdqqd (imqdee)
documentation
README
wtree
A CLI tool for managing git worktrees using a bare repository structure.
Git worktrees let you work on multiple branches simultaneously in separate directories. No stashing, no context switching, and all worktrees share the same git objects.
Installation
Cargo
cargo install wtree
From source
git clone https://github.com/imqdee/wtree.git
cd wtree
cargo build --release
cp target/release/wt ~/.local/bin/ # or anywhere in your PATH
Shell Setup
Add to your .bashrc or .zshrc:
# Bash
eval "$(wt init bash)"
# Zsh
eval "$(wt init zsh)"
This wraps the wt command so that switch (and the -s flag) automatically changes your directory to the target worktree.
Usage
| Command | Description |
|---|---|
wt clone <url> [-s] |
Clone repo as bare with default branch worktree |
wt create <name> [-b branch] [-s] |
Create new worktree (alias: c) |
wt switch <name> [-e] |
Switch to worktree (alias: sw) |
wt list |
List all worktrees (alias: ls) |
wt remove <name> |
Remove a worktree (alias: rm) |
Examples
# Clone a repository
wt clone git@github.com:user/repo.git
wt clone git@github.com:user/repo.git -s # clone and switch to default branch
# Create worktrees
wt create feature-auth # from current HEAD
wt create hotfix -b main # from specific branch
wt create feature-ui -s # create and switch to the branch
# Switch between worktrees
wt switch main
wt sw feature-auth -e # switch and copy .env files from origin to destination
# List and remove
wt ls
wt rm feature-auth
Flags
-s, --switch: After clone/create, switch to the new worktree-b, --branch <name>: Base branch for new worktree (create only)-e, --envs: Copy.env*files (except.env.example) when switching
Development
cargo build # debug build
cargo build --release # release build
cargo test # run tests
License
MIT