Claude Code Integration

The worktrunk Claude Code plugin provides two features:

1. Configuration skill — Documentation Claude Code can read, so it can help set up LLM commits, hooks, and troubleshoot issues
2. Activity tracking — Status markers in wt list showing which worktrees have active Claude sessions (🤖 working, 💬 waiting)

Installation

$ claude plugin marketplace add max-sixty/worktrunk
$ claude plugin install worktrunk@worktrunk

Configuration skill

The plugin includes a skill — documentation that Claude Code can read — covering worktrunk's configuration system. After installation, Claude Code can help with:

• Setting up LLM-generated commit messages
• Adding project hooks (post-create, pre-merge, pre-commit)
• Configuring worktree path templates
• Fixing shell integration issues

Claude Code is designed to load the skill automatically when it detects worktrunk-related questions.

Activity tracking

The plugin tracks Claude sessions with status markers in wt list:

$ wt list
  Branch       Status        HEAD±    main↕  Path                 Remote⇅  Commit    Age   Message
@ main             ^⇡                        .                     ⇡1      33323bc1  1d    Initial commit
+ feature-api      ↑ 🤖              ↑1      ../repo.feature-api           70343f03  1d    Add REST API endpoints
+ review-ui      ? ↑ 💬              ↑1      ../repo.review-ui             a585d6ed  1d    Add dashboard component
+ wip-docs       ? –                         ../repo.wip-docs              33323bc1  1d    Initial commit

○ Showing 4 worktrees, 2 with changes, 2 ahead

• 🤖 — Claude is working
• 💬 — Claude is waiting for input

Manual status markers

Set status markers manually for any workflow:

$ wt config state marker set "🚧"                   # Current branch
$ wt config state marker set "✅" --branch feature  # Specific branch
$ git config worktrunk.state.feature.marker '{"marker":"💬","set_at":0}'  # Direct

Statusline

wt list statusline --claude-code outputs a single-line status for the Claude Code statusline. This may fetch CI status from the network when the cache is stale (often ~1–2 seconds), making it suitable for async statuslines but too slow for synchronous shell prompts. If a faster version would be helpful, please open an issue.

~/w/myproject.feature-auth !🤖 @+42 -8 ↑3 ⇡1 ● | Opus

Add to ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "wt list statusline --claude-code"
  }
}