LoopForge — コーディングエージェントの協調と承認を行う基盤
Tencent/LoopForge
★ 914 ・ Go
概要
LoopForgeは、ソフトウェア開発において各種コーディングエージェント(AI CLI)を組織的・反復的に運用するためのセルフホスト型ワークスペース基盤です。Tencentのリポジトリとして公開されており、自社インフラ上に環境を構築して利用できます。
近年、Claude CodeやCodex、Cursor CLIなど、ターミナル上で自律的にコードを生成・編集・実行するコーディングエージェントが普及しています。しかし、単発のチャットやCLI実行に頼る場合、「計画を立てずに実装を始めてしまう」「テストやコードレビューを省いてしまう」「途中で停止しても気づきにくい」といった実行ごとの品質のばらつきが生じがちです。
LoopForgeは、こうした自律型コーディングエージェントを実務のデリバリープロセスに組み込み、チーム開発で再現性を確保したい開発者やエンジニアリングマネージャーに向いています。要件定義からPR(プルリクエスト)作成までのプロセスを、Dockerサンドボックス内で安全に実行し、必要に応じて人間の承認ゲートを挟みながら反復可能な手順として確立できます。
主な特徴
LoopForgeの主な特徴は以下の通りです。
- 2つの作業モード(チャットとSOP) メインボット(Main Bot)と対話しながら迅速に探索や修正を行う「チャット」と、定義済みの固定ステージと承認フローに従って成果物を生成する「SOP(Standard Operating Procedure)」の2つの実行形態を用途に応じて選択できます。
- 役割の分離とマルチエージェント協調 計画、実装、レビュー、テストといった各工程に対して個別のプロンプト、エグゼキューター、モデル、ルール、Skills、MCPツールを割り当てられます。各役割は独立したサブエージェントやSOPノードとして協調動作します。
- 人間の介入ポイント(Human in the loop) 重要なチェックポイントに人間の承認ゲート(Approval gate)を設置できます。生成されたレポートや差分を確認した上で、承認して次へ進めるか、特定のステップへ差し戻すかを判断できます。
- 10種類以上のコーディングエージェントCLIに対応 CodeBuddy、Codex、Claude Code、OpenCode、Cursor CLI、Antigravity、Kimi Code、Pi、DeepSeek Harness、ZCodeといった多様なコーディングエージェントCLIをエグゼキューターとして選択可能です。
- 追跡性と再開可能性(Observable and resumable) ノードの実行ステータス、ツール実行トレース、ログ、成果物を一元的に確認できます。処理を一時停止したり、失敗したステップを再試行したり、任意のノードから再実行することが可能です。
- 要件と成果物の一元管理 チャット経由の変更であってもSOP経由の変更であっても、共通の「要件(Requirements)」に紐付けてトラッキングされ、PRやブランチへのマージ、コストレポートとして記録されます。
使い方
前提条件と環境準備
ホスト環境にGitがインストールされている必要があります。インストーラー(start.sh)を実行すると、Docker、Docker Compose、Python 3、curlの存在をチェックし、不足している場合は自動的にセットアップを提案します。Linux環境ではapt、dnf、yum、macOS環境ではHomebrew経由の補完に対応しています。GoやNode.jsをホストマシンに手動インストールする必要はありません。
起動手順
リポジトリをクローンし、起動スクリプトを実行します。自動インストールのプロンプトをスキップしたい場合は、環境変数 LOOPFORGE_YES=1 を付与します。
git clone https://github.com/Tencent/LoopForge.git
cd LoopForge
./start.sh
ネットワーク環境によってGitHub Packages(ghcr.io)からのイメージダウンロードが遅延または停止する場合は、以下のようにミラーレジストリを指定して実行できます。
MIRROR=ghcr.nju.edu.cn ./start.sh
初期設定とデモの実行
- スクリプトの実行が完了すると、アクセス先のアドレス(デフォルトでは
0.0.0.0:8090)が出力されます。ブラウザでアクセスし、最初のアカウントを作成します(最初のアカウントが管理者になります)。 - 作成されたアカウントには「LoopForge demo project」が用意されています。このプロジェクトには、スクリプト実行と人間の承認ゲートのみで構成されたSOP(APIキー不要)が含まれています。
- 「Templates」から「Platform check · script & approval」を開き、「Run SOP」をクリックします。
- スクリプトがレポートを出力した後、承認ステップで待機状態になります。
- レビュー画面(Needs review)または実行詳細ページから承認を行うと、ワークフローが後続処理へ進み、最終成果物が生成されます。
実際のコード変更やPR作成を行うには、パーソナル設定で対象エグゼキューター(Claude Code、Codexなど)のAPIキーと、GitHubの接続設定を行います。
技術的なポイント
LoopForgeの設計と内部構成には、実用的なエージェント運用を意識した工夫が見られます。
- 言語と基本構成 バックエンドはGo言語で実装されており、データベースにはMySQLを使用します。実行基盤全体はDocker Composeを通じてコンテナ化されており、ホスト側の開発環境を汚さずに最小限の手順で導入できるよう配慮されています。
- Dockerサンドボックスによる隔離 エージェントがコードを実行したりリポジトリを操作したりする環境は、ホスト環境から分離されたDockerサンドボックスとして立ち上がります。これにより、意図しないファイル破壊やシステムへの影響を最小限に抑えられます。
- CLIごとのクレデンシャルおよび設定の分離 CodeBuddyやCodex、Claude CodeなどのエージェントCLIごとに異なる認証方式(個別APIキーや共通キー、ローカルログインなど)に対応しています。特にClaude Code以降のCLIでは、実行ごとに個別のプライベートホームディレクトリでMCP設定やモデル設定を管理する仕組みになっており、チームで共有サーバーを利用する場合でも他ユーザーの認証情報と混ざらないよう設計されています。
- 拡張プロトコルへの対応 エージェントのツール呼び出しには、標準的なスクリプトだけでなく、SkillsやMCP(Model Context Protocol)ツールの利用が組み込まれています。外部サービス連携や追加ツールの拡張が柔軟に行える構造になっています。
注意点
LoopForgeを利用する際は、以下の点に留意する必要があります。
- ライセンスの確認 GitHubリポジトリのメタデータ(API上のLicense項目)は「不明」となっていますが、READMEの本文中には「all on your own infrastructure under the MIT license」という記述があります。プロジェクトへの導入にあたっては、リポジトリ内のLICENSEファイルの実体や表記を改めて確認してください。
- 初期アクセス時のセキュリティ 初期起動時は、最初にアカウントを作成したユーザーが管理者となります。クラウド環境などのパブリックネットワーク上でポートを開放する場合、第三者による管理者アカウントの登録を防ぐため、初期登録が完了するまではアクセス元IPを制限するか、リバースプロキシ等で適切なアクセス制御を行う必要があります。
- エグゼキューターごとの導入要件と制限 エグゼキューターによってDockerイメージ内への同梱状況が異なります。例えば、Claude CodeやOpenCodeなどは初回のチャット利用時にnpm等を介して動的にダウンロード・キャッシュされます。また、要件の明確化やAI通知サマリー、ボットの応答などの内部処理の一部はCodeBuddy向けに設計されており、選択可能なモデルに制約がある点に注意が必要です。
まとめ
LoopForgeは、各種コーディングエージェントCLIをDockerサンドボックス上で安全に協調させ、人の承認ゲートを挟んだ標準ワークフロー(SOP)として定型化できるセルフホスト型基盤です。単発のチャット機能にとどまらず、開発チームのデリバリー手順をAIエージェントとともに自動化・標準化したい場合に有用な選択肢となります。





