Worktrunk
Plugin Verified ActiveWorktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows. This plugin provides configuration guidance (LLM commit messages, project hooks, worktree paths) and automatic activity tracking (🤖/💬 indicators in `wt list` showing active Claude sessions).
To streamline and enhance the management of Git worktrees, making them as easy to use as branches, specifically for enabling parallel AI agent workflows.
Features
- Parallel AI agent workflow support via worktrees
- Simplified worktree creation, switching, and removal commands
- Automated workflows with project hooks
- LLM-generated commit messages
- Activity tracking and status indicators in worktree listings
Use Cases
- Running multiple AI agents in parallel, each in its own isolated worktree.
- Quickly creating and switching between feature branches and their corresponding worktrees.
- Automating project-specific setup and quality checks using worktree hooks.
- Generating commit messages with AI assistance for better code tracking.
Non-Goals
- Replacing core Git functionality; it enhances the worktree experience.
- Managing AI agent execution itself; it focuses on the environment (worktrees) for agents.
- General-purpose file management or version control outside of Git worktrees.
Practices
- Workflow automation
- Code quality
- AI integration
- Git workflow enhancement
Prerequisites
- The `wt` CLI must be installed.
- Git must be installed.
- Requires the `WorktreeCreate` hook for the `wt-switch-create` skill.
Documentation
- info:Configuration & parameter referenceThe README and SKILL.md files provide good documentation for configuration options and parameters, but explicit precedence order for config files could be clearer.
Invocation
- info:Name collisionsThe plugin's main command `wt` is documented as potentially conflicting with Windows Terminal's default alias, advising a workaround (`git-wt`).
Installation
First, add the marketplace
/plugin marketplace add max-sixty/worktrunk/plugin install worktrunk@worktrunkContains 2 extensions
Skill (2)
Guidance for Worktrunk (the `wt` CLI) — git worktree management, hooks, and config. Load when editing .config/wt.toml or ~/.config/worktrunk/config.toml; adding, modifying, or debugging hooks (post-merge, post-start, pre-commit, pre-merge, post-switch, etc.); configuring commit message generation or command aliases; or troubleshooting wt behavior. Also answers general worktrunk/wt questions.
Create a new worktrunk worktree (optionally in another repo) and switch this session's working directory into it. Use when launching a session that should work in its own worktree (e.g. `/wt-switch-create my-branch -- <task>`, or `/wt-switch-create my-branch ~/workspace/other-repo -- <task>`), or mid-session to move work into a fresh branch.