worktrunk

Manage git worktrees and agent workflows with Worktrunk CLI.

5|Updated Apr 29, 2023
One-click install
npx skills add https://github.com/n4vysh/dotfiles --skill worktrunk-n4vysh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktrunk
Source: https://github.com/n4vysh/dotfiles/tree/main/home/dot_agents/skills/worktrunk
Command: npx skills add https://github.com/n4vysh/dotfiles --skill worktrunk-n4vysh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Worktrunk users need a cohesive way to manage multiple git worktrees and parallel AI agent interactions across branches, contexts, and hooks.

Core Features & Use Cases

  • Orchestrates creation, switching, and cleanup of multiple worktrees with consistent naming and lifecycle hooks.
  • Coordinates agent sessions (like Claude Code/OpenCode) across isolated worktrees to prevent cross-talk and conflicts.
  • Provides templates, per-branch variables, and automated workflows for glue code, CI, and deployment tasks.

Quick Start

Run wt switch --create feature-auth to create a new feature worktree and automatically run configured hooks and post-start tasks.

Frequently Asked Questions about worktrunk

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage multiple git worktrees for parallel AI agent workflows?

Coordinate AI agents across isolated git worktrees by applying lifecycle hooks and per-branch variables, ensuring parallel LLM-driven tasks in Claude Code or OpenCode do not experience cross-talk or context conflicts.

How do I create a new worktree and automatically run hooks for a feature branch?

Run wt switch --create feature-branch to create a new worktree and automatically execute configured user and project hooks, templates, and post-start tasks for immediate development.

Do I need the Worktrunk CLI installed to automate git worktree workflows?

Yes, automating git worktree workflows requires the Worktrunk CLI installed and configured to support templates, per-branch variables, and built-in safety checks during branch operations.

Can I use templates and per-branch variables for CI and deployment tasks in git worktrees?

Yes, you can use templates and per-branch variables within git worktrees to automate glue code, CI, and deployment tasks, providing consistent automated workflows across isolated branch environments.

What are the limitations when coordinating hooks and LLM-driven tasks across git worktrees?

Limitations include potential workflow troubleshooting needs when coordinating hooks and LLM-driven tasks, though built-in safety checks help mitigate risks during worktree creation, switching, and cleanup operations.