Worktree Sh

worktree.sh

Zero-friction git worktree manager for parallel feature development.

中文 • 日本語

What is worktree.sh?

worktree.sh automates the tedious setup of git worktrees. With a single command, it creates isolated development sandboxes for coding agents like Codex and Claude Code—complete with branches, environment files, dependencies, and running dev servers. No context pollution.

Perfect For

- AI-Powered Development — Isolated sandboxes for Codex and Claude Code
- Parallel Development — Multiple features without branch switching
- Quick Experiments — Safe disposable environments
- Code Reviews — Review PRs without interrupting main work

Quick Look

Quick Start

Install

Basic Workflow

Core Features

- One-Command Setup — wt add 3000 creates worktree, branch, copies env files, installs deps, and starts dev server on port 3000
- Instant Navigation — Jump between worktrees with wt 3000 or wt main, no path memorization needed
- Smart Syncing — Propagate staged changes from main to multiple worktrees with wt sync all
- Safe Cleanup — Remove worktrees and branches together with wt rm, batch-clean with wt clean
- Fully Configurable — Control branch prefixes, auto-install, dev server behavior per project

Commands

Core Commands

Synchronization

Cleanup

Configuration

Advanced Features

Broadcasting Changes Across Worktrees

Propagate uncommitted changes from main to multiple feature branches simultaneously:
Note: Target worktrees must have clean status

Custom Configuration

Configuration is stored per-project in ~/.worktree.sh/projects//config.kv.

Use Cases

Multiple UI Iterations

Parallel Code Reviews

Concurrent Feature Development

Installation Details

What Gets Installed

- Binary: ~/.local/bin/wt
- Config: ~/.worktree.sh/
- Shell hooks: Added to ~/.bashrc…