Bot do Telegram para Controle CLI do Código Claude via Celular

O Que É Isso

Um desenvolvedor criou um bot do Telegram gratuito e de código aberto que fornece acesso móvel aos comandos do CLI do Claude Code. Construído com TypeScript e o framework grammY, o projeto tem licença MIT e inclui 96 testes unitários.

Principais Recursos e Funcionalidades

O bot expõe todos os comandos de barra do Claude Code como comandos do Telegram, incluindo:

• /commit
• /code_review
• /simplify
• Outros comandos do Claude Code

Capacidades adicionais:

• Descobre automaticamente habilidades personalizadas de ~/.claude/skills/
• Processa fotos, documentos e notas de voz enviadas via Telegram
• Envia arquivos criados pelo Claude de volta para o chat
• Implementa fila de mensagens - múltiplas mensagens são processadas em ordem enquanto o Claude trabalha
• Detecta automaticamente bate-papo casual vs. trabalho de código, usando a flag --bare para perguntas simples (aproximadamente 10x mais barato)
• Suporta chats em grupo - equipes podem compartilhar uma sessão do Claude em um grupo do Telegram

Processo de Desenvolvimento

O projeto foi construído usando o próprio Claude Code com uma abordagem de desenvolvimento específica:

• 3 agentes paralelos trabalhando em worktrees git isolados
• Cada agente construiu uma parte não sobreposta do projeto
• Orquestrado a partir do branch principal, depois mesclado e conectado
• 4 ciclos de revisão identificaram e corrigiram vários problemas:
  • Um vazamento de clearInvocation
  • Um bug de dupla codificação de URL
  • 4 instâncias de lógica duplicada extraídas para um helper compartilhado (reduzindo o código em 148 linhas)

Caso de Uso

Esta ferramenta é para desenvolvedores que desejam executar o Claude Code de seus telefones sem precisar abrir um terminal, permitindo commits de código, revisões de PR e execução de habilidades personalizadas a partir de dispositivos móveis.