dum-e

Nombrado por el torpe brazo robótico de Tony Stark. Un gestor de tareas de IA personal, para un solo usuario, que los agentes de IA (Claude, Codex, opencode, cualquier LLM) impulsan a través de un ciclo de vida definido, contigo como puerta de aprobación.

Tres superficies, un núcleo compartido: una potente CLI, una API REST con actualizaciones en vivo y un servidor MCP al que cualquier agente puede conectarse.

La idea

Siempre que delegas trabajo a un agente de IA, primero crea una tarea aquí. El agente toma la tarea de mayor prioridad de la cola, la analiza, la trabaja, ejecuta pruebas a nivel de IA y luego la entrega a pruebas manuales. Allí espera tu aprobación o rechazo. Las tareas rechazadas vuelven con comentarios de alta prioridad que el agente debe abordar; las tareas aprobadas pasan al despliegue (revisión y fusión de PR) y luego se completan. El bucle se repite hasta que apruebas. Agnóstico a herramientas y LLM.

              agent auto-advances                    human gate
   ┌──────┐   ┌─────────────┐   ┌────────────┐   ┌────────────────┐   ┌────────────┐   ┌───────────┐
   │ todo │ → │ in_progress │ → │ ai_testing │ → │ manual_testing │ → │ deployment │ → │ completed │
   └──────┘   └─────────────┘   └────────────┘   └────────────────┘   └────────────┘   └───────────┘
                    ↑                                    │                   │
                    └────────────── reject ──────────────┴───────────────────┘
                      (priority bumped, flagged for the agent to fix first)

Cada transición requiere un comentario, registrado en un historial de solo añadido.

Instalación

Requiere Node.js 22+ y pnpm 9+.

git clone <repo> dum-e && cd dum-e
pnpm install
pnpm build

Luego pon dum-e en tu PATH. La forma recomendada es un pequeño lanzador que fija el Node contra el que se compiló la dependencia nativa (better-sqlite3), de modo que la CLI funcione sin importar qué node esté primero en tu PATH (un enlace simbólico simple a dist/index.js se rompe si tu node predeterminado difiere del que usaste para compilar):

mkdir -p ~/.local/bin
cat > ~/.local/bin/dum-e <<EOF
#!/bin/sh
exec "$(command -v node)" "$PWD/packages/cli/dist/index.js" "\$@"
EOF
chmod +x ~/.local/bin/dum-e

Asegúrate de que ~/.local/bin esté en tu PATH. Alternativamente, si has ejecutado pnpm setup (para que pnpm tenga un directorio global de binarios): pnpm --filter @dum-e/cli link --global.

Si más tarde recompilas contra una versión diferente de Node (por ejemplo, después de pnpm install con un nuevo node), regenera el lanzador para que apunte al intérprete correspondiente.

Verifica:

dum-e --version
dum-e --help

Inicio rápido

dum-e init                                   # create ~/.config/dum-e/{config.yaml,db}
dum-e project add "Web App" -k WEB           # a project
dum-e task add "Fix login" --type bug --priority high
dum-e task next -m "starting"                # claim the highest-priority queued task
dum-e task move <id> ai_testing -m "unit tests green"
dum-e task move <id> manual_testing -m "verified locally"   # now waits for you
dum-e task ls --status manual_testing        # what awaits your review
dum-e serve --open                           # REST API + web UI, opens the browser

Superficies

• CLI (dum-e ...): ciclo de vida completo de tareas y proyectos desde la terminal. Añade --json a cualquier comando para obtener salida programable. Consulta docs/CLI.md.

• REST + web (dum-e serve): API de Hono con Server-Sent Events para actualizaciones en vivo, que sirve la interfaz web de React (tablero kanban, vista de tabla, métricas, panel de detalles). Consulta docs/REST-API.md.

• MCP (dum-e mcp): un servidor de Model Context Protocol en stdio que expone herramientas de tareas a cualquier agente. Consulta docs/AGENTS.md. Enseña a un agente a usar dum-e entregándole skills/dum-e/SKILL.md.

Los tres abren la misma base de datos SQLite local directamente (modo WAL: lectores concurrentes, escrituras serializadas), por lo que ninguno necesita que los otros estén en ejecución.

Arquitectura

Monolito modular, workspaces de pnpm. Cada superficie es un adaptador delgado sobre @dum-e/core.

El estado en tiempo de ejecución vive en ~/.config/dum-e/ (config.yaml, db, attachments/), creado automáticamente en la primera ejecución. Sobrescribe la ubicación con $DUM_E_HOME. Detalle completo en docs/ARCHITECTURE.md.

Configuración

~/.config/dum-e/config.yaml contiene el registro de agentes, el registro de modelos, los valores predeterminados y el host/puerto del servidor. Muéstralo o localízalo:

dum-e config show      # effective config (YAML, or JSON with --json)
dum-e config path      # path to the file

Desarrollo

pnpm build        # build every package (tsup for libs, Vite for web)
pnpm test         # Vitest (state machine + services)
pnpm typecheck    # tsc --noEmit across the workspace
pnpm lint         # oxlint

Después de editar la CLI, recompílala: pnpm --filter @dum-e/cli build. El enlace simbólico global dum-e apunta a la salida de compilación, por lo que recoge los cambios automáticamente.

Licencia

MIT