pi-tg es un cliente experimental de Telegram que permite operar el agente de IA Pi directamente desde la mensajería instantánea. Se distribuye como un paquete de Node publicado en el registro npm bajo el nombre @atharva-again/pi-tg, e incorpora un binario del mismo nombre (pi-tg) que actúa como puente entre los chats de Telegram y el runtime local de Pi.
El flujo de uso es directo: se instala el paquete de forma global con npm install -g @atharva-again/pi-tg, se crea un bot en Telegram mediante @BotFather y se obtiene el identificador numérico del usuario con @userinfobot. A continuación se ejecuta pi-tg setup para generar el archivo de configuración en ~/.pi/agent/telegram/config.json con permisos 0600, y pi-tg doctor para verificar la instalación. La configuración también puede definirse mediante variables de entorno (PI_TELEGRAM_BOT_TOKEN y PI_TELEGRAM_ALLOWED_USERS), que tienen prioridad sobre el archivo guardado. El bot reutiliza el mismo proveedor, modelo y credenciales configurados en la CLI de Pi, de modo que los mensajes normales se envían al agente con acceso completo a las herramientas del usuario que ejecuta pi-tg.
En cuanto a la interacción, un chat directo estándar equivale a una sesión de Pi. La integración registra los 22 comandos de barra斜 que Pi trae incorporados y añade los comandos nativos /start y /help de Telegram. Cuando hay un runtime de Pi disponible en el chat, el menú de barras斜 incorpora además los comandos de extensiones, prompts y skills. La lista de modelos por sesión se invoca con /scoped_models, un alias seguro para el comando /scoped-models de Pi.
La interfaz hace uso intensivo de elementos interactivos de Telegram: botones inline, confirmaciones, subida y descarga de documentos y prompts pendientes por chat. Cambios de espacio de trabajo, modelo o sesión se gestionan desde /settings y /session sin comandos adicionales. Entre las funciones disponibles figuran exportación a HTML o JSONL, importación de sesiones, creación de enlaces de compartición con gh, navegación por el árbol de ramas, bifurcación, clonación, compactación, reanudación, recarga de extensiones y cierre controlado del cliente.