Octopool

Octopool is a self-hosted GitHub read relay and shared cache. One Cloudflare Worker serves shared edge/D1 cache hits, prefers supported token-free GitHub transports on misses, and selects a pooled PAT or GitHub App identity only when required.

The pitch in one paragraph: a maintainer team plus a few bots make the same handful of read calls (gh pr view, gh pr checks, gh run list, gh issue list, gh api repos/...) against the same repos all day. Each developer's PAT and each App installation has its own quota; they're not shared and they overlap heavily. Octopool pools the identities behind one Cloudflare Worker, serves a normalized read-only API, and adds edge + D1 read-through caches so repeated reads return without touching GitHub at all. Tokens stay server-side, membership is org-gated, and the CLI falls through to your real gh for anything outside the supported read shapes.

#Get started

• New to it? Read the project overview in the README.
• Want to deploy octopool for your own org on Cloudflare? See Deployment & operations — Cloudflare resources, secrets, migrations, custom domains, and the smoke test.
• Already on someone else's deployment? Install the CLI and run octopool login <server>.

#Feature docs

• GitHub read relay — the POST /v1/github/request endpoint, supported routes, response envelope, policy gates, and safety limits.
• Token-free GitHub endpoints — the complete anonymous API and no-API-quota endpoint matrix, source URLs, shape limits, and exclusions.
• Octopool CLI — octopool login [server], discovery, whoami, the gh shim, and real-gh fallback.
• Pooled identities & routing — PAT and GitHub App identities, scopes, and the pool coordinator's selection, leases, and cooldowns.
• Cache & public-repo guard — the edge + D1 read-through cache and public-only visibility enforcement.
• Auth & org membership — caller auth, admin auth, website sessions, and the GitHub-CLI login exchange.
• Admin & provisioning — registering callers and identities.
• Landing page & GitHub login — octopool.openclaw.ai, octopool.dev, and the OAuth entry.
• Dashboard — GitHub-login-gated limits, cache, identity, and caller usage views.
• Deployment & operations — Cloudflare resources, config, migrations, build/test/deploy.

#Reference

• Project spec — the full product contract and design.