rebel0789/codexpro

CodexPro – ChatGPTにコードリポジトリへの安全なローカルアクセスを提供

概要 – CodexProは、OpenAIのChatGPT用の カスタムMCP (Model-Client-Plugin) として機能する小さなNode-JSサーバーです。マシン上で実行し、ChatGPT内のプラグインとして登録すると、モデルは明示的に許可したリポジトリのファイルに対して 読み取り、検索、編集、およびチェックの実行 を行うツールセットを呼び出すことができます。すべての分析はコンピュータ上に留まり、サードパーティのサービスにアップロードされることはありません。

重要性 – 最近の「コードアシスタント」の波（GitHub Copilot、ChatGPT Code Interpreterなど）は、多くの場合クラウドで実行され、ソースコードをリモートサーバーに送信します。CodexProはそのモデルを反転させます。LLMはOpenAIのクラウドに留まりますが、重量級のコードインテリジェンス（言語検出、シンボルインデックス作成、影響分析）はローカルで実行されるため、プライバシー、セキュリティ、再現性をより厳密に制御できます。

クイックスタート (READMEより)

前提条件
- Node 20+ がインストールされていること
- カスタムMCPプラグインを追加できるChatGPTアカウント
- マシンを指すHTTPSエンドポイント (例: Cloudflare tunnel、ngrok、またはTailscale Funnel)
CLIのインストール
```
npm install -g codexpro
```
リポジトリのセットアップ
```
cd /path/to/your/project
codexpro setup
```
これによりローカル設定が作成され、ChatGPTに提供するHTTPS URLが表示されます。
ChatGPTへのプラグイン追加
- Settings → Security & login で Developer mode をオンにします。
- Settings → Plugins → Search plugins の横にある + をクリックします。
- CodexPro という名前のプラグインを作成し、ステップ3のURLを貼り付けます。
- No Authentication / None を選択します (トークンはURLに埋め込まれています)。
サーバーの起動
```
codexpro start   # 現在のリポジトリ用のMCPサーバーを実行
```
サーバーはChatGPTセッションからのツール呼び出しを待機します。

主な機能 (READMEの記述通り)

機能	CodexProを通じてChatGPTができること
ワークスペース検査	`inspect_workspace` は、言語、プロジェクトタイプ、エントリポイント、シンボル、内部関係の軽量インデックスを構築します。
検索	`search` は、プレーンテキスト、正規表現、および `symbol`、`references`、`impact` などの意図主導型クエリをサポートします。
編集	`write`、`edit`、または保護された `apply_patch` により、モデルは許可されたルート内でコード変更を提案および適用できます。
ファイルインポート	`import_file` はChatGPT Apps SDKからの添付ファイルを受け入れ、リポジトリに書き込みます。
コマンド実行	有効化後、安全なサブセットのBashコマンド (`bash` ツール) を実行できます。
差分と影響分析	`show_changes` は差分を返し、影響を受ける領域、依存コード、関連テスト、リスク信号、推奨される検証コマンドを強調表示します。
計画と引き継ぎ	モデルは `.ai-bridge` ディレクトリの下に引き継ぎ計画を書き込み、ツールを呼び出せないチャット用にコンテキストバンドルをエクスポートできます。

内蔵リポジトリインテリジェンス

TypeScript/JavaScript, Python, Go, Rust, Swift, Java, C#, C, C++ の宣言を認識します。他の言語は字句検索と安全なインベントリ機能を利用できます。
外部の埋め込みサービス、ベクトルDB、言語サーバーデーモンは不要です。すべてがローカルにキャッシュされ、ワークスペースのフィンガープリントに関連付けられます。
結果には、誤った確信ではなく、カバレッジ と 推論強度 の指標が含まれます。

セキュリティのデフォルト設定

明示的なワークスペースの境界 – どのディレクトリを公開するかを決定します。それ以外はすべてブロックされます。
トークン保護されたトンネル – 公開HTTPSトンネルには、ランダムな24バイトのトークンが必要です (~/.codexpro/http-token に保存)。
書き込みモードは非表示 – --mode workspace でサーバーを起動しない限り無効です。
安全なBash がデフォルトです。危険なコマンドはフィルタリングされます。
ブロックされたパスには .env、秘密鍵、.git、ビルドキャッシュなどが含まれます。
添付ファイルは、ChatGPT Apps SDKを介して承認されたHTTPSホストからのみ受け入れられます。

一般的なワークフロー

ワークスペースを開く – codexpro start (または codexpro start --root /path/to/repo)。
ChatGPTで、そのリポジトリに対して open_workspace を実行するようモデルに依頼します。
モデルは以下を実行できます:
- 関数定義の検索 (search symbol MyClass.myMethod)。
- 変更の提案 (edit src/foo.py)、差分の確認 (show_changes)、適用 (apply_patch)。
- テストコマンドの実行 (bash npm test)。
- 行った作業を要約する引き継ぎドキュメントの作成。
完了したら、サーバーを停止するか、別のリポジトリ用に別のインスタンスを起動します。

拡張性とモード

複数のプロジェクト – 単一のCodexProプロセスで複数のリポジトリを処理できます (codexpro settings set --project …)。
ツールモードの選択 – --tool-mode minimal、full、またはカスタムカードセット (CODEXPRO_TOOL_CARDS=1)。
ヘッドレス / 引き継ぎ / プロ – CIスタイルの実行、記録保持、または完全な対話型使用のための異なるプリセット設定。

インストールと更新

npm install -g codexpro          # グローバルインストール
codexpro --version               # バージョン確認
npm install -g codexpro@latest    # アップグレード

設定は `~/.codexpro` に保存されます。バイナリを更新しても保存されたプロファイルは消去されません。

詳細情報

ウェブサイト / ドキュメント – https://rebel0789.github.io/codexpro/
ロードマップ、FAQ、セキュリティガイド – リポジトリにリンクされています (ROADMAP.md, FAQ.md, SECURITY.md)。
ソース – リポジトリには、貢献者向けのCI、スモークテスト、ストレステスト、リリーススクリプトが含まれています。

結論

CodexProは、独自のソースコードを公開することなく、ChatGPTを ローカルコードアシスタント として機能させる真のオープンソースブリッジです。検索可能で言語認識を備えたインデックス作成、安全な編集/パッチ適用ワークフロー、およびオプションのコマンド実行を提供し、これらすべてが明示的なリポジトリ権限とHTTPSトンネル認証によって保護されています。LLM主導のコーディングの利便性を享受しつつ、コードと環境を完全に制御したい開発者に最適です。