简体中文

OCG Manager

OCG Manager is a local operations console for OpenCode-Go accounts. It stores your account keys in SQLite and serves a multi-protocol gateway — plus the management dashboard — at http://127.0.0.1:9042. Clients speak OpenAI, Anthropic, Gemini, or Claude Desktop; the gateway converts each request to that model's native OpenCode-Go protocol and converts the response back.

Highlights

• One port, four client families — OpenAI Chat Completions / Responses, Anthropic Messages, Gemini generateContent / streamGenerateContent, model discovery, and Claude Desktop aliases.
• Local multi-account rotation — drag account cards to persist priority; the gateway skips disabled, cooling, or already-failed accounts.
• Quota bars are warnings — 5-hour / weekly / monthly usage is a local estimate. A full bar does not stop traffic; only an upstream 429 cools an account down.
• 16 client guides — copy-ready snippets for Claude Code, Codex, Gemini CLI, and 13 other tools.
• Desktop, CLI, and Docker — a Tauri v2 tray app, ocg-manager-cli, and ghcr.io/klarkxy/opencode-go-mgr. Installed desktop builds can install signed updates from Settings.
• No remote sync, no telemetry — every node owns its own data. Managed onboarding is Beta; do not rely on it in production.

Download

Download the GUI installer or CLI archive from the latest GitHub Release and verify it against that release's SHA256SUMS before installing: Get-FileHash <file> -Algorithm SHA256 on PowerShell, shasum -a 256 <file> on macOS, or sha256sum <file> on Linux.

Platform	GUI	CLI
Windows 10/11 x64	ocg-manager_<version>_windows-x64-setup.exe (NSIS)	ocg-manager-cli_<version>_windows-x64.zip
macOS 11+ Intel and Apple Silicon	ocg-manager_<version>_macos-universal.dmg	ocg-manager-cli_<version>_macos-universal.tar.gz
Linux x64	ocg-manager_<version>_linux-x64.AppImage and .deb	ocg-manager-cli_<version>_linux-x64.tar.gz

Keep dist/ beside the CLI executable so serve can serve the dashboard. Platform caveats (SmartScreen, Gatekeeper, unsigned Windows, no ARM64 / RPM / Snap / stores) are in the User guide and Maintainer guide.

Quick Start

Gateway: http://127.0.0.1:9042/v1
Auth:    Authorization: Bearer <key>

The dashboard Key is the only secret a client needs. The gateway injects the stored OpenCode-Go account key on the upstream side.

1. Install and launch OCG Manager. The dashboard opens in your system browser once the gateway is ready; use the tray icon to reopen it.
2. Import an existing key in Accounts, or use managed onboarding (Beta). Copy the Key.
3. Point your client at http://127.0.0.1:9042/v1. Applications has per-client configuration guides.

curl http://127.0.0.1:9042/v1/chat/completions \
  -H "Authorization: Bearer ocg-xxxxxxxx-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"glm-5.2","messages":[{"role":"user","content":"hello"}],"stream":true}'

Install, first-client checks for all five protocols, backup, and upgrades: User guide.

Docker

Public image: ghcr.io/klarkxy/opencode-go-mgr (linux/amd64, anonymous pull). Save compose.example.yaml (also attached to each Release) as compose.yaml and run:

docker compose pull
docker compose up -d --no-build

Open http://127.0.0.1:9042/dashboard/ — the server root / is not the dashboard. Credentials, the optional browser sidecar, backup, HTTPS, image pins, and source builds: User guide — Docker.

Models

Each known model has a hardcoded preferred OpenCode-Go protocol and a probed supported set. Matching client protocols passthrough; others convert. The gateway never probes a protocol at request time — that could double-bill.

Preferred upstream	Models
OpenAI Chat Completions	glm-5.3, glm-5.2, glm-5.1, glm-5, kimi-k3, kimi-k2.7-code, kimi-k2.6, kimi-k2.5, deepseek-v4-pro, deepseek-v4-flash, mimo-v2.5, mimo-v2.5-pro, hy3
OpenAI Responses	grok-4.5, gpt-5.6-luna
Anthropic Messages	minimax-m3, minimax-m2.7, minimax-m2.7-highspeed, minimax-m2.5, minimax-m2.5-highspeed, qwen3.8-max, qwen3.7-max, qwen3.7-plus, qwen3.6-plus, qwen3.5-plus

Gemini is a client format only (requests never go to Google). Claude Desktop aliases are rewritten to the mapping saved in Applications. Unknown models on Chat / Messages keep the request protocol; unknown Responses, Gemini, or Claude Desktop aliases return 400.

Passthrough matrix, context / input / reasoning / tools, conversion limits, and true vs false circuit breakers: User guide — model capabilities and protocol conversion.

Documentation

Audience	English	简体中文
End users	User guide	用户指南
Maintainers	Maintainer guide	维护者指南
Policy	Anti-abuse statement	防滥用声明
Index	docs/	bilingual

Also: Contributors, DESIGN.md, AGENTS.md.

Community

Join the OCG Manager QQ group: 1104321231.

Development

pnpm install
pnpm run dev

Exit any running release tray app first so the single-instance lock and port 9042 are free. Tauri starts Vite and opens http://127.0.0.1:30001/dashboard/ once the gateway is ready. Checks, builds, and the release pipeline: Maintainer guide.

License

See LICENSE.

Star History