Documentación

Empieza aquí#

Instalar con un agente#

Esta página es para un agente de programación con IA (Claude Code, o cualquier agente con shell) al que le piden instalar y configurar aipager para su persona. Síguela paso a paso. Todos los comandos de aquí se ejecutan sin preguntas y nunca necesitan una terminal interactiva.

Referencia#

Arquitectura#

aipager es un programa asyncio de un solo proceso que funciona en segundo plano. Une tres mundos: tu chat de Telegram, los procesos de Claude Code que ejecutas bajo dtach, y el sistema de hooks de Claude Code. Todo pasa por un único event loop: sin grupos de workers, sin base de datos, sin colas entre procesos.

Eventos de hook#

Claude Code ejecuta comandos de hook en momentos fijos de una tarea: se envía un mensaje, una herramienta está a punto de ejecutarse, una herramienta terminó, la tarea terminó, y así. aipager se engancha a todos ellos y los convierte en actividad en Telegram: la tarjeta de actividad, las solicitudes de permiso, las respuestas, los avisos y el registro de auditoría.

Comandos e interfaz del bot#

Cómo manejas aipager desde Telegram. Cuatro vías de entrada: los comandos de barra, los botones del teclado, el panel de la Mini App y los mensajes libres (texto, archivos, audio).

Uso en equipo y grupos#

Por defecto aipager es un bot privado: tú y el bot en un chat privado, nadie más. El uso en equipo lo abre a más personas: un grupo de Telegram donde varias personas que programan manejan sesiones, los chats privados de otras personas con el bot, o las dos cosas. Cada chat tiene sus propios miembros, y cada miembro tiene un rol que decide qué puede hacer ahí: enviar mensajes, responder a las preguntas y a las solicitudes de permiso de Claude, gestionar sesiones, o solo mirar.

Ponerlo en marcha#

Modelo de seguridad#

aipager ejecuta Claude Code en tu nombre y se maneja desde Telegram. De ahí salen dos preguntas:

Solución de problemas#

Fallos frecuentes y cómo arreglarlos. Ante la duda, ejecuta:

Informes de problemas#

Cuando aipager se topa con un error, puedes enviar un informe de problemas a quien lo mantiene con un solo toque. Ves el informe completo antes de que se envíe nada, nada sale de tu computadora hasta que tú lo dices, y un informe nunca contiene tus chats, mensajes, nombres, rutas ni tokens. Se construye solo a partir de una lista fija de campos: versiones, cantidades, fechas, respuestas de sí o no, opciones de listas fijas, lugares del propio código de aipager y los nombres ap1- de sus errores, más una nota corta solo si tú la escribes.