Omnigentは、Claude Code・Codex・Piなど複数のコーディングエージェントを切り替え可能なCLIとして統合する、オープンソースのAIエージェント・フレームワークです。リポジトリにはCLI本体に加え、harnessのインストール検証・サンドボックス実行・Issue優先度付けなど運用自動化の仕組みが大量に含まれています。提供された資料からは、製品コードそのものより周辺の検証・CI基盤が多く確認できます。
中核はomnigent CLIで、verify_cli.pyの記述によるとOMNIGENT_CONFIG_HOMEとOMNIGENT_DATA_DIRという環境変数で設定・データ領域をサンドボックス化し、実機の~/.omnigentを汚さずに動作します。harnessの取得は.github/actions/setup-harness-cliが担当し、@anthropic-ai/claude-codeや@openai/codexなどのnpmパッケージをバージョンとlockファイルのintegrityで固定し、プラットフォーム・バージョン・lockダイジェストからキャッシュキーを作ります。setup-harness-cli.test.mjsは、この固定値がci-depsとlockファイルで一致することを機械的に検証しています。.claude/skills以下のSKILL.mdはharnessごとのe2e手順を定義し、verify_cli.pyはpexpectで実際のPTYにCLIを走らせ、ANSIを除去したフレームとSUMMARY形式のJSONで結果を照合します。リポジトリ運営もエージェント化され、.github/triage_v2がIssueを分類・採点してAreaや担当者へ振り分け、Open Code Reviewワークフローがpull_request_target経由でPRにインラインレビューを投稿します。
- STEP 01
リポジトリをcloneして.github/actions/setup-harness-cliのmanifest.jsonを見ると、claude・codex・piそれぞれのCLIバージョンとlockダイジェストが固定されているのが分かります。
- STEP 02
uvベースのPython環境を作りverify_cli.pyを実行すると、pexpectが要求され、無い場合は`<repo>/.venv/bin/python`での実行を促すメッセージが出ます。
- STEP 03
verify_cli.pyを通すとomnigent CLIがPTY上で起動し、Searching for existing credentialsやConfigure harnessesといったオンボーディング画面がANSI除去済みのテキストで記録されます。
- STEP 04
GitHub上でPRを開くと、Open Code Reviewがpull_request_targetで走り、低重要度の指摘はサマリーにまとめられ、インラインコメントは重複して投稿されない仕様になっています。
- STEP 05
/ocr forceとコメントすると、同じコミットのレビューを再実行でき、サマリーは必ず新しく作られる一方でインライン指摘は重複しないことを確認できます。
- STEP 06
triage_v2のパイプラインをdatabricks.ymlの設定で動かすと、Issueがareas.jsonの重みに基づき採点され、ranking.jsonやsummary.jsonとして出力されます。
手元に残るのは、複数harnessを差し替え可能にするCLIの骨格と、その起動・サンドボックス化・CLIバージョン固定を機械的に保証するテスト群です。加えてPRレビューとIssue優先度付けを自動化するCI資産が得られ、エージェント運用の土台として再利用できます。コアのエージェント実行ロジック自体(omnigent/cli.pyの全体)は今回の資料には含まれていません。
提供資料にomnigent/cli.py本体のソースは含まれておらず、エージェント切替やポリシー適用の実装詳細はverify_cli.pyのコメントからの推測にとどまります。
Open Code Reviewの実行にはLLM_API_KEYとGATEWAY_BASE_URLという2つのシークレット設定が前提で、これらが無いと動作を試せません。
harnessのCLIバージョンはclaude 2.1.266、codex 0.139.0のように厳密に固定されているため、最新機能を使うには別途バージョン更新のPRが必要です。
自動化の対象がGitHub Actions中心のため、GitHub以外の環境で同等の体験を再現できるかは本資料からは判断できません。
複数のコーディングエージェントを1つのCLIで切り替えたいチーム、かつPRレビューやIssue優先度付けまで自動化したい運用に向いています。setup-harness-cli.test.mjsやverify-cache.test.mjsが、バージョン固定・キャッシュキー生成・リトライ処理を実コードに対して直接検証しており、これらのテストが通る設計である点から、インストールせずとも基盤部分の信頼性は判断できます。一方でエージェント実行の中核ロジックは資料外のため、そこは実際に動かして確認する価値があります。