Worktrunk is a command-line interface (CLI) tool designed to streamline Git worktree management, specifically targeting parallel AI agent workflows. It simplifies the often cumbersome process of creating, switching between, and cleaning up multiple Git worktrees, making them as accessible as Git branches. This enables developers to efficiently manage numerous parallel tasks or agent instances without conflicts, significantly boosting productivity for complex development or AI-driven projects.

How It Works

Worktrunk acts as an abstraction layer over Git's native worktree functionality, providing a more intuitive and efficient user experience. Its core commands (wt switch, wt remove, wt list) automate path derivation and reduce the number of commands needed for common operations. This approach is advantageous for managing numerous parallel environments, as it minimizes the cognitive load and potential for error associated with manual Git worktree commands, directly addressing the challenge of scaling AI agents that require isolated working directories.

Quick Start & Requirements

• Installation:
  • macOS/Linux (Homebrew): brew install max-sixty/worktrunk/wt && wt config shell install
  • Via Cargo: cargo install worktrunk && wt config shell install
• Prerequisites: Shell integration is recommended for commands that change directories.
• Documentation: Full documentation is available at worktrunk.dev.

Highlighted Details

• Simplifies core Git worktree operations (switch, create, remove, list) into single commands.
• Features workflow automation via hooks (e.g., on create, pre/post-merge) and LLM-generated commit messages.
• Specifically designed to facilitate parallel AI agent workflows (e.g., Claude Code, Codex).
• Author is known for creating PRQL (10k stars) and maintaining Xarray (4k stars).

Maintenance & Community

The project is initiated by max-sixty, the creator of popular tools like PRQL and a maintainer for Xarray. Community engagement is encouraged through GitHub issues for feedback and feature requests. Links for sharing are provided via X, Reddit, and LinkedIn.

Licensing & Compatibility

• License: Not specified in the provided README.
• Compatibility: Designed for Git worktrees; shell integration requires compatible shells.

Limitations & Caveats

The project is newly released as open source, though described as the author's daily driver. Specific limitations or unsupported platforms are not detailed in the README. Its primary focus is on enhancing parallel AI agent workflows, which may influence its utility for developers not engaged in such specific use cases.