dum-e

トニー・スタークの不器用なロボットアームにちなんで名付けられました。AIエージェント（Claude、Codex、opencode、任意のLLM）が定義されたライフサイクルを通じて駆動し、あなたが承認ゲートとなる、個人向けシングルユーザーAIタスクマネージャーです。

3つのサーフェス、1つの共有コア：強力なCLI、ライブ更新を備えたREST API、そして任意のエージェントが接続できるMCPサーバー。

アイデア

AIエージェントに作業を委任するたびに、まずここにタスクが作成されます。エージェントはキューから最優先タスクを取得し、それを分析し、作業し、AIレベルのテストを実行してから、手動テストに渡します。そこで、あなたの承認または却下を待ちます。却下されたタスクは、エージェントが対応しなければならない高優先度のコメントとともに戻されます。承認されたタスクはデプロイ（PRレビューとマージ）に進み、その後完了します。あなたが承認するまで、このループは繰り返されます。ツールや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)

すべての遷移にはコメントが必要で、そのコメントは追記専用の履歴に記録されます。

インストール

Node.js 22+ と pnpm 9+ が必要です。

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

次に、dum-e を PATH に追加します。推奨される方法は、ネイティブ依存関係（better-sqlite3）がビルドされた Node を固定する小さなランチャーを使うことです。これにより、PATH の先頭にある node がどれであっても CLI が動作します（dist/index.js への単純なシンボリックリンクは、デフォルトの node がビルドに使用したものと異なる場合に壊れます）。

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

~/.local/bin が PATH に含まれていることを確認してください。あるいは、pnpm setup を実行済みの場合（pnpm にグローバル bin ディレクトリがある場合）は、pnpm --filter @dum-e/cli link --global を実行してください。

後で別の Node バージョンに対して再ビルドする場合（例：新しい node で pnpm install を実行した後）は、ランチャーを再生成して、対応するインタープリタを指すようにしてください。

確認：

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

クイックスタート

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

サーフェス

• CLI（dum-e ...）：ターミナルからタスクとプロジェクトのライフサイクル全体を操作できます。任意のコマンドに --json を追加すると、スクリプト可能な出力になります。docs/CLI.md を参照してください。

• REST + web（dum-e serve）：Server-Sent Events によるライブ更新を備えた Hono API。React 製 Web UI（カンバンボード、テーブルビュー、メトリクス、詳細ドロワー）を配信します。docs/REST-API.md を参照してください。

• MCP（dum-e mcp）：stdio 上で動作する Model Context Protocol サーバーで、任意のエージェントにタスクツールを公開します。docs/AGENTS.md を参照してください。skills/dum-e/SKILL.md をエージェントに渡すことで、dum-e の使い方を教えることができます。

3つのサーフェスはすべて、同じローカル SQLite データベースを直接開きます（WAL モード：同時読み取り、直列化された書き込み）。そのため、いずれも他のサーフェスが実行中である必要はありません。

アーキテクチャ

モジュラーモノリス、pnpm workspaces。各サーフェスは @dum-e/core 上の薄いアダプターです。

ランタイム状態は ~/.config/dum-e/（config.yaml、db、attachments/）に保存され、初回実行時に自動作成されます。場所を変更するには $DUM_E_HOME を使用します。詳細は docs/ARCHITECTURE.md を参照してください。

設定

~/.config/dum-e/config.yaml には、エージェントの一覧、モデルの一覧、デフォルト設定、サーバーのホスト/ポートが格納されています。表示するか場所を確認するには：

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

開発

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

CLI を編集したら、pnpm --filter @dum-e/cli build で再ビルドしてください。グローバルの dum-e シンボリックリンクはビルド出力を指しているため、変更は自動的に反映されます。

ライセンス

MIT