Controlando Agentes de IA pelo Messenger com botmux
Imagine um cenário familiar. Você iniciou uma refatoração pesada com Claude Code ou Codex na sua estação de trabalho, depois foi tomar um chá ou foi para casa. Cinco minutos depois, o CLI congela, esperando confirmação para excluir um arquivo. Você está sentado no transporte público com seu smartphone, e o processo está travado.
Para quem usa ativamente assistentes de IA de console, o desenvolvedor deepcoldy criou o utilitário botmux. Ele transforma o messenger Feishu (conhecido como Lark fora da China) em um painel de controle para duas dezenas de agentes de console.
Qual é a Ideia Central do Projeto
A maioria das plataformas para integrar IA em chats segue um caminho complexo. Os desenvolvedores pegam o SDK do modelo necessário, constroem um wrapper em cima, reimplementam chamadas de função, memória e manipulação de arquivos. O resultado é uma versão reduzida de um verdadeiro agente de console.
botmux adota uma abordagem diferente. A ferramenta não tenta ser um agente de IA ou gerenciar contexto através do próprio código. Em vez disso, um serviço em segundo plano inicia um processo completo do utilitário de console no seu servidor ou estação de trabalho. Cada novo tópico ou diálogo no chat cria uma sessão separada, com as saídas transmitidas para o messenger como cards interativos.
Essa arquitetura oferece um bom benefício. Quando os desenvolvedores do Claude Code, Codex, Gemini CLI ou Cursor lançam atualizações com novos comandos ou suporte a servidor MCP, o botmux não precisa ser reescrito. Você trabalha com o aplicativo de console original com todos os seus recursos intactos.
Quatro Funcionalidades Interessantes
Abaixo estão detalhes sobre como o trabalho com agentes no chat é estruturado.
Cards em Streaming e Transferência de Controle
A saída do CLI é transmitida diretamente para a mensagem do messenger. Você vê texto em atualização e pode controlar o processo através de botões nos cards. Visualizar capturas de tela do terminal, recolher logs longos e reiniciar uma sessão travada estão todos disponíveis.
Se os botões interativos não forem suficientes, o botmux fornece um link para terminal web. Você pode trabalhar diretamente do seu smartphone, com um teclado especial exibido na tela com botões Esc, Ctrl+C e setas de navegação.
Trabalho em Equipe Multi-Modelo
Você pode adicionar múltiplos bots vinculados a diferentes utilitários de console em um único chat em grupo. Por exemplo, conecte um bot ao Claude Code e outro ao Codex.
Quando você menciona um bot via @, a mensagem vai para aquele agente específico. Isso é útil para revisão cruzada de código. Você pode pedir a dois modelos diferentes para analisar o mesmo pull request, e eles começarão a debater entre si na própria thread de discussão.
Migração de Sessões Entre Dispositivos
Suponha que você iniciou uma sessão localmente no familiar tmux. Usando o comando /adopt no chat, você pode assumir o controle dessa sessão diretamente do seu celular.
Se uma discussão de tarefa se estendeu demais e precisa ser compartilhada com toda a equipe, o comando /relay transfere todo o processo junto com a memória acumulada e o contexto para o chat em grupo compartilhado.
Automação e Triggers Externos
O utilitário suporta agendamento e webhooks. Você pode configurar análise periódica de alertas ou geração de relatórios agendados descrevendo a tarefa em linguagem simples. Sistemas externos podem acionar agentes através de requisições HTTP padrão.
Como Funciona Por Dentro
O projeto é escrito em TypeScript e roda no Node.js versão 22 ou mais recente. Ele usa uma arquitetura de adaptadores internamente para suportar diferentes CLIs:
claude-codecodexgeminicursoropencodecopilot
Utilitários locais são executados com isolamento de processo. Você sempre pode se conectar a um agente em execução diretamente via tmux attach se estiver na estação de trabalho.
Instalação e configuração inicial são simplificadas ao mínimo:
npm install -g botmux
botmux setup
botmux start
O assistente interativo botmux setup ajuda a vincular sua conta Feishu via código QR, configura automaticamente as permissões do aplicativo no painel empresarial e inicia a configuração básica.
Vale a Pena Experimentar
O projeto conquistou quase 900 estrelas no GitHub, e não sem motivo. O código é bem estruturado, e a ideia de usar um CLI genuíno em vez de escrever outro SDK parece sensata.
A principal desvantagem do utilitário é seu acoplamento rígido ao messenger Feishu/Lark. Se sua equipe usa Slack ou Telegram, você não poderá usar a ferramenta pronta. Você precisará escrever sua própria ponte ou portar os adaptadores do repositório.
No entanto, se você trabalha no Lark e usa ativamente agentes de IA de terminal, o botmux libera você da necessidade de ficar constantemente sentado em frente a um monitor. Confira o repositório do projeto no GitHub para explorar a lista de adaptadores suportados ou ver soluções arquiteturais.
Projetos relacionados