Overview

Worktrunk is a cutting-edge CLI tool revolutionizing Git worktree management, meticulously designed for the demanding needs of parallel AI agent workflows. It transforms the often-clunky Git worktree experience into one as seamless as managing branches, empowering developers to orchestrate numerous AI tasks concurrently with unparalleled ease and efficiency.

Key Features

• Effortless Worktree Management: Core commands (wt switch, wt list, wt remove) make creating, navigating, and cleaning up worktrees as intuitive as branch operations.
• Parallel AI Agent Ready: Built specifically to support running multiple AI agents (like Claude Code) in parallel, each with its dedicated isolated worktree.
• Streamlined Command Structure: Simplifies complex Git commands into single, easy-to-remember Worktrunk commands, dramatically reducing cognitive load.
• Powerful Automation & Hooks: Integrate custom workflows with pre-defined hooks (on create, pre-merge, post-merge, etc.) to automate local processes.
• Intelligent Commit Generation: Leverage LLMs for automated, context-aware commit message generation directly from diffs.
• Integrated Merge Workflow: A single command handles squashing, rebasing, merging, and cleanup, streamlining your feature completion process.
• Enhanced Visibility: wt list provides rich status information, including CI status, AI-generated summaries, and local changes at a glance.
• Optimized Build Caching: Efficiently share build caches (like target/, node_modules/) across multiple worktrees, saving significant build time.
• PR & MR Integration: Seamlessly checkout pull and merge requests directly using wt switch pr:123.

Typical Use Cases

Worktrunk is the ideal solution for:

• AI Agent Orchestration: Running multiple AI development agents concurrently, each working on a distinct task or feature in its own isolated environment.
• Rapid Feature Development: Quickly spinning up worktrees for new features, experimenting with changes, and easily switching between them.
• Complex Branching Strategies: Managing a large number of parallel tasks or experiments without the overhead of traditional Git branch management.
• Automated Development Workflows: Integrating hooks to automatically set up development environments, run linters, or start servers when a worktree is created or switched to.
• Streamlined Code Review: Using wt list to quickly assess the status of all active development branches and their associated changes.