oh-my-openagent

マルチモデル・エージェント・オーケストレーション for OpenCode — npm oh-my-opencode（oh-my-openagent も可）v3.17.12 · プラグイン ID oh-my-openagent

概要

Philosophy

Claude Code、Codex、各種 OSS モデルを個別に使い分けていた時代は終わった。
Oh My OpenAgent（opencode.json のプラグイン ID は oh-my-openagent）は、CLI / 公開 npm 名は公式ガイド上まだ oh-my-opencode が主軸だが、oh-my-openagent パッケージ・bunx oh-my-openagent も同一バイナリを指す。複数プロバイダの AI モデルを 1 つのハーネスで束ね、専門エージェントに自動委譲する。インストールして ultrawork を打つだけ。

Anthropic はこのプロジェクトのせいで OpenCode をブロックした。
ロックインを拒否し、Claude / Kimi / GLM / GPT / Gemini / Minimax を並列オーケストレーション。モデルは毎月安くなり、毎月賢くなる。特定プロバイダに縛られない設計。

専門エージェント

68%

編集成功率向上
6.7→68.3% (Hashline)

ビルトイン MCP

100%

Claude Code 互換

クイックスタート

Step 1 — インストール

公式ガイドに従う

OpenCode の opencode.json ではプラグイン ID に oh-my-openagent を推奨（oh-my-opencode はレガシーで警告付き）。手順は上流 installation.md に従う。

fetch

curl -fsSL https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

Step 2 — 診断

doctor

登録・設定・モデル・環境を一括チェック。

bash

bunx oh-my-opencode doctor
# 同一 CLI: bunx oh-my-openagent doctor

Step 3 — 実行

ultrawork / ulw

ワンショットでオーケストレーション開始。詳細は下記「コマンドリファレンス」。

Tmux: 背景エージェントのマルチペイン可視化などは "tmux": { "enabled": true, "layout": "main-vertical" } を推奨。

オーケストレーションモード

実行フロー

flowchart TD U([User]) --> IG[IntentGate\n意図分類] IG --> S[Sisyphus\n主オーケストレーター] S --> P[Prometheus\n計画・プランニング] S --> H[Hephaestus\n深い実装] S --> O[Oracle\nアーキレビュー] S --> L[Librarian\n調査・ドキュメント] S --> E[Explore\n高速検索] S --> BG[背景エージェント\n並列 × N] P --> S BG --> DONE([完了]) H --> DONE O --> DONE L --> DONE E --> DONE classDef user fill:#1c2128,stroke:#58a6ff,color:#58a6ff,stroke-width:2px classDef gate fill:#1c2128,stroke:#d4a73a,color:#d4a73a classDef sis fill:#1a2035,stroke:#58a6ff,color:#e6edf3,stroke-width:2px classDef plan fill:#1c2128,stroke:#d4a73a,color:#e6edf3 classDef sub fill:#161b22,stroke:#30363d,color:#8b949e classDef done fill:#1c2128,stroke:#3fb950,color:#3fb950,stroke-width:2px class U user class IG gate class S sis class P plan class H,O,L,E,BG sub class DONE done

カテゴリシステム

Sisyphus が委譲する際、モデルを直接指定するのではなく カテゴリ を選ぶ。カテゴリが適切なモデルに自動マッピングされる。

カテゴリ	用途	優先モデル（連鎖の先頭）
`visual-engineering`	フロントエンド・UI/UX・デザイン	`gemini-3.1-pro` high
`deep`	自律的な調査・実行（Hephaestus モード）	`gpt-5.5` medium
`quick`	単一ファイル変更・タイポ修正など軽量タスク	`gpt-5.4-mini`
`ultrabrain`	難解なロジック・アーキテクチャ決定	`gpt-5.5` xhigh
カスタム	独自ドメイン（business-logic など）を定義可能	設定で指定

背景エージェント（Background Agents）

起動

bash

task(
  subagent_type="explore",
  prompt="auth 実装を探せ",
  run_in_background=true
)

結果取得

bash

background_output(
  task_id="bg_abc123"
)

Tmux 統合を有効化すると、背景エージェントが別ペインに表示され、複数エージェントのリアルタイム動作を観察できる。 "tmux": { "enabled": true, "layout": "main-vertical" }

アーキテクチャ

Hashline — ハッシュ錨定編集

従来の編集ツールはモデルに「前に読んだ内容を再現させる」が、モデルはしばしば失敗する。 The Harness Problem（Can Bölük）にインスパイアされた Hashline はこれを根本解決する。

各行に LINE#HASH タグを付与。エージェントはそのタグを参照して編集する。ファイルが変更されたらハッシュが一致しなくなり、編集は拒否される。古い行参照によるファイル破損ゼロ。

Hashline — エージェントが読む形式

11#VK| function hello() {
22#XJ|   return "world";
33#MB| }

6.7%

従来の編集成功率

→

68.3%

Hashline 導入後

Grok Code Fast 1 での計測。
ツール変更のみで 10× 向上。

IntentGate

ユーザーの 真の意図 を分類・分析してからアクションを選択。文字通りの解釈による誤った実行を防ぐ。

LSP + AST-Grep — IDE 精度のツール

ツール	機能
`lsp_rename`	ワークスペース全体のシンボルリネーム
`lsp_goto_definition`	定義ジャンプ
`lsp_find_references`	全参照を検索
`lsp_diagnostics`	ビルド前診断・型エラー検出
`ast_grep`	25 言語対応のパターン認識コード検索・書き換え

/init-deep — 階層的 AGENTS.md 生成

生成されるディレクトリ構造

project/
├── AGENTS.md          ← プロジェクト全体コンテキスト
├── src/
│   ├── AGENTS.md      ← src 固有のコンテキスト
│   └── components/
│       └── AGENTS.md  ← コンポーネント固有のコンテキスト

エージェントが関連コンテキストを自動読み込み。手動管理不要でトークン効率も向上。

コマンドリファレンス

主要コマンド

CMD 01

ultrawork / ulw

全エージェント起動。完了まで止まらない。ワンワード、フルオーケストレーション。

CMD 02

/start-work

Prometheus を呼び出し、インタビューモードで計画を立ててから実行開始。

CMD 03

/ulw-loop (Ralph Loop)

自己参照ループ。100% 完了まで繰り返し実行し続ける。

CMD 04

/init-deep

プロジェクト全体に階層的 AGENTS.md を自動生成。

CMD 05

doctor

bunx oh-my-opencode doctor（または bunx oh-my-openagent doctor）でプラグイン登録・設定・モデル・環境を診断。

CMD 06

Todo Enforcer

エージェントがアイドル状態になったらシステムが自動復帰。タスクは必ず完了する。

エージェント一覧

Core Agents

エージェント	優先モデル（連鎖の先頭）	役割	制限
Sisyphus order: 1	`claude-opus-4-7` max	主オーケストレーター。計画・委譲・並列実行。接続プロバイダに応じて Kimi K2.5 / GLM-5 / GPT-5.5 などへフォールバック。	—
Hephaestus 深い実装	`gpt-5.5` medium	自律深層ワーカー。目標を与えるだけでコードベース調査から実装まで完結。途中で止まらない鍛冶の神。	—
Oracle	`gpt-5.5` high	アーキテクチャ決定・コードレビュー・デバッグ。読み取り専用の相談役。Gemini / Opus / GLM などへフォールバック。	read-only（write/edit/task 禁止）
Librarian	`gpt-5.4-mini-fast`	マルチリポジトリ解析・ドキュメント検索・OSS 実装例調査。証拠ベースの回答。Minimax / Haiku などへフォールバック。	write/edit/task 禁止
Explore	`gpt-5.4-mini-fast`	高速なコードベース探索と文脈付き grep。Librarian と同型の軽量連鎖。	write/edit/task 禁止
Multimodal-Looker	`gpt-5.5` medium	PDF・画像・ダイアグラムから情報を抽出するビジュアル専門家。Kimi / GLM-4.6v などへフォールバック。	read のみ

Planning Agents

エージェント	優先モデル（連鎖の先頭）	役割
Prometheus	`claude-opus-4-7` max	戦略プランナー。インタビューモードで質問を繰り返し、詳細な作業計画を構築してから実行する。GPT-5.5 / Gemini などへフォールバック。
Metis	`claude-opus-4-7` max	計画コンサルタント。隠れた意図・曖昧さ・AI の失敗ポイントを事前特定。
Momus	`gpt-5.5` xhigh	計画レビュアー。明確性・検証可能性・完全性の基準で計画を検証。Opus / Gemini などへフォールバック。

Orchestration Agents

エージェント	優先モデル（連鎖の先頭）	役割
Atlas order: 4	`claude-sonnet-4-6`	Todo リストオーケストレーター。計画済みタスクを体系的に実行・管理・調整。Kimi / GPT-5.5 / Minimax などへフォールバック。
Sisyphus-Junior	カテゴリ依存	カテゴリ生成エグゼキューター。タスクカテゴリ（visual-engineering / quick / deep など）に基づきモデルを自動選択。

実際に選ばれるモデルは接続プロバイダと可用性に依存する。上表のコードはフォールバック連鎖の先頭候補（上流のモデル要件定義に準拠）。 Tab 切り替え時のコア順序は固定: Sisyphus (1) → Hephaestus (2) → Prometheus (3) → Atlas (4)。 @oracle など明示呼び出しも可能。

スキル & MCP

ビルトイン MCP（常時有効）

MCP	提供機能
Exa (websearch)	高精度 Web 検索。最新情報・技術ドキュメント・公式ページのリアルタイム取得。
Context7 (context7)	公式ライブラリドキュメントの直接参照。ハルシネーションなしの正確な API 情報。
Grep.app (grep_app)	GitHub 上のコード横断検索。OSS 実装例・パターンの即時発見。

スキル内蔵 MCP（Skill-Embedded MCPs）

MCP サーバーはコンテキストバジェットを消費する。oh-my-openagent はこれを解決した。

スキルが独自の MCP サーバーを内包。タスクスコープでオンデマンド起動し、完了と同時に終了。コンテキストウィンドウは常にクリーンに保たれる。

オンデマンド起動タスク完了で自動終了コンテキスト汚染なし

ビルトインスキル

playwright

ブラウザ自動化

Playwright MCP を内蔵。UI テスト・Web スクレイピング・インタラクション自動化。

git-master

アトミックコミット

段階的コミット・rebase 手術・変更粒度の最適化。

frontend-ui-ux

デザインファースト UI

visual-engineering カテゴリと連携した UI/UX 特化スキル。

カスタムスキル

独自スキルの追加

.opencode/skills/*/SKILL.md または ~/.config/opencode/skills/*/SKILL.md に配置するだけ。

Claude Code 互換性

フック・コマンド・スキル・エージェント・MCP・プラグイン、すべてそのまま動作する。 Claude Code の設定を移行する必要なし。既存の投資を無駄にしない。

インストール & 設定

インストール（人間向け）

LLM エージェント（Claude Code、Cursor など）にペーストするだけ。人間が設定を手打ちするより確実。

エージェントへのペースト用プロンプト

Install and configure oh-my-opencode by following the instructions here:
https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

インストール（LLM エージェント向け）

bash

curl -fsSL https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

設定ファイル

パス	説明
`~/.config/opencode/oh-my-openagent.jsonc`	グローバル設定（推奨）。コメント・末尾カンマ可。
`~/.config/opencode/oh-my-opencode.jsonc`	旧名バリアント。移行期間中は警告付きで読み込まれる。
`.opencode/oh-my-openagent.jsonc`	プロジェクトローカル設定。グローバルを上書き。
`.opencode/oh-my-opencode.jsonc`	プロジェクト側の旧名バリアント。

同一ディレクトリに oh-my-opencode.* と oh-my-openagent.* が両方ある場合、上流の互換レイヤーでは現状 oh-my-opencode.* が先に読まれる（configuration.md 参照）。

設定例

oh-my-openagent.jsonc

{
  // Tmux 統合を有効化
  "tmux": {
    "enabled": true,
    "layout": "main-vertical"
  },
  // 背景エージェントの同時実行数制限
  "background_tasks": {
    "max_concurrent_per_provider": 3
  },
  // 特定フックを無効化
  "disabled_hooks": ["comment-checker"],
  // エージェントをオーバーライド
  "agents": {
    "sisyphus": {
      "model": "opencode-go/kimi-k2.5"
    }
  }
}

アンインストール

bash — opencode.json からプラグインを除去

jq '.plugin = [.plugin[] | select(. != "oh-my-openagent" and . != "oh-my-opencode")]' \
    ~/.config/opencode/opencode.json > /tmp/oc.json && \
    mv /tmp/oc.json ~/.config/opencode/opencode.json

参考リンク

公式・コミュニティ

GitHub リポジトリ — ソース・Issue
npm: oh-my-opencode — 公式ガイドの主軸（npm i -g oh-my-opencode）
npm: oh-my-openagent — 同一系の別パッケージ名（npm i -g oh-my-openagent）
DeepWiki — AI 生成ドキュメント
Discord — コミュニティ
姉妹プロジェクト: oh-my-codex · oh-my-claudecode