Sobre o projeto

Trail Boss é um roteador de atenção de painel único para desenvolvedores que executam múltiplas sessões interativas de CLI de codificação AI em paralelo em painéis tmux. Em vez de alternar entre janelas para encontrar a sessão que precisa de entrada, ele mantém uma fila FIFO de sessões interrompidas e permite que você salte para o início com uma tecla. O caminho principal de detecção são os hooks do Claude Code: eventos Stop e PermissionRequest enfileiram uma sessão, e UserPromptSubmit ou o avanço da transcrição a desenfileiram. O script emissor de hooks envia eventos com o ID TMUX_PANE atual para um daemon Bun + SQLite em localhost:4000. Um detector tmux de fallback monitora painéis opt-in em busca de períodos de silêncio e padrões de prompt, permitindo o uso com ferramentas de codificação que não possuem hooks; isso requer um prefixo de título @tb- e utiliza intervalo de sondagem e limite de silêncio configuráveis. A interface do usuário é uma TUI Go Bubble Tea com uma fila dividida e visualização de detalhes, atualização automática, cooldown de salto e uma prévia ao vivo do tmux capture-pane. Auxiliares de shell fornecem atalhos de teclado do tmux para saltar para a próxima sessão travada, pular, abrir um popup de seleção e retornar ao painel de controle. Um segmento da barra de status mostra a contagem de sessões travadas. Por padrão, ele não rouba o foco automaticamente; TRAILBOSS_AUTO_JUMP=1 habilita o avanço automático após a resolução de uma sessão. Ele não é um disparador de frota e não inicia nem retransmite entradas para agentes. Ele roteia a atenção para a sessão ativa, onde o usuário interage diretamente. Os requisitos incluem Bun, tmux, Claude Code com hooks para detecção primária e Go 1.24+ para construir a TUI. O README afirma que as fases 1-9 estão concluídas, com detecção de hooks, fallback do tmux, ordenação FIFO, cooldown de salto, reconciliação e registro de autocorreção funcionando, sob licença MIT.