Opinionated CLI for managing git worktrees — keeps all worktrees as siblings in one folder.
Standard git worktree creates worktrees scattered across the filesystem.
Tools like Vercel CLI fail with ENOTDIR error on bare repository worktrees.
Sibling layout — all worktrees in one folder, side by side:
my-repo.worktree/ ← Worktree home
├── main/ ← Main branch (regular clone with .git/ directory)
│ └── .git/
└── feature-xyz/ ← Feature worktree (sibling)
└── .git (file)
git clone [email protected]:j2h4u/wts.git ~/.local/share/wts
cd ~/.local/share/wts
bun install
bun linkwts clone <url> [dir] # Clone repo with worktrees as siblings
wts new <branch> [dir] # Create feature worktree
wts done <dir> # Remove worktree and branch
wts list # Show all worktrees- Specification — Full design and architectural details.
- Testing Guide — Information on E2E testing with Docker.
- Changelog — History of changes.
- AI Instructions — Guidelines for AI assistants working on this repo.
- OpenSpec Reference — Detailed OpenSpec workflow and CLI guide.
- Legacy Prototypes — Original bash scripts (deprecated).
wts = Worktree Siblings + TypeScript
MIT