CPA Manager Plus

A self-hosted CPA / CLIProxyAPI management panel and observability dashboard for requests, usage, cost, quota, failures, and account health.

Operate providers, credentials, OAuth, plugins, and configuration while keeping persistent request history, cost analytics, and account automation in local storage.

中文 ｜ Live Demo ｜ Documentation ｜ Install

Which Panel Should You Choose?

CPA / CLIProxyAPI can serve either the official Management Center or the CPAMP Lightweight Panel directly on :8317. The lightweight panel replaces the official UI with CPAMP's clearer management experience without adding another service. Deploy CPAMP Full Mode when you also need persistent observability and long-running operations.

Need	Recommended choice
Keep the upstream UI maintained by the CPA project	Official CLI Proxy API Management Center
Replace the official UI with a clearer CPA-hosted WebUI and no additional service	CPAMP Lightweight Panel
Persist request history and diagnose failures after the CPA queue expires	CPAMP Full Mode
Analyze cost and tokens by model, account, API key, project, and time range	CPAMP Full Mode
Run server-side account inspection, automation, SQLite backups, and recoverable migrations	CPAMP Full Mode

See Choosing A CPA Panel for the comparison, or install the CPAMP Lightweight Panel directly in CPA.

Core Capabilities

CPA Gateway Management

• Manage Gemini, Codex, Claude, Vertex, xAI, OpenAI-compatible, and other CPA provider configuration.
• Maintain auth files, OAuth logins, API keys, model aliases, priorities, plugins, logs, and system settings.
• Import official Sub2API OpenAI OAuth exports and split multiple accounts into separate CPA Codex auth files.
• Install plugins from latest, a selected GitHub Release, prerelease, or a manually entered tag.

Request Monitoring And Failure Diagnosis

• Persist requests from the CPA usage queue in local SQLite.
• Inspect account, client API key, and realtime request views with status, latency, token, cache, trace, and redacted failure evidence.
• Export or import request history as JSONL without exposing raw failure bodies.
• Open the Monitoring Demo.

Cost And Usage Analytics

• Break down calls, tokens, cost, latency, and failures by model, provider, account, credential, API key, project, channel, and time range.
• Track input, output, reasoning, cache read/write/creation, service tier, and long-context pricing semantics.
• Sync model prices from LiteLLM and OpenRouter, then keep local overrides for aliases or internal models.
• Open the Usage Analytics Demo.

Account Health, Quota, And Automation

• Inspect Codex and xAI accounts locally or on a Manager Server schedule.
• Read Codex windows, Claude weekly/model-scoped limits, xAI/Grok billing signals, credential state, workspace state, and reset evidence when the provider exposes it.
• Apply controlled quota cooldowns and restore only credentials disabled by the same automation owner.
• Collect credential failures in an account action queue for reauthorization, review, enable, resolve, or safe deletion.
• Open the Account Inspection Demo and Auth Files Demo.

Production Operations

• Run as one Docker container or a native Linux, macOS, or Windows package for amd64/arm64.
• Keep request history, Manager configuration, automation state, and model prices in local files with no account registration or telemetry SDK.
• Use bounded SQLite connections, streaming usage import/export, incremental rollups, recoverable background migrations, and loopback-only pprof diagnostics.
• Back up SQLite files together with data.key to preserve encrypted CPA Management Keys.

Screenshots

Dashboard	Request Monitoring
Usage Analytics	Account Health

Choose How To Use CPAMP

Option	Best for	Entry
CPAMP Lightweight Panel	Existing CPA users who only want to replace the official UI	CPA :8317/management.html
CPAMP Full Mode	Request history, cost analytics, inspection, and automation	Manager Server :18317/management.html

Full Mode can be installed with Docker (recommended) or a native package.

Want to preview the interface first? Open the Live Demo. The demo uses fictional data only. It is not a deployment or runtime mode and cannot connect to, manage, or monitor a real CPA instance.

CPAMP manages and observes traffic through CPA / CLIProxyAPI. It is not a replacement proxy and does not forward model traffic by itself.

Quick Start

Installer

For a guided full-stack or CPAMP-only deployment:

curl -fsSLO https://raw.githubusercontent.com/seakee/CPA-Manager-Plus/main/bin/install-cpamp.sh
bash install-cpamp.sh

Preview without deploying:

CPAMP_DRY_RUN=1 bash install-cpamp.sh

See One-Click Installer for upgrade, repair, and admin-key recovery behavior.

CPA + CPAMP Together

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, retrieve the CPAMP Admin Key from the Manager Server log, then enter the CPA URL and CPA Management Key during setup.

CPAMP Only

If CPA is already running:

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+.

Documentation

Task	Guide
Choose the right panel and deployment mode	Choosing A CPA Panel
Replace the official UI without deploying another service	CPAMP Lightweight Panel
Install and complete first setup	Getting Started
Understand supported features and modes	Capability Matrix
Configure providers, credentials, quota, and plugins	Panel Manual
Operate Manager Server, backups, upgrades, and migrations	Manager Server Guide
Diagnose empty monitoring or queue problems	Troubleshooting

Data, Privacy, And Security

• CPAMP does not phone home, include analytics SDKs, or require account registration.
• External calls are limited to the CPA gateway and integrations you explicitly configure or trigger, such as OAuth, provider checks, plugin releases, and model price sync.
• Request history, configuration, model prices, inspection history, and automation state stay in local files.
• CPA Management Keys are encrypted before SQLite persistence; backups require the SQLite files and data.key.
• Normal APIs and JSONL exports expose redacted failure summaries, never raw failure bodies or stored raw JSON.
• CPAMP is intended for traffic and credentials you are authorized to operate.

Development

npm install
npm run dev
npm run type-check
npm run lint
npm run test
npm run build
npm run docs: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 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 CLIProxyAPI and the official CLI Proxy API Management Center for the runtime and WebUI foundation.
• Thanks to the Linux.do community for project promotion and feedback.

License

MIT — Copyright 2026 Seakee.