ghpool

ghpool は、複数の coding agent（OpenAB bots、OpenClaw workers、カスタム agent）が同じリポジトリを共有して GitHub のトークン毎の rate limit を消費する状況のために設計された GitHub API プロキシです。

3 つのことをします：

読み取り用 PAT プール — すべての GET リクエストは残り rate-limit 予算が最も多いアイデンティティ経由でルーティングされ、複数の agent が各自の上限に達する代わりに合算予算を共有します
読み取りレスポンスのキャッシュ — REST GET と GraphQL query 結果はリソース別 TTL でメモリにキャッシュされます（PR view 30 秒、run list 15 秒、repo view 5 分など）
書き込みのパススルー — POST/PATCH/DELETE と GraphQL mutation はクライアント自身の Authorization ヘッダーが必要で、そのトークンで転送されるため、GitHub の監査ログには誰が書き込んだか記録されます

アーキテクチャ

このテンプレートは ghpool を内部専用サービスとしてデプロイします：

パブリックドメインは紐付けません — 同じ Zeabur プロジェクト内の他サービスがコンテナネットワーク経由でアクセスします
ポート 8080 は TCP として公開（Ingress なし、TLS 終端なし）
ポートフォワーディングはデフォルトで無効、外部からテストする場合は ネットワーク タブで有効化してください

他のサービスは以下の自動公開される環境変数で接続できます：

変数	値
`GHPOOL_HOSTNAME`	コンテナホスト名（例: `ghpool.zeabur.internal`）
`GHPOOL_BASE_URL`	フルベース URL（例: `http://ghpool.zeabur.internal:8080`）

クライアントを ghpool に向ける

クライアントを ghpool 経由にする方法はクライアントの種類によります：

Coding agents（Claude Code、Codex、カスタムエージェント）：ほとんどは GITHUB_API_BASE で GitHub API エンドポイントを上書きできます。

export GITHUB_API_BASE=${GHPOOL_BASE_URL}

gh CLI：ghpool に同梱される ghp シムを使います — 読み取りを ghpool 経由、書き込みを実際の gh 経由にルーティングするドロップイン代替品です。素の gh はベース URL 上書きを完全にはサポートしません（gh issue list のような組み込みコマンドは内部で GraphQL を使い迂回します）。ghp が信頼できる方法です。

直接 HTTP：

curl ${GHPOOL_BASE_URL}/repos/owner/repo

書き込み操作は常にクライアント自身の Authorization ヘッダーが必要です — ghpool は mutation に認証を注入しないため、GitHub の監査ログにはどのエージェントが書き込んだかが記録されたままになります。

PAT の追加

テンプレートは 1 つの PAT（GHPOOL_PAT_DEFAULT）でプールをシードします。追加方法：

ghpool サービスの環境変数タブを開く
GHPOOL_PAT_<ID> という名前の環境変数（例: GHPOOL_PAT_BOT_CLAUDE、GHPOOL_PAT_BOT_CODEX）を PAT 値で追加 — <ID> は /stats に表示されるアイデンティティ名になります
サービスを再起動して新しいアイデンティティを反映

GHPOOL_PAT_* プレフィックスに一致する環境変数はすべて自動検出されます。

エンドポイント

パス	用途
`GET /<github-api-path>`	GitHub REST API GET をプロキシ（プール+キャッシュ）
`POST /graphql`	GraphQL — query はプール+キャッシュ、mutation はクライアント認証でパススルー
`GET /healthz`	ヘルスチェック
`GET /stats`	プール予算、キャッシュヒット率、アイデンティティ別統計

セキュリティに関する注意

PAT は環境変数のみに保持され、コンテナ内のファイルには書き込まれません
GHPOOL_ALLOWED_OWNERS は厳格に適用：リストにない org/user へのリクエストは一律 403、PAT が漏洩しても明示的にリストされたリポジトリのみ露出します
Mutation には Authorization ヘッダーが必須（なければ 401）、匿名書き込みゲートウェイとして悪用されません

リソース

ghpool は単一の Rust バイナリ（distroless image）です — 非常に軽量です。メモリは主にメモリ内キャッシュ（デフォルト上限 10000 エントリ）で消費されます。プロキシトラフィックが大きい場合は RAM を増やしてください。

リンクとライセンス

ソースコード: https://github.com/openabdev/ghpool
ライセンス: MIT
Issues: https://github.com/openabdev/ghpool/issues