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"  } }