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↕  Remote⇅  Path                 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 --format=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 🌔 65%

When Claude Code provides context window usage via stdin JSON, a moon phase gauge appears (🌕→🌑 as context fills).

Add to ~/.claude/settings.json:

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