shadok-ai
shadok-ai es un sistema que ejecuta agentes de Claude Code en paralelo, cada uno en su propio worktree git, con una interfaz única y silenciosa.
Ficha actualizada 23 sept 2026, 13:05 · upstream 23 sept 2026, 13:00 · release v0.7.0
Qué es shadok-ai
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
<p>shadok-ai permite ejecutar sesiones reales de Claude Code en paralelo, cada una en su propio trabajo de código (worktree), utilizando la suscripción de Claude que ya se paga. Cuando alguno de ellos tiene una pregunta, el usuario responde con un clic — desde el navegador o desde Telegram cuando no está al escritorio.</p>
<p>El sistema es notable por mantenerse activo incluso cuando el usuario no está presente: se puede replicar un agente a un canal de Telegram y responder desde el móvil. Además, incluye un guard que ejecuta sin el modelo (solo impresiona texto) para evitar gastar tokens en tareas inútiles.</p>
<p>La arquitectura permite múltiples agentes con roles distintos (lead, dev, QA, release, product, go-to-market), cada uno con sus propias guardrails de seguridad, contextos personalizados y capacidades. Además, cada agente tiene su propio trabajo de código aislado, lo que evita conflictos entre sesiones paralelas.</p>
- Automatizar la respuesta a preguntas frecuentes en un canal de Telegram sin intervención humana
- Ejecutar pruebas unitarias o de integración con cadencias programadas (cada N minutos)
- Generar documentación técnica basada en commits recientes mediante agentes especializados
- Monitoreo continuo de código: generar reportes automáticos sobre cambios, errores y métricas
- Automatización de despliegues: preparar releases, actualizar dependencias y ejecutar tests antes del deploy
- Creación de contenido o documentación con prompts repetitivos que no requieren intervención manual
- Cada agente opera en un worktree git independiente, evitando conflictos entre sesiones paralelas
- Guardrails de seguridad permiten prohibir acciones específicas (git commit) sin bloquear el flujo completo
- Contexto extendido de 1M tokens permite razonamiento complejo sobre proyectos completos
- Sistema de guardas programables que ejecutan tareas sin modelo, reduciendo costos en tiempo real
- Interfaz TUI con teclado virtual integrado y soporte para múltiples canales simultáneos
- Permite crear agentes desde cero o reutilizar roles existentes mediante perfiles personalizados
- Depende de una suscripción a Claude Code que puede tener límites de tokens diarios o mensuales
- La replicación a Telegram requiere un token del bot y configuración adicional por canal
- Los agentes no pueden acceder directamente al repositorio local sin permisos explícitos
- El contexto de 1M tokens consume recursos significativos en entornos con modelos limitados
- No hay soporte nativo para múltiples LLMs simultáneos, solo un modelo por agente
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.
Instala Node.js ≥ 20. Ejecuta `npx shadok-ai` y configura el token de Telegram en la web UI si se desea. En entornos Docker, usa un contenedor con los mismos flags (`--port`, `--no-open`). Para Linux sin GUI, instala tmux para persistencia entre reinicios. El agente principal se inicia automáticamente al inicio del servidor o tras la primera autenticación.
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.