CPA Manager Plus

中文文档

A self-hosted dashboard for monitoring AI gateway traffic: requests, cost, failures, quota, and account health.

Works with CPA / CLIProxyAPI and OpenAI-compatible gateways that serve Codex, Claude Code, or similar tools.

Live demo

Highlights

• Real-time dashboard showing today's request count, success rate, average latency, and estimated cost. Supports filtering by model, account, project, and time range.
• Cost ranking by model and per-account spend breakdown, with token-level detail (input, output, reasoning, cached).
• Codex account inspection runs on a schedule to check quota, credential validity, and workspace status. Accounts that hit quota limits are paused automatically and re-enabled at reset time.
• Single Docker container, all data in local files, no outbound network calls except to your own gateway.

Screenshots

When You Need It

"Why are my Codex requests failing?" — Open the monitoring page to see failure rate, status codes, and which accounts or models are affected. Failure reasons are shown in a redacted summary, raw error bodies stay local.

"How much did my AI traffic cost this week?" — The usage analytics page breaks down cost by model, provider, account, and project. You can see which model is the most expensive and how tokens distribute across input, output, reasoning, and cache.

"Is my Codex account still usable?" — The inspection page shows each account's quota remaining, plan tier, reset schedule, and whether credentials are still valid. If an account has been disabled or hit its limit, CPAMP tells you what happened and what to do next.

What You Get

Request Monitoring

Every request flowing through your gateway is recorded and searchable. The monitoring page has three views: an account overview, a client API key summary, and a real-time feed showing individual requests with model, status, latency, and token usage. You can export request history as JSONL, or import historical data from a backup.

Cost & Usage Analytics

A dedicated analytics page ranks models by cost, shows token composition, and breaks down spend per account. Filters cover provider, project, channel, and arbitrary date ranges. Model prices sync from LiteLLM and OpenRouter, so cost estimates stay current even when providers change pricing.

Account Health & Quota

CPAMP runs scheduled inspections against Codex accounts: checking quota windows, reset credits and their expiry dates, credential validity (OAuth tokens, workspace status), and whether accounts should be paused or re-enabled. When an account hits usage_limit_reached, the corresponding auth file is temporarily disabled and automatically restored at reset time. Manual disables are never overridden.

Gateway Operations

The dashboard also covers day-to-day CPA operations: managing providers, auth files, OAuth logins, API keys, quota, logs, plugins, and system config. Auth files can be added by JSON paste or batch import.

Self-Hosted & Private

CPAMP makes no outbound calls except to the CPA gateway you configure. There are no analytics SDKs, no cloud dependencies, and no account registration. It runs as a single Docker container or a native binary (Linux, macOS, Windows — amd64 and arm64), with all data stored in local files.

Quick Start

CPA Manager Plus works with CPA / CLIProxyAPI, an AI gateway that routes requests to OpenAI-compatible providers.

CPA + CPAMP Together

If you don't have CPA running yet, this Compose file starts both:

services:
  cli-proxy-api:
    image: eceasy/cli-proxy-api:latest
    restart: unless-stopped
    ports:
      - "8317:8317"
    volumes:
      - cpa-data:/app/data

  cpa-manager-plus:
    image: seakee/cpa-manager-plus:latest
    restart: unless-stopped
    ports:
      - "18317:18317"
    volumes:
      - cpa-manager-plus-data:/data

volumes:
  cpa-data:
  cpa-manager-plus-data:

docker compose up -d

Open http://<host>:18317/management.html, get the admin key from docker logs cpa-manager-plus, then fill in:

1. The admin key.
2. CPA URL: http://cli-proxy-api:8317.
3. Your CPA Management Key.
4. Request monitoring preferences.

CPAMP Only

If CPA is already running somewhere, just start CPAMP:

docker run -d \
  --name cpa-manager-plus \
  --restart unless-stopped \
  -p 18317:18317 \
  -v cpa-manager-plus-data:/data \
  seakee/cpa-manager-plus:latest

Recommended CPA version: v7.1.39+. The HTTP usage queue needs v6.10.8+.

CPAMP can also run as a CPA-hosted panel on :8317, or as a standalone frontend for development. See the Wiki for Compose variants, host networking, upgrades, and backup.

Documentation

Data And Privacy

• CPAMP does not phone home. The only outbound connection is to the CPA gateway you configure. No analytics SDKs, no account registration.
• All data (request history, credentials, configuration) is stored in local files on your host.
• Gateway keys are encrypted before storage. Exported data never includes raw error bodies.
• CPAMP is built for observability over traffic you are authorized to manage: cost tracking, failure diagnosis, and operational health.

Development

npm install
npm run dev
npm run type-check
npm run lint
npm run test
npm run build

Manager Server:

cd apps/manager-server
go test ./...
go test -race ./...
go vet ./...
go run ./cmd/cpa-manager-plus

Build the Docker stack locally:

docker compose -f docker-compose.manager.yml up --build

Release

• npm run build creates a single-file apps/web/dist/index.html.
• bin/release/package-native.sh embeds the built panel into native packages.
• Tag pushes such as vX.Y.Z trigger .github/workflows/release.yml.
• Release assets include management.html, native packages, and Docker images for linux/amd64 and linux/arm64.

Acknowledgements

• Thanks to the upstream projects CLIProxyAPI and Cli-Proxy-API-Management-Center for the foundation and inspiration.
• Thanks to the Linux.do community for project promotion and feedback.

Star History

License

MIT — Copyright 2026 Seakee.