subs-pool v0.1.0B

Immutable. This exact content never changes and is served at /api/v1/blob/8dc370d7b82a5d67.

---
name: subs-pool
description: >
  Nested system-manual reference pointing to subs-pool, the external Codex
  subscription pool. LingTai has no built-in Codex account pool; use this to
  pool several ChatGPT/Codex accounts behind one local Responses endpoint, or to
  migrate a removed `codex-pool` provider config.
version: 0.1.0
last_changed_at: "2026-09-29T00:00:00Z"
related_files:
- src/lingtai/intrinsic_skills/system-manual/SKILL.md
- src/lingtai/intrinsic_skills/system-manual/reference/llm-adapters/SKILL.md
- src/lingtai/init_schema.py
- src/lingtai/llm/_register.py
maintenance: |
  Pointer only. The subs-pool repository owns install, account management,
  quota, and proxy behavior; keep this file to the LingTai-side configuration
  shape and update it only when that shape or the repository location changes.
---
# subs-pool

LingTai does not pool Codex accounts. The `codex` provider binds exactly one
OAuth account (`codex_auth_path`, else `~/.lingtai-tui/codex-auth.json`). The
former `codex-pool` / `codex_pool` providers were removed and now fail init
validation.

Account pooling lives in **subs-pool**: https://github.com/Lingtai-AI/subs-pool
— a standalone Codex subscription pool with a loopback Responses proxy. Follow
its README to install it, import accounts, and run
`subspool codex serve --listen 127.0.0.1:<port>` with a local access key
(`CODEX_POOL_API_KEY`).

## Point an agent at it

To LingTai the proxy is a plain stateless OpenAI Responses endpoint:

```json
"llm": {
  "provider": "custom",
  "api_compat": "openai",
  "wire_api": "responses",
  "base_url": "http://127.0.0.1:<port>/v1",
  "api_key_env": "<ENV_VAR_WITH_THE_LOCAL_ACCESS_KEY>",
  "model": "<codex model>",
  "thinking": "xhigh"
}
```

- Put the access key in the agent's `env_file` under that variable name.
- The normal tier is the default; add `"service_tier": "fast"` only when you
  want the priority tier.
- Vision/web capabilities that named `codex-pool` must name another provider
  (e.g. `codex`, or the same `custom` endpoint where supported).
- Account selection, quota, and failover are the proxy's job; diagnose them
  with `subspool codex status` / `subspool-cli codex quota`, not LingTai logs.