PTENES
Runtime local de agentes de código

Un solo lugar para orquestar tus agentes

Ejecuta DSH, Codex CLI, Claude Code, Git y GitHub CLI en el mismo workspace, con sesiones persistentes y worktrees aislados.

Entorno visual para orquestar agentes de código
Qué es

Tu harness se convierte en un centro de operaciones

Una capa local y auditable que conecta DSH con agentes interactivos sin ceder el control del Docker del host.

🧠 Tres agentes, un workspace

DSH, Codex y Claude ven los mismos proyectos, Git y autenticaciones persistentes.

🧵 Sesiones persistentes

Tmux mantiene activa cada tarea incluso cuando se cierra el navegador, con entrada y salida desde el panel.

🌿 Paralelismo seguro

Los worktrees opcionales crean ramas y directorios aislados para reducir las colisiones entre agentes.

Cómo funciona

Del pedido a la sesión en pocos pasos

DSH llama a herramientas MCP; el orchestrator valida el proyecto y abre el agente en una sesión tmux que puedes monitorear desde la web o la CLI.

DSH o panel→ API autenticada→ Worktree opcional→ Tmux→ Codex · Claude · Shell
Requisitos previos

Lo mínimo para comenzar

El build descarga DSH y las demás CLIs. Solo necesitas Docker y las cuentas que quieras usar.

Docker + Compose

En Debian o Ubuntu, usa el instalador incluido.

./scripts/install-docker-debian.sh

Cuentas interactivas

OpenAI, Anthropic y GitHub se autentican mediante los flujos oficiales.

./scripts/login.sh all

OpenRouter u Ollama

DSH puede usar la nube o un modelo local en el host.

./scripts/configure-openrouter.sh
Guía de uso · paso a paso

Instala, autentica y orquesta

Los comandos de abajo son los mismos que usa el proyecto real.

1

Clona el proyecto

Descarga el runtime y entra en la carpeta.

git clone git@github.com:inematds/dsh-orchestrator.git
cd dsh-orchestrator
2

Ejecuta el bootstrap

Genera el token, elige puertos libres, construye la imagen e inicia los servicios.

./scripts/bootstrap.sh
3

Inicia sesión de forma interactiva

Las credenciales se guardan fuera del árbol de proyectos, en el directorio de datos del runtime.

./scripts/login.sh codex
./scripts/login.sh claude
./scripts/login.sh github
4

Abre una sesión aislada

Usa el panel o la CLI interna para iniciar un agente en su propio worktree.

./scripts/shell.sh
orch start codex --cwd /workspace/meu-repo \
  --name api --prompt "implemente os testes" --worktree
5

Monitorea y conversa

Lista sesiones, captura la salida o envía una nueva indicación sin perder el proceso.

orch list
orch output ID --lines 500
orch send ID "rode os testes e corrija as falhas"
Ejemplos

Flujos que ya están listos

La misma infraestructura puede operarse manualmente o mediante DSH vía MCP.

🧭 DSH como coordinador

DSH lista sesiones, delega una implementación a Codex y monitorea la salida mediante herramientas MCP estructuradas.

🔀 Dos agentes en paralelo

Codex trabaja en la API y Claude explora la documentación, cada uno en su propia branch y worktree.

Roadmap

Base lista para crecer

El núcleo ya funciona; las próximas fases pueden ampliar la observabilidad y la gobernanza.

AHORA
Runtime multiagente localPanel, API, CLI, MCP, tmux, worktrees, autenticación persistente y respaldo.
SIGUIENTE
Políticas por proyectoPerfiles de permisos, límites de concurrencia y selección automática de agente.
FUTURO
Historial y métricasEventos estructurados, costos, tiempos y reanudación guiada desde el panel.