worktrunk

Configure Worktrunk user and project settings across macOS/Linux and Windows.

6.4k|231|Updated Oct 17, 2025
One-click install
npx skills add https://github.com/max-sixty/worktrunk --skill worktrunk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktrunk
Source: https://github.com/max-sixty/worktrunk/tree/main/.claude-plugin/skills/worktrunk
Command: npx skills add https://github.com/max-sixty/worktrunk --skill worktrunk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill provides authoritative guidance for configuring and troubleshooting Worktrunk, a CLI for git worktree management. It covers user configuration (located at ~/.config/worktrunk/config.toml) and project configuration (.config/wt.toml), usage patterns, and common troubleshooting steps.

Core Features & Use Cases

  • Configuration guidance for user and project scopes, including how to locate and modify config files.
  • Troubleshooting help for shell integration, hooks, and LLM commit workflows.
  • Operational workflows to start and manage worktrees, switch contexts, and observe status across multiple worktrees.

Quick Start

Quick-start guidance: Read the included reference docs, view current configuration with wt config show, and experiment with wt switch to create or switch worktrees.

Frequently Asked Questions about worktrunk

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

FAQPage Schema
How do I configure git worktree management settings for user and project scopes?

To configure git worktree management, modify the user configuration file at `~/.config/worktrunk/config.toml` or the project configuration at `.config/wt.toml` to set your preferences. Use `wt config show` to view current settings across scopes.

Why is my shell integration not working with the worktree CLI?

Shell integration issues with the worktree CLI often stem from misconfigured hooks or environment variables. Troubleshoot by verifying your shell integration setup and checking the hook configurations defined in your project's `.config/wt.toml` file.

What is the best way to switch contexts between multiple git worktrees?

The best way to switch contexts between multiple git worktrees is using the `wt switch` command. This operational workflow allows you to quickly create or switch to an existing worktree, helping you observe status across multiple contexts.

Does the worktree CLI support LLM commit workflows and hooks?

Yes, the worktree CLI supports LLM commit workflows and hooks. You can configure and troubleshoot these workflows by adjusting your project configuration settings, ensuring hooks execute properly during your daily usage and commit processes.

Can I use worktree configuration files across macOS, Linux, and Windows environments?

Yes, you can use worktree configuration files across macOS, Linux, and Windows environments. The CLI provides authoritative guidance for onboarding, daily usage, and troubleshooting to ensure consistent setup and operation across these different operating systems.