Roost: Uma barra lateral em Go binário para Claude Code com histórico de prompts clicável, árvore de arquivos e notificações

Um desenvolvedor criou o Roost para preencher três lacunas ao usar o Claude Code via SSH com tmux: histórico de prompts clicável, uma árvore de arquivos para reduzir o uso de cat em arquivos e notificações push quando Claude está esperando. É um único binário Go que serve uma interface web em 127.0.0.1:8080, projetado para tunelamento SSH.

Principais Recursos

• Terminal xterm.js com suporte a tmux: Sobrevive a desconexões WebSocket, suspensão e reinicializações do servidor. Cada sessão é tmux new-session -A -s {id}.
• Árvore de arquivos: Visualize arquivos, arraste e solte para upload, e segue automaticamente seu diretório atual lendo o pane_current_path do tmux — sem necessidade de integração com shell.
• Painel de atividade: Lê ~/.claude/projects/*.jsonl e mostra cada prompt. Clique em um prompt → o terminal volta para aquela etapa.
• Chips na barra superior: Exibem o modelo ativo e os tokens de contexto mais recentes.
• Notificações push: Usa o hook Stop do Claude Code para notificar seu laptop quando Claude fica ocioso, mesmo com a aba em segundo plano.

Decisões de Design

• tmux como camada de durabilidade: O shell sobrevive a desconexões e reinicializações porque o tmux gerencia a persistência da sessão. O Roost possui apenas uma ponte WebSocket e um log em disco somente para anexação.
• Único usuário por instância: Sem contas ou RBAC. Duas pessoas compartilhando um host executam roost serve em portas diferentes. UIDs UNIX cuidam do isolamento; proxies reversos cuidam da autenticação multi-inquilino.
• Vanilla JS, sem etapa de build: O frontend consiste em arquivos <script> simples embutidos via //go:embed all:web. Sem bundler — mais fácil de depurar e distribuir.

Correção de Bug Notável

O comando display-message -p '#{x}\x1f#{y}' do tmux retorna 0x1f como um underscore literal quando iniciado sem locale UTF-8 (por exemplo, a partir de unidades systemd). A correção de uma linha: tmux -u. Se você canalizar o tmux por separadores de campo, fixe o locale.

Compatibilidade

Validado em servidor Linux + Chrome Windows via túnel SSH. macOS como servidor funciona, mas possui arestas. Sessões Codex funcionam se você trocar os agentes. Repositório: github.com/liamsysmind/roost. Tarballs v0.1.0 em github.com/liamsysmind/roost/releases/tag/v0.1.0.