Jorge Turbica / blog · Blog ← Todos los artículos EN · Read in English
IA

Repo del día: dsh-superagent, el agente de DeepSeek que convierte menciones en PR

18.545 estrellas en cinco días: DeepSeek publica un agente que atiende un repo de GitHub con un Router y workers en paralelo. Es un prototipo.

18.545 estrellas y 2.073 forks en cinco días: es lo que ha sumado el prototipo de agente autónomo que DeepSeek publicó el 31 de octubre de 2026. No es un modelo ni una CLI de código más, sino un servicio que vigila un repositorio y convierte cada petición en un ticket con su propio agente, su directorio y, al final, un pull request.

Qué es

dsh-superagent es un agente proactivo para un único repositorio de GitHub, empaquetado como plugin de DeepSeek Harness, el entorno de agentes de DeepSeek. Escucha GitHub (y opcionalmente chats de Feishu); cuando alguien autorizado menciona a la cuenta del agente, abre un ticket, lo trabaja en una sesión aislada y responde en la conversación original, normalmente con un PR. Un panel web local enseña solo lo que necesita a una persona.

Por dentro sigue la arquitectura del artículo Exploring Super-agent Design del equipo de DeepSeek Harness: una sesión Router atiende a las personas, mantiene el contexto global y reparte el trabajo, y cada ticket lo ejecuta un Executor (worker-<id>) en paralelo, que informa al Router en lugar de hablar directamente con el usuario. Los comandos largos pasan a segundo plano a los 5 segundos para que el worker pueda leer mensajes nuevos, y el trabajo en segundo plano tiene 30 minutos tras cada turno antes de que se corte. En las pruebas del artículo, con cargas sintéticas de unos 300 mensajes y 20 peticiones de trabajo, este diseño terminó las tareas con un p95 de 15,7 minutos frente a 29,5 minutos de una sola sesión con subagentes. Los propios autores avisan de que eso mide planificación y coordinación, no la calidad del trabajo.

El código está en TypeScript, con licencia MIT, y el README lo deja claro desde la primera línea: es un prototipo de investigación, no un producto oficial de DeepSeek, escrito en buena parte por agentes y distinto de su versión interna.

Cómo se usa

La instalación recomendada es pedirle a tu agente de código que lea SETUP.md y la haga contigo: pregunta una cosa cada vez (repositorio, cuenta del agente, quién puede pedir trabajo, si activa auto-merge) y no ejecuta nada hasta que confirmas el plan. A mano, según la guía de despliegue, y con Node.js 22.19+, pnpm, git, tmux, Python 3.8+ y GitHub CLI 2.48+:

bash
npm install -g @deepseek-ai/[email protected]
git clone https://github.com/deepseek-ai/dsh-superagent-prototype.git dsh-superagent
cd dsh-superagent
pnpm install && pnpm build
dsh superagent --from-default-profile web --dump-config > /dev/null
dsh plugin --profile superagent add "link:$PWD"
scripts/dsh-superagent start
scripts/dsh-superagent status

Después se configuran las fuentes y las listas de permitidos desde el panel o su API de gestión, y para probarlo basta con un comentario @<cuenta-del-agente> <petición> en una issue. El ticket aparece en el panel en un minuto.

El aviso importante está en la propia documentación: los presets del Router y de los workers corren con danger-full-access como el usuario del sistema del operador. Un worker puede ejecutar cualquier programa y leer tu directorio personal; los wrappers de gh eligen las credenciales del agente, pero no aíslan el proceso. La guía recomienda una cuenta de GitHub dedicada (nunca la tuya) y, si quieres aislamiento de verdad, un usuario del sistema que solo tenga las credenciales del agente.

Lo que me convence y lo que no

Me convence que el diseño se mida por la atención humana que consume. El agente solo actúa cuando se lo pide alguien de una lista o cuando lo permite una regla escrita por el equipo, y el trabajo proactivo empieza en modo observe: registra lo que habría hecho sin hacerlo, para que revises sus decisiones antes de pasar a auto. Es la respuesta correcta al miedo razonable de que un agente con permisos de escritura llene el repositorio de PR que nadie pidió.

Lo que no: depende de una versión candidata de DeepSeek Harness (0.2.1-rc.3), solo funciona con github.com (no GitHub Enterprise Server), atiende un repositorio por instalación y vive en una máquina con tmux, con un chequeo horario para recuperarse si se cae. La propia advertencia de "código de investigación con estilo inconsistente" es un dato a tener en cuenta antes de darle una cuenta con acceso de escritura.

dsh-superagent frente a Claude Code GitHub Actions

La referencia más extendida para "menciono al agente en una issue y me abre un PR" es la acción anthropics/claude-code-action:

dsh-superagentClaude Code GitHub Actions
EnfoqueServicio persistente con Router y workers en paralelo; tickets que se reanudanUn job de Actions por evento o mención
DespliegueTu máquina, con tmux y DeepSeek HarnessRunners de GitHub Actions
Quién puede pedirListas de permitidos y reglas propias, modo observeUsuarios con permiso de escritura y bots en allowed_bots
AislamientoDirectorio por ticket, pero corre como el usuario del operadorEl runner efímero de cada job
Licencia y madurezMIT, prototipo de investigaciónProducto con versión v1

Si quieres que un agente resuelva peticiones puntuales con el mínimo de infraestructura, la acción de GitHub es más sencilla y cada ejecución empieza en un runner limpio. dsh-superagent tiene sentido para experimentar con un agente que mantiene contexto entre tickets, trabaja en varios a la vez y puede actuar sin mención cuando el equipo lo autoriza, siempre en una máquina o cuenta aparte.

Fuentes

Jorge Turbica

Software Engineer y SRE. Escribo sobre los retos reales que me encuentro en producción.

Ver portfolio ↗