Dashboard: Agent done / needs attention indicator on worktree cards #348

New issue

Open

opened 2026-04-15 08:43:43 +00:00 by mprihoda · 0 comments

mprihoda commented

2026-04-15 08:43:43 +00:00

(Migrated from github.com)

Layer: 1 — Fix the Annoying Stuff
Parent: #343

Problem

When managing 9-10 concurrent worktrees, the most important signal is: "which worktree needs my attention right now?" Currently there's no clear indicator of whether an agent has finished working and is waiting for human input.

Solution

Detect "agent done" state — determine the mechanism for detecting that a Claude Code session has stopped (process exit, tmux pane idle, or a signal in review-state/filesystem)
Show a clear visual indicator on the worktree card — binary state: "agent working" vs "needs you"
This should be the most prominent visual element on the card — a quick glance at the dashboard should immediately show which worktrees need attention

Open questions

What's the best detection mechanism? Options:
- Check if the tmux pane's process (claude) is still running
- Watch for review-state.json changes (agent updates it when done)
- Poll the Claude session via claude-code-query
- Filesystem watcher on the worktree directory for activity
Should we distinguish between "agent finished successfully" and "agent hit an error"?

**Layer:** 1 — Fix the Annoying Stuff **Parent:** #343 ## Problem When managing 9-10 concurrent worktrees, the most important signal is: "which worktree needs my attention right now?" Currently there's no clear indicator of whether an agent has finished working and is waiting for human input. ## Solution 1. **Detect "agent done" state** — determine the mechanism for detecting that a Claude Code session has stopped (process exit, tmux pane idle, or a signal in review-state/filesystem) 2. **Show a clear visual indicator** on the worktree card — binary state: "agent working" vs "needs you" 3. This should be the most prominent visual element on the card — a quick glance at the dashboard should immediately show which worktrees need attention ## Open questions - What's the best detection mechanism? Options: - Check if the tmux pane's process (claude) is still running - Watch for review-state.json changes (agent updates it when done) - Poll the Claude session via claude-code-query - Filesystem watcher on the worktree directory for activity - Should we distinguish between "agent finished successfully" and "agent hit an error"?