Worktrunk

Features

• Simplified git worktree management (add, switch, remove)
• Automated workflow execution via hooks (pre-start, post-merge, etc.)
• LLM-generated commit messages
• Integration with AI agents for parallel task execution
• Configuration management for user and project-specific settings

Use Cases

• Managing multiple parallel development tasks or AI agent worktrees
• Automating project setup and quality checks with Git hooks
• Generating commit messages using AI
• Switching between different branches and worktrees efficiently

Non-Goals

• Directly managing Git repositories themselves (focus is on worktrees)
• Replacing core Git functionality (enhances it)
• Handling CI/CD pipeline orchestration (focuses on local development workflows)

Workflow

1. Detect user intent for worktree management or configuration.
2. Determine whether user config or project config is relevant.
3. Execute `wt` commands for switching, creating, listing, or removing worktrees.
4. Apply or suggest hooks for project-specific automation.
5. Generate commit messages using LLM integration when requested.
6. Provide guidance or execute troubleshooting steps based on `wt` output.

Practices

• Git workflow automation
• Developer productivity
• Configuration management

Prerequisites

• Git CLI
• Worktrunk CLI installed
• Optional: LLM tools (e.g., Claude Code) for commit generation