max-sixty/worktrunk

What it solves

Worktrunk simplifies the management of git worktrees, which are separate working directories for different branches. This is particularly useful for running multiple AI agents (like Claude Code or Codex) in parallel, as it prevents agents from interfering with each other's changes while removing the clunky UX of native git worktree commands.

How it works

It provides a CLI that treats worktrees as easily as branches. It uses a configurable template to compute paths based on branch names, allowing users to switch between worktrees, create new ones, and clean them up using simplified commands. It also integrates with the shell to allow commands to change directories automatically.

Who it’s for

Developers and AI agent users who need to manage multiple parallel streams of work or multiple AI agents operating on the same repository simultaneously.

Highlights

• Simplified Core Commands: Replaces complex git worktree commands with intuitive actions like wt switch, wt list, and wt merge.
• AI Integration: Specifically designed for parallel AI agents with the -x flag to launch agents immediately after switching worktrees.
• LLM-Powered Features: Includes AI-generated commit messages and branch summaries.
• Workflow Automation: Supports hooks for automating setup (e.g., installing dependencies) and a merge workflow that combines squashing, rebasing, and cleanup.
• Efficient Storage: Uses copy-on-write build caches to share node_modules or target/ folders across multiple worktrees on supported filesystems (APFS, btrfs, XFS).
• Interactive Picker: A visual browser for worktrees with streaming CI status and diff previews.