# Worktrunk

> Use this skill when the user wants to manage Git worktrees, switch between parallel branches, or work with multiple worktrees.

- Skill: `javimosch/worktrunk` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/worktrunk`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/worktrunk/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: javimosch (https://skillmd.com/u/javimosch)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/javimosch/worktrunk

---


# worktrunk Plugin

CLI for Git worktree management, designed for parallel AI agent workflows.

## Commands

### Branch
- `worktrunk branch switch` — Switch to a worktree branch
- `worktrunk branch create` — Create and switch to a new worktree branch
- `worktrunk branch list` — List all worktree branches
- `worktrunk branch remove` — Remove a worktree branch

## Usage Examples
- "Switch to a different worktree branch"
- "Create a new worktree for a feature branch"
- "List all my worktrees"
- "Remove a worktree I no longer need"

## Installation

```bash
cargo install worktrunk
wt config shell install
```

## Examples

```bash
# Switch to existing branch
wt switch feature-branch

# Create and switch to new branch
wt switch -c new-feature

# Create with external tool execution
wt switch -c -x claude new-feature

# List all worktrees
wt list

# Remove current worktree
wt remove

# Remove specific worktree
wt remove old-branch

# Checkout PR
wt switch pr:123
```

## Key Features
- Branch-name based worktree addressing
- Automatic path computation
- Hooks for workflow automation
- LLM commit message generation
- PR checkout support
- Build cache sharing between worktrees