Documentação

Comece por aqui#

Instalar com um agente#

Esta página é para um agente de programação com IA (o Claude Code, ou qualquer agente com shell) a quem pediram para instalar e configurar o aipager para a pessoa dele. Siga passo a passo. Todos os comandos daqui rodam sem perguntas e nunca precisam de um terminal interativo.

Referência#

Arquitetura#

O aipager é um programa asyncio de um processo só que roda em segundo plano. Ele liga três mundos: o seu chat do Telegram, os processos do Claude Code que você roda sob o dtach, e o sistema de hooks do Claude Code. Tudo passa por um único event loop: sem pools de workers, sem banco de dados, sem filas entre processos.

Eventos de hook#

O Claude Code roda comandos de hook em momentos fixos de uma tarefa: uma mensagem é enviada, uma ferramenta está para rodar, uma ferramenta terminou, a tarefa terminou, e assim por diante. O aipager se conecta a todos eles e os transforma em atividade no Telegram: o cartão de atividade, os pedidos de permissão, as respostas, os avisos e o registro de auditoria.

Comandos e interface do bot#

Como você controla o aipager pelo Telegram. Quatro formas de entrada: os comandos de barra, os botões do teclado, o painel do Mini App e as mensagens livres (texto, arquivos, áudio).

Uso em equipe e grupos#

Por padrão o aipager é um bot privado: você e o bot num chat privado, mais ninguém. O uso em equipe o abre para mais pessoas: um grupo do Telegram em que várias pessoas que programam controlam sessões, os chats privados de outras pessoas com o bot, ou as duas coisas. Cada chat tem os próprios membros, e cada membro tem uma função que decide o que ele pode fazer ali: mandar mensagens, responder às perguntas e aos pedidos de permissão do Claude, gerenciar sessões, ou só olhar.

Colocando para rodar#

Modelo de segurança#

O aipager roda o Claude Code em seu nome e é controlado pelo Telegram. Daí vêm duas perguntas:

Solução de problemas#

Falhas comuns e como resolver. Na dúvida, rode:

Relatórios de problemas#

Quando o aipager encontra um bug, você pode mandar um relatório de problemas para quem mantém o projeto com um toque. Você vê o relatório inteiro antes de qualquer coisa ser enviada, nada sai do seu computador até você mandar, e um relatório nunca contém seus chats, mensagens, nomes, caminhos nem tokens. Ele é montado só a partir de uma lista fixa de campos: versões, contagens, datas, respostas de sim ou não, opções de listas fixas, lugares do próprio código do aipager e os nomes ap1- dos bugs dele, mais uma nota curta só se você escrever uma.