codex-app-server

Codex App Server

Codex App Server

定義

Codex App Server は、大規模言語モデル(LLM)エージェントを外部のアプリケーションに統合するためのプロトコルとアーキテクチャです。OpenAI によって定義され、JSON-RPC 2.0 ベースの双方向通信を通じて、エージェントとクライアント(IDE、エディタ、開発ツール)が協調して動作する仕組みを提供します。

なぜ必要か

LLM エージェントを単体で動かすだけでは、実際の開発フローに統合しにくい問題があります。

  • ツール統合の複雑さ - エージェントがファイルシステム、バージョン管理システム、デプロイツールなど、複数のシステムと連携する必要がある
  • リアルタイムフィードバック - エージェントの処理結果(コード修正、テスト結果)をユーザーにすぐに返す必要がある
  • セッション管理 - 複数の会話スレッドを同時に管理し、コンテキストを保持する必要がある

Codex App Server は、これらの課題をプロトコルレベルで解決し、エージェント、クライアント、外部ツールが標準化された方法で通信できる基盤を提供します。

アーキテクチャの特徴

  • JSON-RPC 2.0 ベース - 標準的なリモートプロシージャコール形式で通信
  • 複数トランスポート対応 - stdio(標準入出力)、WebSocket など、様々な通信方式をサポート
  • イベントストリーミング - エージェントの処理中間結果をリアルタイム配信
  • セッション・ターン管理 - 会話の履歴、分岐、再開などを体系的に管理

このプロジェクトでの実装

このプロジェクトは、OpenAI の Codex App Server のアイデアを参考に、Google Gemini Flash エージェントLLM Wikiのナレッジベースとして統合しています。

統合方法:

  • MCP(Model Context Protocol) を使用 - 標準化されたツール通信プロトコル
  • deploy-mcp.js スクリプト - MCP サーバーとしてエージェントとクライアントの仲介
  • .codex/config.toml - エージェント設定の中央管理

主な機能

  • 自動検証 - コード変更をプッシュ後、デプロイが正しく行われたか自動確認
  • デイリーログ記録 - タスク完了時に自動で議論内容とやりとりを記録
  • セッション継続 - 過去の会話コンテキストを保持して、次回の実行に活かす
  • ツール統合 - Git、デプロイシステム、ビルドツールなどと連携

Codex App Server は、開発ワークフロー全体を AI エージェントが自律的にサポートする基盤となります。