要約すると、これは単なる最小限のチャットCLIではありません。Piからフォークされ、ネイティブツール、Bun、TypeScriptパッケージ、Rustクレート、そしてモデルによる編集をより確実に反映させるために設計された一連のファーストパーティツールを中心に再構築された、至れり尽くせりのエージェントハーネスです。
Get the latest on AI, LLMs & developer tools
New MCP servers, model updates, and guides like this one — delivered weekly.
編集メモ
この記事は、2026年6月3日時点で調査したGitHubリポジトリ、README、ドキュメント、パッケージメタデータ、npmメタデータ、リリース/タグ情報、ソースツリー、現在のIssue、および現在のPRに基づいています。この動きの速いリポジトリではリリース、npm、タグ、ソースのメタデータが一時的に乖離することがあるため、バージョンの記述には注意を払っています。
1. oh-my-pi を一言で
Oh My Piは、MITライセンスのターミナルコーディングエージェントであり、TypeScript/Bunランタイム、Rustネイティブ操作、モデル/プロバイダールーティング、ハッシュライン編集、LSP/DAP、サブエージェント、ブラウザ/ウェブ/GitHubツール、メモリ、エディタ/SDK/RPCサーフェスを備えています。
| 領域 | 詳細 | 重要な理由 |
|---|---|---|
| リポジトリ | can1357/oh-my-pi | https://github.com/can1357/oh-my-pi |
| 主な言語 | TypeScript | 調査時点での GitHub 上の主な言語。 |
| ライセンス | MIT | 同梱物やバイナリのライセンスは必要に応じて別途確認してください。 |
| 作成日 | 2025年12月31日 | 最新のGitHubリリースを確認:2026年6月2日時点でv15.8.0。ソース/タグのメタデータはすでにv15.8.1へ移行中でした。 |
2. なぜ重要か
Oh My Piが重要なのは、モデルの選択だけでなく、ハーネス(基盤)の問題に焦点を当てているからです。READMEでは、編集フォーマット、読み取り/検索のデフォルト設定、LSPフィードバック、デバッガーアクセス、およびツールのセマンティクスが実際のコーディング作業と一致している場合に、モデルのパフォーマンスが劇的に向上すると主張しています。
このプロジェクトは非常に広範です。単なるファイルの読み書きやシェルにとどまらず、LSP、DAP、永続的な評価カーネル、ブラウザ、ウェブ検索、GitHubパス、競合解決、メモリ、プレビュー/承認ワークフロー、サブエージェントのファンアウト、そして負荷の高い操作のためのネイティブRustコアが含まれています。
その広範さは、このツールを試す理由であると同時に、慎重にテストすべき理由でもあります。エージェントが管理するサーフェスが増えるほど、プロバイダーの互換性、ターミナルの挙動、OSの挙動、ツールの権限、および状態管理が重要になります。
3. アーキテクチャとメンタルモデル
Oh My Piは、TypeScriptパッケージ、Rustクレート、Pythonサポート、ドキュメント、スクリプト、およびBun指向のCLIパッケージを含むモノレポです。`omp`バイナリは`@oh-my-pi/pi-coding-agent`として公開されており、Rustクレートはシェル、AST、検索、ファイルシステム、画像、およびトークン負荷の高いタスクのためのネイティブ操作を提供します。
| 領域 | 詳細 | 重要な理由 |
|---|---|---|
| CLIパッケージ | `@oh-my-pi/pi-coding-agent` | `omp` コマンドおよび SDK/RPC/ACP サーフェスを公開します。 |
| ランタイムパッケージ | `packages/*` | Agent TARS コア、AI プロバイダー、TUI、ネイティブバインディング、スウォーム拡張、および関連ライブラリ。 |
| ネイティブレイヤー | `crates/*` | シェル、AST、分離、検索、およびパフォーマンスが重要なツール向けの Rust ベースの操作。 |
| 編集モデル | Hashline/content-hash アンカー | 陳腐化や失敗した文字列置換パッチを削減することを目的としています。 |
| IDEレイヤー | LSPおよびDAPツール | 診断、名前変更、参照、コードアクション、ブレークポイント、スタック、変数、およびステップ実行。 |
| 調整 | サブエージェント、IRC、タスク、メモリ | 並列ワーカー、型付き結果、エージェント間通信、およびHindsightメモリ。 |
| 外部ツール | ブラウザ、ウェブ検索、GitHub、MCPライクな統合ポイント | オプション/ゲート付きツールにより、エージェントの機能をローカルファイル以外にも拡張します。 |
4. 最小のエンドツーエンド設定
以下のコマンドはリポジトリのドキュメントから引用し、現在の調査スナップショットと照合したものです。本番環境に導入する前に、出発点として扱い、リンク先の README も読んでください。
# macOS / Linux
curl -fsSL https://omp.sh/install | sh
# Bun install
bun install -g @oh-my-pi/pi-coding-agent
# Windows PowerShell
irm https://omp.sh/install.ps1 | iex
# Pinned versions with mise
mise use -g github:can1357/oh-my-pi重要なデータや大規模なワークスペースに接続する前に、小さな最初のタスクで統合を確認してください。
# Shell completions
eval "$(omp completions zsh)"
eval "$(omp completions bash)"
omp completions fish > ~/.config/fish/completions/omp.fish
# Basic mental model
cd your-project
omp
# Then choose provider/model settings and enable powerful tools only when needed.5. 技術的ディープダイブ
5.1 Hashline編集は失敗したパッチループを攻撃する
多くのコーディングエージェントが失敗するのは、意図した変更が間違っているからではなく、編集フォーマットが脆弱だからです。モデルが古い行を繰り返したり、空白が異なっていたり、ファイルが変更されていたり、置換文字列が2回出現したりします。
Oh My PiのREADMEはhashline編集を強調しています。モデルはすべての行を再入力する代わりに、コンテンツハッシュのアンカーを参照します。アンカーが乖離した場合、ファイルを破損させる前にパッチを拒否できます。これは強力なハーネスレベルのアイデアです。
Fragile edit:
replace "exact old text" with "new text"
Hash-anchored edit:
locate content anchor
verify anchor freshness
apply intended replacement
reject if stale5.2 LSPとDAPはターミナルをIDEサーフェスに変える
READMEの「IDEが組み込まれている」というフレーズは文字通りです。LSPツールを使用すると、エージェントは診断、参照、シンボルナビゲーション、名前変更、コードアクション、ワークスペースを認識した操作を利用できます。DAPツールを使用すると、lldb、debugpy、言語固有のアダプターなどのデバッガーを操作できます。
これは通常のシェルのみのエージェントとは異なる品質のループです。名前変更がインポートを壊した理由を推測する代わりに、エージェントは言語サーバーに問い合わせることができます。永遠にprint文を追加する代わりに、スタックフレームや変数を検査できます。
5.3 サブエージェントは文章だけでなく構造化された作業を返す
Oh My Piは、分離されたワークツリーに展開し、スキーマ検証されたオブジェクトを返すファーストクラスのサブエージェントについて説明しています。構造のない並列作業は多くの場合、マージ競合や曖昧な要約を生むため、これは重要です。
このリポジトリには、ライブエージェント間のIRCスタイルの通信や、サブエージェントの同時実行/認証ストレージに関する課題活動も含まれています。方向性は明確です。並列ワーカーはコア機能ですが、調整の仕組みはまだ急速に進化しています。
5.4 ネイティブツールは外部シェルバイナリへの依存を減らす
READMEでは、インプロセス検索、glob、find、シェルセッション、AST操作、およびRustベースのネイティブコンポーネントが強調されています。これにより、ユーザーの環境が `rg`、bash、grep、find、またはWSLの動作の適切な組み合わせに依存する度合いが軽減されます。
トレードオフとしてパッケージングの複雑さがあります。Bun/TypeScript/Rust/Pythonスタックは強力ですが、ランタイムバージョン、ネイティブバインディング、ターミナルの動作、およびOS固有のエッジケースが重要になります。
5.5 プロバイダーのルーティングは常に変化するターゲットです。
Oh My Piは多くのプロバイダーとモデルロールをサポートしています。最近のIssueやPRでは、Anthropicの努力ティア、Bedrock Mantle、MiniMax M3、OpenRouter/DeepSeekのスキーマの厳密さ、カスタムベースURL、およびスタートアップモデルキャッシュに関する継続的な取り組みが見られます。
これは2026年の本格的なマルチプロバイダーコーディングエージェントとしては正常なことです。また、Oh My Piを評価する最良の方法は、機能リストを読むことだけではありません。インストールし、1つのプロバイダーを選択し、小さなタスクを実行して、使用予定のプロバイダーとツールの組み合わせを正確に検証してください。
6. 実運用での誤りと正解パターン
| 誤り | 正しい対応 | 理由 |
|---|---|---|
| 初日からすべての強力なツールを有効にしてください。 | デフォルトセットから開始し、その後、ブラウザ、GitHub、メモリ、および探索ツールを意図的に有効にしてください。 | READMEには、一部のツールが設定で制限されているか、デフォルトでオフになっていることが記載されています。 |
| リリース、タグ、npm、およびパッケージのバージョンは常に同一であると見なしてください。 | デバッグ時には、インストールした正確なソースを確認してください。 | 高速リリースでは、チャネル間で一時的に乖離が生じることがあります。 |
| チャットボックスのようにのみ使用してください。 | タスクに応じて、LSP、DAP、hashline編集、レビュー、およびサブエージェントを活用してください。 | ハーネスの価値はツールにあります。 |
| ターミナルの機能はどこでも同じように動作すると想定してください。 | ターミナル、OS、クリップボード、貼り付け、画像、およびシェルの動作をスモークテストしてください。 | 最近の課題では、VTEのスクロールバック、Windowsでの画像貼り付け、およびプラットフォームの動作が取り上げられました。 |
7. よくあるミスと現在の課題
これらのリポジトリは若く、動きが速いため、Issue Tracker は重要です。この記事では Issues をリスクシグナルとして扱い、プロジェクトが使えない証拠としては扱いません。
| 領域 | 詳細 | 重要な理由 |
|---|---|---|
| バージョンの乖離 | v15.8.0が最新のリリース/npmでしたが、ソース/タグのメタデータは先行していました。 | 再現可能なレポートのためにバージョンを固定してください。 |
| Bunの要件 | パッケージのメタデータにはBun >= 1.3.14が必要です。 | Node専用のランタイムパスを前提としないでください。 |
| プロバイダーのスキーマ変更 | DeepSeek/OpenRouterのnull許容スキーマ、MiniMax、Bedrock、およびAnthropicの努力階層に関する問題。 | プロバイダーアダプターには継続的なメンテナンスが必要です。 |
| ターミナルの動作 | 最近の問題には、VTEのフラッシュ/スクロールバックや画像の貼り付け動作が含まれます。 | 実際のターミナルでテストしてください。 |
| サブエージェントの認証/ストレージ | PRは、スウォーム認証ストレージの再利用と検出をカバーしています。 | 並列ワーカーの配管(plumbing)がアクティブになっています。 |
| ツールゲート | 一部の組み込みツールは、設定されるまで無効になっています。 | 組み込み=アクティブとは限りません。 |
8. 性能、スケーリング、コストのメモ
Oh My Piのパフォーマンスに関するテーゼは、優れたツールがモデルのパス率を向上させ、再試行ループを削減するというものです。ハッシュライン編集、要約された読み取り、高速検索、LSPフィードバック、デバッガーアクセスは、わずかなトークン速度の向上よりも多くの時間を節約できます。
ランタイム自体は広範です:TypeScript用のBun、Rustネイティブコンポーネント、永続的な評価カーネル、そしてTUI。これらは高速ですが、ネイティブパッケージングとターミナルの互換性は評価の一部であるべきです。
サブエージェントは、分離可能なタスクの壁時計時間を短縮できます。また、プロバイダーの呼び出しと調整のオーバーヘッドを増大させる可能性もあります。真に独立した調査、レビュー、または実装スライスに対して使用してください。
9. 誰に向いているか
| 使うべき場合 | 避けるべき場合 |
|---|---|
| 本格的なIDEグレードのツールを備えたターミナルコーディングエージェントが必要です。 | 可能な限り最小のチャットCLIが必要です。 |
| 編集の信頼性、LSP診断、デバッガー制御、および構造化されたサブエージェントを重視する方へ。 | 環境内にBunやネイティブツールをインストールできない場合。 |
| 進化の速いツールを好み、デバッグ中にバージョンを固定できる方へ。 | エンタープライズ向けの緩やかなリリースサイクルが必要な場合。 |
| ファイル、シェル、ブラウザ、Web、GitHub、メモリ、レビューを統合した単一のエージェントインターフェースを求める場合。 | 広範なローカル自動化ツールの使用がポリシーで禁止されている場合。 |
10. コミュニティのシグナル
リポジトリのIssueやPRの更新頻度が高く、実装重視であること。最近の取り組みには、プロバイダーの努力階層、自動ルーティング、思考レンダラー、モデルキャッシュ、VTE修正、スキーマ正規化、スウォーム認証動作などが含まれます。
そのスピードは、最先端のエージェントツールを求めるユーザーにとっては良い兆候です。一方で、バージョンを固定し、変更履歴を読み、プロバイダーやターミナルの統合において時折発生するリグレッションを想定しておくべきという警告でもあります。
READMEは非常に独自の主張が強く、ツール設計、編集フォーマット、LSP、DAP、ネイティブ操作を主な差別化要因として扱っています。これに同意できるかどうかは、現在使用しているエージェントが不適切な編集や弱いツールフィードバックによって失敗しているかどうかに依存します。
11. 結論: 使う価値はあるか
私たちの見解
ハルネス(harness)自体が製品である強力なターミナルエージェントを求めるなら、Oh My Piを使用してください。ハッシュライン編集、LSP/DAP、ネイティブ検索、サブエージェント、ブラウザ/Web/GitHub、メモリを備えています。最小限で保守的、かつプロバイダーが安定したツールが必要な場合や、Bun/ネイティブランタイムの前提条件をサポートできない場合は、避けてください。
12. 大きな流れ
Oh My Piは、次世代のコーディングエージェントの波の一部であり、単なるチャットラッパーではなく、よりプログラム可能な開発環境を目指しています。このエージェントは単に回答するだけでなく、読み取り、編集、デバッグ、検索、レビュー、委任、そして記憶を行います。
競争の最前線はツールセマンティクスにあります。モデルは常に変化し続けますが、信頼性の高い編集プリミティブ、コードインテリジェンス、および制限された権限をモデルに提供できるエージェントは、弱いハーネスに縛られた強力なモデルよりも優れたパフォーマンスを発揮できます。
13. よくある質問
Q: `omp`とは何ですか?
`omp`は、`@oh-my-pi/pi-coding-agent`パッケージを通じて公開されているターミナルコーディングエージェント、Oh My Piのコマンドラインエントリーです。
Q: Oh My PiはPiと何が違うのですか?
READMEによると、これはMario Zechner氏のPiのフォークであり、プロバイダールーティング、ハッシュライン編集、LSP/DAP、ネイティブツール、サブエージェント、ブラウザ/検索、メモリ、ACPなど、多くの機能が追加されています。
Q: Bunは必要ですか?
はい、README/パッケージメタデータではBunがランタイム要件として扱われており、Bunのグローバルインストールが推奨されるパッケージパスとなっています。
Q: ハッシュライン編集とは何ですか?
これはコンテンツハッシュによって固定された編集手法であり、古くなった文字列や曖昧な文字列の置換によってファイルが破損するのを防ぐように設計されています。
Q: サブエージェントを実行できますか?
はい。READMEには、分離されたワークツリーで実行され、スキーマ検証済みの結果を返すファーストクラスのサブエージェントについて記載されています。
Q: デフォルトでオフになっているツールはどれですか?
READMEによると、GitHub、画像検査、Mermaidレンダリング、チェックポイント/巻き戻し、ツール検出、メモリツールなどのツールは設定で制限されており、意図的に有効にする必要があります。
Q: バージョンが異なるのはなぜですか?
プロジェクトの進行が速いため、GitHub Releases、npm、タグ、ソースパッケージファイルで一時的に異なるバージョンが表示されることがあります。インストールされている正確なバージョンを固定して報告してください。
14. 用語集
| 領域 | 詳細 | 重要な理由 |
|---|---|---|
| Hashline | コンテンツハッシュで固定された編集フォーマット。 | パッチの失敗や陳腐化を減らすように設計されています。 |
| LSP | Language Server Protocol。 | 診断、参照、名前変更、シンボル、およびコードアクション。 |
| DAP | Debug Adapter Protocol。 | ブレークポイント、ステップ実行、スタックフレーム、変数。 |
| ACP | Agent Client Protocol/エディタ駆動型サーフェス。 | エディタからエージェントを操作可能にする。 |
| サブエージェント | 並列ワーカーエージェント。 | 構造化された結果を返すことができる。 |
| Hindsight | READMEで参照されているメモリシステム。 | プロジェクトの事実を保持/想起/反映する。 |
| VTE | 一部のLinuxターミナルで使用されているターミナルウィジェットスタック。 | 最近のスクロールバック/レンダリングの問題に関連。 |
15. すべてのソースとリンク
Issues および PR
著者コンテキスト
内部リンク
16. ソース帰属表
| 領域 | 詳細 | 重要な理由 |
|---|---|---|
| README | インストールパス、ツールサーフェス、機能の主張、モデル/プロバイダーのフレーミング。 | 一次ソース。 |
| パッケージメタデータ | Bunの要件、npmパッケージ、バージョン詳細。 | 一次ソース。 |
| ソースツリー | モノレポパッケージ、Rustクレート、Pythonサポート、ドキュメント構成。 | アーキテクチャソース。 |
| Issue/PR | プロバイダー、ターミナル、サブエージェント、およびスキーマに関する注意点。 | 鮮度シグナル。 |
| リリース/npm/タグデータ | 高速なリリースサイクルとバージョンの乖離。 | バージョンソース。 |
Get the Ultimate Antigravity Cheat Sheet
Join 5,000+ developers and get our exclusive PDF guide to mastering Gemini 3 shortcuts and agent workflows.
Related Guides
Humanizer Skill Guide
blader/humanizer: 29 AI-writing patterns, voice calibration, and a two-pass audit, all in one Claude Code skill.
Guides & FeaturesMastering Agent Skills
The open standard for portable AI agent expertise.
Guides & FeaturesAntigravity Workflows Guide
Create automation recipes with Turbo Mode and AgentKit 2.0.
Guides & FeaturesHow to Change Antigravity Themes
Customize themes, dark mode, icons, and color schemes.
Guides & FeaturesHow to Change Language
Switch Antigravity to Spanish, German, Japanese, and more.
Guides & FeaturesAntigravity Security Guide
Known vulnerabilities, safe settings, and hardening steps.
