Pitch: construí um app de macOS que acha o espaço livre da tela para acompanhar agentes de código

Trabalho com várias sessões de Claude Code e Codex abertas ao mesmo tempo, em mais de um monitor. Com o tempo, o gargalo deixou de ser o código: virou descobrir qual sessão está parada esperando uma resposta minha. Já perdi 20 minutos com um agente travado num pedido de permissão enquanto eu olhava outra janela.

Fiz o Sidelong para resolver isso. Ele é um app nativo para macOS que mostra o estado de cada agente, leva para o terminal certo com um clique e deixa responder pedidos sem trocar de janela. Quero contar três partes que foram mais difíceis do que pareciam.

1. Saber o estado de cada agente sem adivinhar

O Claude Code e o Codex têm hooks: comandos que eles executam em eventos como "vou rodar uma ferramenta", "preciso de permissão" ou "terminei a vez". O Sidelong instala hooks que avisam um servidor local no próprio Mac. Ele só faz isso depois que você autoriza na janela de boas-vindas, e antes da primeira escrita faz backup do arquivo de configuração.

Com isso, cada sessão tem um estado confiável: trabalhando, esperando, terminou, interrompida ou falhou. O pedido de permissão pode ficar "segurado" até você responder por um cartão na tela, sem ir ao terminal.

Uma pegadinha que só apareceu testando ao vivo: quando você responde no próprio terminal, o hook não termina. Então o app observa se o comando aprovado apareceu como processo filho do agente e, quando aparece, libera o pedido.

2. Voltar para a aba exata

"Abrir o terminal" não adianta quando você tem 12 abas na mesma pasta. O Sidelong usa as URLs de sessão do Warp, os IDs de terminal do Maestri e os handles do Orca para abrir exatamente a aba daquela sessão, mesmo quando as pastas se repetem ou as abas mudam de lugar.

3. Não cobrir o trabalho

Widget fixo num canto sempre acaba em cima de algo. O Sidelong lê a posição das janelas pela API de acessibilidade do macOS, calcula as regiões livres de cada monitor e se coloca ali. Quando o layout muda, ele muda junto.

Algumas coisas físicas em que gastei mais tempo do que deveria:

• solte uma bolha sobre outra na borda da tela e elas viram uma cápsula; no canto, viram anéis
• arremesse uma bolha e ela desliza com inércia, como uma rolagem
• arraste para o notch e ela vira uma faixa preta ao lado da câmera, porque o recorte é preto; passando o mouse, ela mostra CPU, memória e os detalhes

O que mais ele mostra

• Os limites de uso do Claude, do Codex e do Antigravity lado a lado, com o horário de reset de cada janela
• PRs do GitHub com CI, e merge em dois cliques quando o PR está limpo
• As portas locais abertas, com a sessão de agente que abriu cada uma, o log ao vivo e um botão para parar o servidor

Detalhes técnicos

• Swift 6.2 nativo, sem dependências externas; macOS 14+ em Apple Silicon
• Sem conta e sem telemetria. As únicas chamadas de rede são para o endpoint de uso da Anthropic (com o token que o Claude Code já tem), para o GitHub pelo gh que você já logou e para checar atualizações
• Em Macs compatíveis, a Apple Intelligence resume pedidos de permissão e falhas de CI no próprio dispositivo

Preço

O download é gratuito, e o gratuito já acompanha tudo: sessões, limites de uso, salto para a aba certa, CPU e memória. O Pro custa US$ 15 em pagamento único (vale para até 3 Macs) e destrava as ações: responder permissões pela tela, PRs com merge e portas locais com Stop. Os 3 primeiros dias vêm com o Pro liberado.

Link: Sidelong

---

Estou atrás de feedback de verdade: o que quebrou, que agente ou terminal você usa e ele ainda não lê, e o que faria você pagar ou não pagar. Respondo tudo por aqui.