Claude Code Integration

Worktrunk includes a Claude Code plugin that automatically tracks which worktrees have active Claude sessions. When Claude starts working in a worktree, the plugin sets a status marker; when Claude waits for input, the marker updates. This makes it easy to monitor multiple parallel agents from wt list.

Status tracking

The plugin adds status indicators to wt list:

$ wt list
  Branch       Status        HEAD±    main↕  Path                 Remote⇅  Commit    Age   Message
@ main             ^                         .                             a058e792  1d    Initial commit
+ feature-api      ↑ 🤖              ↑1      ../repo.feature-api           95e48b49  1d    Add REST API endpoints
+ review-ui      ? ↑ 💬              ↑1      ../repo.review-ui             46b6a187  1d    Add dashboard component
+ wip-docs       ? –                         ../repo.wip-docs              a058e792  1d    Initial commit

○ Showing 4 worktrees, 2 with changes, 2 ahead

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

Installation

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

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