Ordewell マルチエージェントタスクオーケストレーションツール – 概要と主な機能
Ordewell の役割 — 1 つの目標を編集可能なマルチエージェント計画に変換
Ordewell は自然言語による目標を、各タスクが実行者、モデル、思考の努力、モードを指定する型付き計画に変換します。トークンを消費する前に計画を編集できるため、開発者は各タスクに適したモデルを選択したり、依存関係を再構成したり、ステップを追加・削除しても完了した作業を失うことはありません。
- プランナーは読み取り専用の探索環境で動作します:リポジトリを照会し、明確化の質問を投げかけ、最終的な計画を最後のメッセージとして出力します。
- 実行では、各 AI タスクに対して別々のコーディングエージェントセッションが起動され、依存関係グラフを尊重し、実行者の出力に一意のマーカーが出現することで完了を検証します。
- マニュアルタスクはユーザーが完了としてマークできるチェックリスト項目として表示されます。
- プランナーには追加の API キーは必要ありません。Claude Code、Codex、OpenCode で既に保有しているサブスクリプションを再利用できます。
- 複数のランナーは標準でサポートされており、プラグインマニフェストを介して追加ランナーを追加できます。
クイックスタート – ターミナル UI のインストールと実行
npm install -g ordewell
ordewell # フルスクリーン TUI を起動
- 最初の起動時に、プランナーと 1 つ以上のランナー(例:Claude Code、Codex、OpenCode)を選択するよう促されます。初回は API キーは不要です。
npx ordewell(グローバルインストール不要)や VS Code 拡張機能(code --install-extension ordewell.ordewell)でも同じワークフローが利用可能です。- ヘッドレス自動化のため、すべてのスラッシュコマンドはサブコマンドとしても利用可能。
AI_PROVIDERまたは適切な*_API_KEY環境変数を設定することで、UI を使わずにordewell plan … && ordewell runを実行できます。
コアコンセプトとワークフロー
- 目標定義 – 自然言語による記述を提供します。例:
"Public API にレート制限を追加する"。 - プランナーの調査 – プランナーはリポジトリを読み取り専用で読み込み、明確化の質問を投げかけ、証拠を収集します。
- 計画生成 – 実行者、モデル、努力、モードが注釈されたタスクの順序付きリストが生成されます。計画は編集可能な型付きアーティファクトです。
- 実行 – 独立したタスクが並列で実行されます(デフォルト最大 3 セッション)。各 AI タスクは個別のセッションで実行され、マニュアルタスクはチェックリストになります。
- 評価エンジン – 実行者の出力に一意の完了マーカーが出現した場合にのみタスクは PASS とマークされます。終了コードは診断用の証拠として保持されます。タスクは手動で 完了 または 未完了 とマークできます。
3 つのユーザーインターフェース、1 つのコアエンジン
| インターフェース | 主な用途 |
|---|---|
| VS Code 拡張機能 | 統合されたストリーミングタイムライン、リアルタイムの調査ステップ、展開可能なタスクカード。実行者やモデルの即時再設定が可能。 |
| ターミナル UI (TUI) | フルスクリーン、キーボード駆動のワークフロー(SSH でも利用可能);tab でチャットと計画パネルを切り替え、単一キーのショートカットで計画を操作(例:f 開始、E 全て実行)。 |
| CLI | スクリプタブル、ヘッドレス自動化;UI のすべての操作がサブコマンドとして利用可能(ordewell plan、ordewell run、ordewell task-runner)。 |
すべてのインターフェースは同じコアパッケージ(core/、cli/、vscode/、web/)を共有し、ローカルデーモン(ordewell web --daemon)を介して JSON-over-WebSocket API を通じて通信します。
設定の基本
| 設定 | デフォルト | 効果 |
|---|---|---|
プロバイダー鍵(OPENROUTER_API_KEY、ANTHROPIC_API_KEY、…) |
— | 選択された AI プロバイダーに必要。Ordewell は設定された鍵からプロバイダーを自動検出します。 |
ORCHESTRATOR_MODEL |
deepseek/deepseek-v4-flash |
調査および計画生成に使用されるプランナー用モデル。 |
ORDEWELL_PLANNER_EFFORT |
— | コーディングエージェントプランナーの努力レベル(例:high、low)。 |
ORDEWELL_MAX_PARALLEL |
3 |
同時実行可能な AI タスクセッションの最大数(1–5)。 |
環境変数は ordewell key set …、ordewell model set …、または VS Code の設定パネルで設定できます。デーモンの再起動なしに即時反映されます。
拡張性 – カスタムランナーとプラグイン
- 標準で搭載されているランナーには Claude Code、Codex、OpenCode があります。
- 追加ランナーはプラグインマニフェスト(
ordewell plugins create my-runner)を作成し、Git URL からインストール(ordewell plugins install github:user/repo)することで追加できます。 - プラグインは GitHub、GitLab、Bitbucket、Codeberg にホスト可能。その他のソースはローカルクローンが必要です。
Hacker News からのコミュニティフィードバック
@ramon156: 「DeepSeek のような低コストモデル向けに、確実に計画を立てられる決定論的プログラムが欲しいです。LLM 部分は決定論的ではないですが、品質をこのように測るのが簡単です。」 – 予算モデルでの再現可能な計画の需要を強調しています。
@Lalabadie: 「別の差別化要素を探していたのですが、このプロジェクトのすべて(作者の返信も含む)が AI で書かれているように見えます。」 – ドキュメントが過剰に AI 生成されているという認識が信頼に影響する可能性を指摘しています。
@sharathr: 「https://github.com/highflame-ai/codeoid を試してみましたか?」 – 比較のための代替コード生成ツールを提案しています。
@ac‑ciano: 「[dead]」 – 元の作者のコメントが削除されたことを示しており、追加の洞察は提供していません。
プラットフォーム対応と Windows ノート
| サーフェス | Linux | macOS | Windows |
|---|---|---|---|
| VS Code 拡張機能 | ✅ | ✅ | ✅ |
| API サーバー | ✅ | ✅ | ✅ |
| CLI | ✅ | ✅ | ✅ |
| TUI(tmux 必須) | ✅ | ✅ | WSL が必要 |
- TUI はタスクごとの端末に tmux に依存しています。パッケージマネージャー(
apt install tmux、brew install tmux)でインストールしてください。 - Windows では、大きなシステムプロンプトでの
.cmdシムの制限を避けるために、エージェント CLI のネイティブインストーラーを使用してください。 - プランナーの読み取り専用シェルコマンド(
ls、grepなど)が一貫して動作するよう、Git for Windows をインストールしてください。
アーキテクチャのスナップショット
packages/
├─ core/ # 純粋な TypeScript:Session、PlanStore、Planner、Orchestrator、VerdictEngine
├─ cli/ # TUI、plan/run/status コマンド、薄いターミナルドライバー
├─ vscode/ # 拡張機能 UI、ストリーミングプランナーのタイムライン、タスクカード
└─ web/ # Hono HTTP + WebSocket デーモン(127.0.0.1:3742)
TUI のコアは純粋なリデューサーで、{state, effects} を返し、1 行ずつ文字列を出力するレンダラーを持つため、UI ロジックはテスト可能かつ UI 無関係です。
ライセンス
Ordewell は Apache License 2.0 の下でリリースされています。名前とロゴは NOTICE ファイルに従い、ライセンスの対象外です。
Sources
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト