Script para ejecutar Claude Code usando Telegram

Introducción

Es un script hecho con npx para poder controlar Claude Code desde Telegram, creado para usarlo en momentos urgentes (después del trabajo, fuera de casa).

Características

• 1 sala de chat por proyecto (ruta); se necesita un bot de Telegram independiente para cada uno
• Permite ejecución en paralelo, ejecución repetida (hasta que tenga éxito) y asignación de prioridades
• Permite revisar tareas y cancelarlas

Instalación y uso

• Ejecuta npx cc-telegram, registra el token del bot y el chat id de Telegram siguiendo las instrucciones, configura algunas opciones adicionales y quedará listo para usarse.
• Después, ejecútalo otra vez con npx cc-telegram y envía una nueva solicitud por Telegram con el comando /new.
• En Telegram se muestra la lista de comandos disponibles mediante autocompletado con /. Para más detalles, consulta el enlace.

Breve historia del desarrollo

Versión 1

La primera versión usaba un servidor intermediario y un programa agente que permitía especificar varias rutas dentro de la PC, de modo que se podían usar proyectos de múltiples rutas a través de una sola sala de chat.
Como intentar administrar varios proyectos en una sola sala de chat solo aumentó la complejidad, la descarté a los dos días.

Versión 2

En la segunda versión eliminé el servidor intermediario y cambié el script para que obtuviera los mensajes de Telegram mediante polling.
En ese momento incorporé subagentes dentro de las funciones, y esos agentes analizaban las solicitudes para trabajar en ellas; cuando no había tareas, proponían mejoras o las ejecutaban automáticamente.
Tras dejarlo corriendo durante 4 días de vacaciones a finales del año pasado, confirmé que había generado una gran cantidad de código basura y lo descarté.

Versión 2.5

Es una versión de la segunda en la que se eliminó la parte de proponer mejoras y ejecutarlas automáticamente. De alguna manera funciona, pero...

Versión actual

Hace poco conocí el plugin ralph-loop, lo probé en proyectos individuales y concluí que lo mejor era usar el modo de ejecución repetida junto con la configuración de Claude propia de cada proyecto.

El problema de la versión 2 era que cada proyecto tenía su propia configuración adecuada de subagentes, pero al ofrecer subagentes unificados sin tomar eso en cuenta, concluí que el rendimiento empeoraba.

Descarté casi todo el trabajo anterior (solo reutilicé la parte de ejecución de Claude Code por SO y el código de integración con Telegram), lo rediseñé casi desde cero y así salió la versión actual.
Personalmente, siento que recién ahora salió una versión que realmente ya es bastante usable.

Si lo prueban, les agradeceré mucho sus impresiones o comentarios.