trail-boss

Trail Boss is a single-pane attention router for developers who run multiple interactive AI coding CLI sessions in parallel tmux panes. Instead of cycling through windows to find the session that needs input, it maintains a FIFO queue of stalled sessions and lets you jump to the head with a keystroke. The main detection path is Claude Code hooks: Stop and PermissionRequest events enqueue a session, and UserPromptSubmit or transcript advancement dequeues it. The hook emitter script sends events with the current TMUX_PANE ID to a Bun + SQLite daemon on localhost:4000. A fallback tmux detector polls opted-in panes for quiet periods and prompt patterns, allowing use with coding tools that lack hooks; it requires a @tb- title prefix and uses configurable poll interval and quiet threshold. The user interface is a Go Bubble Tea TUI with a split queue and detail view, auto-refresh, skip cooldown, and a live tmux capture-pane preview. Shell helpers provide tmux keybindings for jumping to the next stuck session, skipping, opening a picker popup, and returning to the dashboard. A status-bar segment shows the stuck count. By default it does not steal focus automatically; TRAILBOSS_AUTO_JUMP=1 enables auto-advance after resolving a session. It is not a fleet spawner and does not launch or relay input to agents. It routes attention to the live session, where the user interacts directly. Requirements include Bun, tmux, Claude Code with hooks for primary detection, and Go 1.24+ to build the TUI. The README states phases 1-9 are complete, with hook detection, tmux fallback, FIFO ordering, skip cooldown, reconcile, and self-healing registry working, and licensed MIT.