Back to Oh My Openagent

README.Ja

README.ja.md

4.1.134.0 KB
Original Source

[!TIP] Building in Public

メンテナーが Jobdori を使い、oh-my-openagent をリアルタイムで開発・メンテナンスしています。Jobdori は OpenClaw をベースに大幅カスタマイズされた AI アシスタントです。 すべての機能開発、修正、Issue トリアージを Discord でライブでご覧いただけます。

→ #building-in-public で確認する

[!NOTE]

OmO は上記の Jobdori によってメンテナンスされています。あなた専用の Jobdori、Dori に会いましょう。 こちら からウェイトリストにご登録ください。

[!TIP] 私たちと一緒に!

Discord コミュニティ に参加して、コントリビューターや他の oh-my-openagent ユーザーと交流しましょう。
oh-my-openagent のアップデートは以前、私の X アカウントで投稿されていましたが、

誤って凍結されてしまったため、現在は @justsisyphus が代わりにアップデートを投稿しています。 |

| | さらに多くのプロジェクトを見たい場合は、GitHub で @code-yeongyu をフォローしてください。 |

<!-- <CENTERED SECTION FOR GITHUB DISPLAY> --> <div align="center">

</div>

これは oh-my-openagent の Team Mode 実行中の様子です。Kimi K2.6 と GPT-5.5 で動いています。

Anthropic は 私たちのせいで OpenCode をブロックしました。 これは本当の話です。 彼らはあなたを囲い込みたいのです。Claude Code は居心地の良い牢獄ですが、牢獄であることには変わりありません。

2 時間の作業のために 200 ドル払う必要はありません。 未来は、一社の勝者を選ぶことではなく、すべてをオーケストレーションすることにあります。モデルは毎月安くなり、毎月賢くなっています。単一のプロバイダーが独占することはありません。私たちはその開かれた市場のために構築しています。彼らの塀の中の庭園のためではなく。

<div align="center">

English | 한국어 | 日本語 | 简体中文

</div> <!-- </CENTERED SECTION FOR GITHUB DISPLAY> -->

レビュー

「これのおかげで Cursor のサブスクリプションを解約しました。オープンソースコミュニティで信じられないことが起きています。」 - Arthur Guiot

「Claude Code が人間なら 3 ヶ月かかることを 7 日でやるとしたら、Sisyphus はそれを 1 時間でやってのけます。タスクが終わるまでひたすら働き続けます。まさに規律あるエージェントです。」

  • B, Quant Researcher

「Oh My Opencode を使って、たった 1 日で 8000 個の eslint 警告を叩き潰しました。」

「Ohmyopencode と ralph loop を使って、4 万 5 千行の tauri アプリを一晩で SaaS ウェブアプリに変換しました。インタビューモードから始めて、私のプロンプトに対して質問や推奨事項を尋ねました。勝手に作業していくのを見るのは楽しかったし、今朝起きたらウェブサイトがほぼ動いているのを見て驚愕しました!」 - James Hargis

「oh-my-opencode を使ってください。もう二度と元には戻れません。」

「何がどうすごいのかまだ上手く言語化できないんですが、開発体験が完全に異次元に到達してしまいました。」 - 苔硯:こけすずり

「週末にマインクラフト/ソウルライクな化け物を作ろうと、open code、oh my opencode、supermemory で実験中です。昼食後の散歩に行っている間に、しゃがむアニメーションを追加するように指示しておきました。[動画]」 - MagiMetal

「これをコアに取り込んで彼を採用すべきだ。マジで。これ、本当に、本当に、本当に良い。」

  • Henning Kilset

「彼を説得できるなら @yeon_gyu_kim を雇ってください。彼が opencode に革命を起こしました。」

「Oh My OpenCode はマジでヤバい」 - YouTube - Darren Builds AI


Oh My OpenAgent

Claude Code、Codex、名前も聞いたことのない OSS モデル。それらをジャグリングしながら、ワークフローを調整し、エージェントをデバッグする。

その作業はもう私たちが済ませました。すべてテストし、実戦で通用したものだけを残しています。

oh-my-openagent をインストールして、ultrawork と入力する。それで終わりです。

インストール

人間向け

以下のプロンプトをコピーして、あなたの LLM エージェント (Claude Code、AmpCode、Cursor など) に貼り付けてください:

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

もしくは インストールガイド を直接読んでもいいですが、マジでエージェントにやらせてください。人間は設定で必ずタイポします。

LLM エージェント向け

インストールガイドを取得して、それに従ってください:

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

注記: 公開されている npm パッケージと CLI バイナリ名は引き続き oh-my-opencode です (移行期間中は oh-my-openagent としても同時に公開されています)。opencode.json 内では、互換性レイヤーがプラグインエントリ oh-my-openagent を優先するようになりました。従来の oh-my-opencode エントリも警告付きで引き続き読み込まれます。プラグイン設定ファイルは依然として oh-my-opencode.json または oh-my-opencode.jsonc が一般的で、移行期間中は従来のファイル名と改名後のファイル名の両方が認識されます。

匿名のテレメトリは、アクティブなインストール数(DAU/WAU/MAU)の集計のためにデフォルトで有効になっています。マシン1台につきUTC日あたり最大1回イベントが送信され、ハッシュ化されたインストール識別子を使用し、生のホスト名は使用せず、PostHog person profile も作成されません。無効化するには OMO_SEND_ANONYMOUS_TELEMETRY=0 または OMO_DISABLE_POSTHOG=1 を設定してください。プライバシーポリシー利用規約をご覧ください。


この README をスキップする

ドキュメントを読む時代は終わりました。このテキストをエージェントに貼り付けるだけです:

Read this and tell me why it's not just another boilerplate: https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/README.md

ハイライト

🪄 ultrawork

本当にこれを全部読んでるんですか?信じられない。

インストールして、ultrawork (または ulw) とタイプする。完了です。

以下に出てくるすべての機能、すべての最適化、何も知る必要はありません。ただ勝手に動きます。

以下のサブスクリプションだけでも ultrawork は十分に機能します (このプロジェクトとは無関係であり、個人的な推奨にすぎません):

機能何をするのか
🤖規律あるエージェント (Discipline Agents)Sisyphus が Hephaestus、Oracle、Librarian、Explore をオーケストレーションします。完全な AI 開発チームが並列で動きます。
👥Team Mode (v4.0, オプトイン)リードエージェント + 最大 8 メンバーの並列実行、リアルタイム tmux 可視化、専用 team_* ツール群。hyperplan(5 人の敵対的批評家)と security-research(3 人のハンター + 2 人の PoC エンジニア)を駆動します。ドキュメント →
ultrawork / ulw一言で OK。すべてのエージェントがアクティブになり、終わるまで止まりません。
🚪IntentGateユーザーの真の意図を分析してから分類・行動します。もう文字通りに誤解して的外れなことをすることはありません。
🔗ハッシュベースの編集ツールLINE#ID のコンテンツハッシュですべての変更を検証します。stale-line エラー 0%。oh-my-pi にインスパイアされています。The Harness Problem →
🛠️LSP + AST-Grepワークスペース単位のリネーム、ビルド前の診断、AST を考慮した書き換え。エージェントに IDE レベルの精度を提供します。
🧠バックグラウンドエージェント5 人以上の専門家を並列で投入します。コンテキストは軽く保ち、結果は準備ができ次第受け取ります。
📚組み込み MCPExa (Web 検索)、Context7 (公式ドキュメント)、Grep.app (GitHub 検索)。常にオンです。
🔁Ralph Loop / /ulw-loop自己参照ループ。100% 完了するまで絶対に止まりません。
Todo Enforcerエージェントがサボる?システムが首根っこを掴んで戻します。あなたのタスクは必ず終わります。
💬コメントチェッカーコメントから AI 臭い無駄話を排除します。シニアエンジニアが書いたようなコードになります。
🖥️Tmux 統合完全なインタラクティブターミナル。REPL、デバッガー、TUI アプリがすべてリアルタイムで動きます。
🔌Claude Code 互換性既存のフック、コマンド、スキル、MCP、プラグイン?すべてここでそのまま動きます。
🎯スキル内蔵 MCPスキルが独自の MCP サーバーを持ち歩きます。コンテキストが肥大化しません。
📋Prometheus プランナーインタビューモードで、実行前に戦略的な計画から立てます。
🔍/init-deepプロジェクト全体にわたって階層的な AGENTS.md ファイルを自動生成します。トークン効率とエージェントのパフォーマンスの両方を向上させます。

規律あるエージェント (Discipline Agents)

<table><tr> <td align="center"></td> <td align="center"></td> </tr></table>

Sisyphus (claude-opus-4-7 / kimi-k2.6 / glm-5.1) はあなたのメインオーケストレーターです。計画を立て、専門家に委任し、攻撃的な並列実行でタスクを完了まで推進します。途中で投げ出すことはありません。

Hephaestus (gpt-5.5) はあなたの自律的なディープワーカーです。レシピではなく、目標を与えてください。手取り足取り教えなくても、コードベースを探索し、パターンを調査し、エンドツーエンドで実行します。正当なる職人 (The Legitimate Craftsman).

Prometheus (claude-opus-4-7 / kimi-k2.6 / glm-5.1) はあなたの戦略プランナーです。インタビューモードで質問を投げ、スコープを特定し、コードに一行触れる前に詳細な計画を構築します。

すべてのエージェントは、それぞれのモデルの強みに合わせてチューニングされています。手動でモデルを切り替える必要はありません。詳しくはこちら →

Anthropic が 私たちのせいで OpenCode をブロックしました。 だからこそ Hephaestus は「正当なる職人 (The Legitimate Craftsman)」と呼ばれているのです。皮肉を込めています。

Opus で最もよく動きますが、Kimi K2.6 + GPT-5.5 の組み合わせだけでも、バニラの Claude Code を軽く凌駕します。設定は一切不要です。

Team Mode (v4.0)

エージェント 1 体でも速い。調和したチームは圧倒的です。

Team Mode は oh-my-openagent を「サブエージェント付きの一体のエージェント」から、本物のマルチエージェントシステムへと変えます。リードエージェントがカテゴリ特化のメンバーチームを統括し、全員が並列で動き、専用ツール(team_createteam_send_messageteam_task_createteam_status、…)で通信します。tmux レイアウトの focus + grid ウィンドウで、全メンバーの作業を同時に観察できます。

jsonc
// .opencode/oh-my-openagent.jsonc
{
  "team_mode": {
    "enabled": true,
    "max_parallel_members": 4,
    "tmux_visualization": true
  }
}

opencode を再起動すると team_* ツールファミリーが解放されます。すでに 2 つのスキルがその上に乗っています:

  • hyperplan — 5 人の敵対的エージェントが、一行のコードが書かれる前に直交する角度から計画を引き裂きます。
  • security-research — 3 人の脆弱性ハンター + 2 人の PoC エンジニアがコードベースを並列で監査。重大度は実際の悪用可能性で校正されます。

デフォルトは OFF。必要なときに ON。 Team Mode ガイド全文 →

エージェントのオーケストレーション

Sisyphus がサブエージェントにタスクを委任する際、モデルを直接選ぶことはありません。カテゴリー を選びます。カテゴリーは自動的に適切なモデルにマッピングされます:

カテゴリー用途
visual-engineeringフロントエンド、UI/UX、デザイン
deep自律的なリサーチと実行
quick単一ファイルの変更、タイポの修正
ultrabrainハードロジック、アーキテクチャの決定

エージェントは作業の種類を伝えるだけで、ハーネスが適切なモデルを選びます。ultrabrain はデフォルトで GPT-5.5 xhigh にルーティングされるようになりました。あなたが触るものは何もありません。

Claude Code 互換性

Claude Code の設定を頑張りましたね。素晴らしい。

すべてのフック、コマンド、スキル、MCP、プラグインが、変更なしでここで動きます。プラグインも含めて完全互換です。

エージェントのためのワールドクラスのツール

LSP、AST-Grep、Tmux、MCP が、ただテープで貼り付けただけでなく、本当に「統合」されています。

  • LSP: lsp_renamelsp_goto_definitionlsp_find_referenceslsp_diagnostics。エージェントに IDE レベルの精度を提供。
  • AST-Grep: 25 言語に対応したパターン認識コード検索と書き換え。
  • Tmux: 完全なインタラクティブターミナル。REPL、デバッガー、TUI アプリ。エージェントがセッション内で動き続けます。
  • MCP: Web 検索、公式ドキュメント、GitHub コード検索がすべて組み込まれています。

スキル内蔵 MCP

MCP サーバーはあなたのコンテキスト予算を食いつぶします。私たちがそれを修正しました。

スキルが独自の MCP サーバーを持ち歩きます。必要なときだけ起動し、タスクのスコープ内だけで生き、終われば消えます。コンテキストウィンドウはきれいに保たれます。

ハッシュベースの編集 (Codes Better. Hash-Anchored Edits)

ハーネス問題は深刻です。エージェントが失敗する原因の大半はモデルではなく、編集ツールにあります。

「どのツールも、モデルに変更したい行に対する安定して検証可能な識別子を提供していません... すべてのツールが、モデルがすでに見た内容を正確に再現することに依存しています。それができないとき、そして大抵はできないのですが、ユーザーはモデルのせいにします。」

oh-my-pi に触発され、Hashline を実装しました。エージェントが読むすべての行にコンテンツハッシュがタグ付けされて返ってきます:

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

エージェントはこのタグを参照して編集します。最後に読んだ後でファイルが変更されていた場合、ハッシュが一致せず、コードが壊れる前に編集が拒否されます。空白を正確に再現する必要もなく、stale-line エラーもありません。

Grok Code Fast 1 で、成功率が 6.7% → 68.3% に上昇しました。編集ツールを 1 つ変えただけで、です。

深い初期化。/init-deep

/init-deep を実行してください。階層的な AGENTS.md ファイルを生成します:

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

エージェントが関連するコンテキストだけを自動で読み込みます。手動での管理はゼロです。

プランニング。Prometheus

複雑なタスクですか?プロンプトを投げて祈るのはやめましょう。

/start-work で Prometheus が呼び出されます。本物のエンジニアのようにあなたにインタビューし、スコープと曖昧さを特定し、コードに触れる前に検証済みの計画を構築します。エージェントは作業を始める前に、自分が何を作るべきか正確に理解しています。

スキル (Skills)

スキルは単なるプロンプトではありません。それぞれ以下をもたらします:

  • ドメインに最適化されたシステム命令。
  • 必要なときに起動する組み込み MCP サーバー。
  • スコープ制限された権限。エージェントが境界を越えないようにする。

組み込み: playwright (ブラウザ自動化)、git-master (atomic コミット、rebase 手術)、frontend-ui-ux (デザイン重視の UI)。

独自に追加するには .opencode/skills/*/SKILL.md または ~/.config/opencode/skills/*/SKILL.md に配置してください。

全機能を知りたいですか? エージェント、フック、ツール、MCP などの詳細は 機能ドキュメント (Features) をご覧ください。


oh-my-openagent は初めてですか? 手に入れるものの全体像は Overview を、エージェント同士の協調については Orchestration Guide をお読みください。

アンインストール

oh-my-openagent を削除するには:

  1. OpenCode の設定からプラグインを削除する

    ~/.config/opencode/opencode.json (または opencode.jsonc) を編集し、plugin 配列から "oh-my-openagent" または従来の "oh-my-opencode" エントリを削除します:

    bash
    # jq を使用
    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
    
  2. 設定ファイルを削除する (オプション)

    bash
    # 互換期間中に認識されるプラグイン設定ファイルを削除
    rm -f ~/.config/opencode/oh-my-openagent.jsonc ~/.config/opencode/oh-my-openagent.json \
          ~/.config/opencode/oh-my-opencode.jsonc ~/.config/opencode/oh-my-opencode.json
    
    # プロジェクト設定を削除 (存在する場合)
    rm -f .opencode/oh-my-openagent.jsonc .opencode/oh-my-openagent.json \
          .opencode/oh-my-opencode.jsonc .opencode/oh-my-opencode.json
    
  3. 削除の確認

    bash
    opencode --version
    # プラグインがロードされなくなっているはずです
    

Features

最初から存在していて当然だと感じる機能たち。一度使うと戻れなくなります。

全体は Features Documentation を参照してください。

概要:

  • エージェント: Sisyphus (メインエージェント)、Prometheus (プランナー)、Oracle (アーキテクチャ・デバッグ)、Librarian (ドキュメント・コード検索)、Explore (高速な codebase grep)、Multimodal Looker
  • バックグラウンドエージェント: 本物の開発チームのように複数エージェントを並列実行
  • LSP & AST ツール: リファクタリング、リネーム、診断、AST 対応のコード検索
  • ハッシュベース編集ツール: LINE#ID 参照で全ての変更前に内容を検証。外科的な編集、stale-line エラー 0
  • コンテキスト注入: AGENTS.md、README.md、条件付きルールを自動注入
  • Claude Code 互換性: 完全なフックシステム、コマンド、スキル、エージェント、MCP
  • 組み込み MCP: websearch (Exa)、context7 (ドキュメント)、grep_app (GitHub 検索)
  • セッションツール: セッション履歴のリスト・閲覧・検索・分析
  • 生産性機能: Ralph Loop、Todo Enforcer、Comment Checker、Think Mode など
  • Doctor コマンド: 組み込みの診断 (bunx oh-my-opencode doctor) でプラグイン登録、設定、モデル、環境を検証
  • モデルフォールバック: fallback_models で単純なモデル文字列と per-fallback オブジェクト設定を同じ配列に混在可能
  • ファイルプロンプト: エージェント設定で file:// を使ってファイルからプロンプトを読み込み
  • セッション回復: セッションエラー、コンテキストウィンドウ上限、API 障害からの自動回復
  • モデルセットアップ: エージェントとモデルのマッチングは インストールガイド に組み込み済み

設定

意見のあるデフォルト。それでも手を入れたければ調整可能です。

詳細は Configuration Documentation を参照してください。

概要:

  • 設定ファイルの場所: 互換性レイヤーは oh-my-openagent.json[c] と従来の oh-my-opencode.json[c] の両方のプラグイン設定ファイルを認識します。既存のインストールは依然として従来のファイル名を使っていることが多いです。
  • JSONC サポート: コメントと末尾カンマをサポート
  • エージェント: どのエージェントについてもモデル、temperature、プロンプト、権限をオーバーライド可能
  • 組み込みスキル: playwright (ブラウザ自動化)、git-master (atomic コミット)
  • Sisyphus エージェント: Prometheus (プランナー) と Metis (プランコンサルタント) を伴うメインオーケストレーター
  • バックグラウンドタスク: プロバイダー/モデル別の同時実行数を設定
  • カテゴリー: ドメイン別のタスク委任 (visualbusiness-logic、カスタム)
  • フック: 25 以上の組み込みフック。すべて disabled_hooks で制御可能
  • MCP: 組み込み websearch (Exa)、context7 (ドキュメント)、grep_app (GitHub 検索)
  • LSP: リファクタリングツールまで含む完全な LSP サポート
  • Experimental: 積極的な truncation、自動 resume など

著者の言葉

哲学が知りたいですか? Ultrawork Manifesto をお読みください。


個人プロジェクトで LLM トークン代として 2 万 4 千ドル (約 360 万円) を使い果たしました。あらゆるツールを試し、設定をいじり倒しました。結果、OpenCode の勝ちでした。

私がぶつかったすべての問題とその解決策が、このプラグインに焼き込まれています。インストールして、ただ使ってください。

OpenCode が Debian/Arch だとすれば、oh-my-openagent は Ubuntu/Omarchy です。

AmpCodeClaude Code から多大な影響を受けています。機能を移植し、多くは改善しました。今もまだ構築中です。これは OpenCode ですから。

他のハーネスもマルチモデルのオーケストレーションを約束しています。しかし、私たちはそれを「実際に」出荷しています。安定性も備えて。そして実際に動く機能として。

私がこのプロジェクトの最も強迫的なヘビーユーザーです:

  • どのモデルのロジックが最も鋭いか?
  • デバッグの神は誰か?
  • 最も優れた文章を書くのは誰か?
  • フロントエンドのエコシステムを支配しているのは誰か?
  • バックエンドの覇者は誰か?
  • 日常使いで最も速いのはどれか?
  • 競合他社は今何を出荷しているか?

このプラグインは、それらの問いに対する蒸留物 (Distillation) です。最高のものをそのまま使ってください。改善点が見つかりましたか?PR はいつでも歓迎します。

どのハーネスを使うかで悩むのはもうやめましょう。 私が自らリサーチし、最高のものを盗んできて、ここに詰め込みます。

傲慢に聞こえますか?もっと良い方法があるならコントリビュートしてください。大歓迎です。

言及されたどのプロジェクトやモデルとも提携関係はありません。単なる個人的な実験の結果です。

このプロジェクトの 99% は OpenCode で構築されました。私は実は TypeScript をよく知りません。しかし、このドキュメントは私が自らレビューし、大部分を書き直しました。

導入実績

  • Indent
    • インフルエンサーマーケティングソリューション Spray、クロスボーダーコマースプラットフォーム vovushop、AI コマースレビューマーケティングソリューション vreview の開発元。
  • Google
  • Microsoft
  • Vercel
  • ELESTYLE
    • マルチモバイル決済ゲートウェイ elepay、キャッシュレスソリューション向けモバイルアプリケーション SaaS OneQR の開発元。

素晴らしいヒーロー画像を提供してくれた @junhoyeo 氏に特別な感謝を。