ccbot
ccbot es un bot de Telegram auto-alojado que actúa como puente entre tu móvil y agentes de IA terminal (Claude Code, Codex) ejecutándose en tmux. Permite controlar sesiones remotas con toques, gestionar múltiples worktrees paralelos sin conflictos y habilitar voz bidireccional.
Ficha actualizada 24 sept 2026, 16:13 · upstream 24 sept 2026, 16:06 · release sin release detectada
Qué es ccbot
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
ccbot es una herramienta de automatización para desarrollo que conecta Telegram con agentes CLI (Claude Code, OpenAI Codex) ejecutándose localmente en tmux. A diferencia de soluciones basadas en API, actúa como un puente ligero que transmite keystrokes y captura screenshots del terminal en tiempo real, permitiendo supervisión completa sin intermediarios costosos ni pérdida de contexto.
Soporta gestión de flotas mediante grupos de Telegram con temas (topics) por agente, facilitando el control paralelo de múltiples proyectos. Incluye capacidades avanzadas como fork de agentes en git worktrees aislados para evitar conflictos de archivos, y soporte nativo para prompts interactivos, aprobaciones de commits y selección de modelos directamente desde la interfaz móvil.
Es auto-alojado (self-hosted), requiriendo Python 3.12+, tmux y uv. Ofrece integración con servicios de voz (Deepgram/OpenAI) para transcripción y síntesis, permitiendo dictar tareas y recibir respuestas habladas. La persistencia de sesiones asegura que el trabajo continúe incluso si el bot se reinicia, recuperable vía `tmux attach`.
- Control remoto de refactorizaciones desde el móvil mientras se trabaja en el escritorio.
- Ejecución paralela de múltiples agentes en diferentes worktrees de git para evitar bloqueos.
- Supervisión visual de procesos de compilación o pruebas con screenshots del terminal en vivo.
- Gestión de flotas de agentes para distintos proyectos dentro de un único grupo de Telegram.
- Aprobación de prompts interactivos (permisos, commits) mediante interfaz táctil.
- Integración de voz bidireccional para dictado de tareas y respuestas habladas del agente.
- Arquitectura basada en tmux que mantiene la terminal local como fuente de verdad, permitiendo `tmux attach` para recuperación de sesiones.
- Soporte nativo para múltiples runtime (Claude Code y OpenAI Codex) con capacidad de añadir más mediante subclases.
- Gestión de worktrees de git aislados por agente para ejecutar tareas paralelas sin conflictos de archivos.
- Interfaz táctil completa para navegación en menús, selección de opciones y control de teclado (flechas, Enter, Ctrl-C).
- Licencia MIT libre y auto-alojado, eliminando costes por token y dependencia de relays de terceros.
- Indicadores visuales de estado como "typing" y reacciones de lectura para confirmar que el agente procesa mensajes.
- Requiere instalación manual de dependencias (tmux, uv, CLI) en Linux/macOS; no tiene soporte Docker oficial ni archivo Compose.
- La persistencia depende de la sesión tmux local; si el servidor se reinicia sin guardar, las sesiones pueden perderse.
- Funcionalidad de voz requiere claves API externas (Deepgram/OpenAI) para transcripción y síntesis.
- No incluye autocompletado ni gestión de dependencias automática fuera del entorno local del usuario.
- La interfaz móvil depende de la calidad de la conexión a Telegram para transmitir screenshots en tiempo real.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Despliega en Linux o macOS con Python 3.12+, tmux y uv. Clona el repositorio, ejecuta `uv sync` y copia `.env.example` a `.env`, configurando `TELEGRAM_BOT_TOKEN` y `ALLOWED_USERS`. Instala el hook con `ccbot hook --install` antes de iniciar. Crea un grupo en Telegram con temas activados y añade el bot como administrador. Para voz, configura las claves API opcionales en variables de entorno. El despliegue es ligero y no requiere contenedores, solo la terminal local activa para mantener sesiones persistentes.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.