dum-e

Benannt nach Tony Starks tollpatschigem Roboterarm. Ein persönlicher KI-Aufgabenmanager für Einzelbenutzer: KI-Agenten (Claude, Codex, opencode, jedes LLM) steuern ihn durch einen definierten Lebenszyklus, wobei du als Genehmigungsinstanz fungierst.

Drei Oberflächen, ein gemeinsamer Kern: eine leistungsstarke CLI, eine REST-API mit Live-Updates und ein MCP-Server, an den sich jeder Agent anbinden kann.

Die Idee

Wenn du einem KI-Agenten Arbeit überträgst, erstellt er zunächst hier eine Aufgabe. Der Agent holt die Aufgabe mit der höchsten Priorität aus der Warteschlange, analysiert sie, bearbeitet sie, führt KI-gestützte Tests durch und übergibt sie dann an manuelles Testen. Dort wartet sie auf deine Genehmigung oder Ablehnung. Abgelehnte Aufgaben kommen mit Kommentaren hoher Priorität zurück, die der Agent berücksichtigen muss; genehmigte Aufgaben fließen in das Deployment (PR-Review und Merge) und werden dann abgeschlossen. Die Schleife wiederholt sich, bis du genehmigst. Unabhängig von Tool und 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)

Jeder Übergang erfordert einen Kommentar, der in einer Append-only-Historie festgehalten wird.

Installation

Erfordert Node.js 22+ und pnpm 9+.

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

Lege dann dum-e auf deinen PATH. Die empfohlene Methode ist ein kleiner Launcher, der die Node-Version festschreibt, gegen die die native Abhängigkeit (better-sqlite3) gebaut wurde, damit die CLI funktioniert, egal welches node zuerst auf deinem PATH steht (ein einfacher Symlink auf dist/index.js bricht, wenn sich dein Standard-node von dem unterscheidet, mit dem du gebaut hast):

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

Stelle sicher, dass ~/.local/bin auf deinem PATH liegt. Alternativ, falls du pnpm setup ausgeführt hast (pnpm also ein globales bin-Verzeichnis hat): pnpm --filter @dum-e/cli link --global.

Wenn du später gegen eine andere Node-Version neu baust (z. B. nach pnpm install unter einem neuen node), erzeuge den Launcher neu, damit er auf den passenden Interpreter zeigt.

Überprüfen:

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

Schnellstart

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

Oberflächen

• CLI (dum-e ...): vollständiger Aufgaben- und Projektlebenszyklus vom Terminal aus. Füge --json zu jedem Befehl hinzu, um skriptbare Ausgaben zu erhalten. Siehe docs/CLI.md.

• REST + Web (dum-e serve): Hono-API mit Server-Sent Events für Live-Updates, die die React-Web-Oberfläche ausliefert (Kanban-Board, Tabellenansicht, Metriken, Detail-Drawer). Siehe docs/REST-API.md.

• MCP (dum-e mcp): ein Server für das Model Context Protocol auf stdio, der jedem Agenten Aufgaben-Tools bereitstellt. Siehe docs/AGENTS.md. Bringe einem Agenten bei, dum-e zu verwenden, indem du ihm skills/dum-e/SKILL.md übergibst.

Alle drei öffnen direkt dieselbe lokale SQLite-Datenbank (WAL-Modus: parallele Lesezugriffe, serialisierte Schreibzugriffe), sodass keiner von ihnen die anderen benötigt, um zu laufen.

Architektur

Modularer Monolith, pnpm-Workspaces. Jede Oberfläche ist ein dünner Adapter über @dum-e/core.

Der Laufzeitzustand liegt in ~/.config/dum-e/ (config.yaml, db, attachments/) und wird beim ersten Start automatisch erstellt. Überschreibe den Speicherort mit $DUM_E_HOME. Alle Details in docs/ARCHITECTURE.md.

Konfiguration

~/.config/dum-e/config.yaml enthält die Agentenliste, die Modellliste, die Standardwerte sowie Host/Port des Servers. Anzeigen oder finden:

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

Entwicklung

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

Nach Änderungen an der CLI baue sie neu: pnpm --filter @dum-e/cli build. Der globale dum-e-Symlink zeigt auf das Build-Ergebnis, sodass Änderungen automatisch übernommen werden.

Lizenz

MIT