CPA-Manager-Plus

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

What is CPA-Manager-Plus?

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

Overview of CPA-Manager-Plus

What it is

CPA Manager Plus (CPAMP) is a self-hosted management panel and observability dashboard for CPA / CLIProxyAPI. It provides persistent request history, cost analytics, account health inspection, and automation for AI gateways.

Key features

  • CPA Gateway Management: Manage provider configurations (Gemini, Codex, Claude, Vertex, xAI, Devin, Muse/Meta, OpenAI-compatible), auth files, OAuth logins, API keys, model aliases, priorities, plugins, logs, and system settings.
  • Request Monitoring and Failure Diagnosis: Persist requests in local SQLite, search by account/client API key, inspect status, latency, token, cache, trace, and redacted failure evidence. Export/import request history as JSONL.
  • Cost and Usage Analytics: Break down calls, tokens, cost, latency, and failures by model, provider, account, credential, API key, project, channel, and time range. Sync model prices from models.dev with LiteLLM and OpenRouter fallbacks.
  • Account Health, Quota, and Automation: Inspect Codex and xAI accounts, read quota windows, reset evidence, credential state, workspace state, and apply controlled quota cooldowns. Route credential failures into an account action queue.
  • Production Operations: Run as one Docker container or native package (Linux, macOS, Windows) for amd64/arm64. Back up SQLite files with data.key. No account registration or telemetry SDK.

Use cases

  • Diagnose why requests are failing by inspecting failure rates, status codes, affected models/accounts, and redacted evidence.
  • Track where costs are going by breaking down tokens and estimated cost by model, provider, account, API key, project, channel, and time range.
  • Monitor account and quota health by reviewing credential state, quota windows, reset evidence, and controlled automation for Codex and xAI accounts.

Getting started

For a guided full-stack or CPAMP-only deployment: bash curl -fsSLO https://raw.githubusercontent.com/seakee/CPA-Manager-Plus/main/bin/install-cpamp.sh bash install-cpamp.sh Preview without deploying: bash CPAMP_DRY_RUN=1 bash install-cpamp.sh To run CPA + CPAMP together with Docker Compose: ```yaml 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: bash docker compose up -d Open `http://:18317/management.html`, retrieve the CPAMP Admin Key from the Manager Server log, then enter the CPA URL and CPA Management Key during setup. For CPAMP only (if CPA is already running): bash 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.3.4+. The HTTP usage queue needs v6.10.8+.

License and pricing

The project is licensed under MIT and is open source.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/seakeecpa-manager-plus.svg)](https://yunodb.com/tools/seakeecpa-manager-plus?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/seakeecpa-manager-plus?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/seakeecpa-manager-plus.svg" alt="Featured on YunoDB" height="20"></a>