DEV.co
Open-Source Observability · seakee

CPA-Manager-Plus

CPA Manager Plus is a self-hosted dashboard for monitoring AI gateway traffic, tracking requests, costs, failures, and account health. It integrates with CPA/CLIProxyAPI and OpenAI-compatible gateways, storing all data locally with no cloud dependencies or telemetry.

Source: GitHub — github.com/seakee/CPA-Manager-Plus
1.4k
GitHub stars
148
Forks
TypeScript
Primary language
MIT
License (OSI-approved)

Key facts

Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.

FieldValue
Repositoryseakee/CPA-Manager-Plus
Ownerseakee
Primary languageTypeScript
LicenseMIT — OSI-approved
Stars1.4k
Forks148
Open issues30
Latest releasev1.10.4 (2026-07-08)
Last updated2026-07-08
Sourcehttps://github.com/seakee/CPA-Manager-Plus

What CPA-Manager-Plus is

TypeScript-based monitoring and management dashboard that aggregates metrics from AI gateways, performs scheduled account health inspections, tracks token usage and cost estimates, and manages quota limits. Runs as a single Docker container or native binary with file-based data storage.

Quickstart

Get the CPA-Manager-Plus source

Clone the repository and explore it locally.

terminalbash
git clone https://github.com/seakee/CPA-Manager-Plus.gitcd CPA-Manager-Plus# follow the project's README for install & configuration

Need it deployed, integrated, or customized instead? DEV.co ships production installs.

Best use cases

Cost Attribution and Breakdown

Track spending by model, provider, account, and project with token-level granularity (input, output, reasoning, cached). Supports arbitrary date range filtering and exports for billing reconciliation.

Gateway Traffic Troubleshooting

Real-time visibility into request success rates, latency, status codes, and failure reasons. Searchable request history with account and API key filtering to isolate issues quickly.

Codex/Claude Code Account Quota Management

Scheduled inspections verify credential validity, quota remaining, plan tier, and reset schedules. Automatically pauses accounts that hit usage limits and re-enables them at reset time.

Implementation considerations

  • Requires CPA v6.10.8+ for HTTP usage queue; v7.1.39+ recommended. Verify gateway version and API compatibility before deployment.
  • All data is file-based and local; plan backup strategy and disk storage capacity based on retention policy and expected request volume.
  • Scheduled account inspections (quota, credential validity) require outbound connectivity to configured gateway and optional external services (price sync, OAuth providers).
  • Admin key is generated on first run; retrieve from logs and secure appropriately. No built-in key rotation or expiration visible in documentation.
  • Single Docker container deployment is simple, but no mention of HA, clustering, or failover support for production environments.

When to avoid it — and what to weigh

  • Multi-Tenant SaaS Platform — Not designed for isolating customer data or enforcing multi-tenant security boundaries. File-based storage and shared local configuration are unsuitable for isolated user tenants.
  • Real-Time Analytics at Scale — File-based storage may not meet performance requirements for high-volume gateways (millions of requests). No mention of database backend, sharding, or horizontal scaling.
  • Air-Gapped or Strict Network Isolation — Optional features (model price sync from LiteLLM/OpenRouter, OAuth, provider checks) require outbound internet connectivity. Not suitable if all external calls must be prohibited.
  • Proprietary Gateway Without OpenAI Compatibility — Requires CPA/CLIProxyAPI or OpenAI-compatible gateway. Will not work with fully proprietary AI inference systems lacking standard interfaces.

License & commercial use

MIT License. Permits commercial use, modification, and distribution with proper attribution. No restriction on proprietary derivative works.

MIT is a permissive OSI license that explicitly allows commercial use. You may use CPA Manager Plus in commercial products without restriction, provided you include license attribution. No per-seat licensing, vendor lock-in, or usage-based fees implied by the license.

DEV.co evaluation signals

Editorial assessment — not user reviews. Directional, with an explicit confidence level.

SignalAssessment
MaintenanceActive
DocumentationStrong
License clarityClear
Deployment complexityLow
DEV.co fitStrong
Assessment confidenceHigh
Security considerations

Self-hosted architecture means no third-party access to data or accounts. File-based storage is local; secure the host OS and file permissions accordingly. Admin key protection depends on operator discipline. Outbound calls (optional features) should be reviewed if operating in restricted networks. No explicit mention of input validation, SQL injection prevention (N/A for file storage), or HTTPS/TLS configuration in data excerpts; review full documentation.

Alternatives to consider

LiteLLM Proxy + Custom Dashboards

LiteLLM offers similar gateway routing and cost tracking; requires building custom dashboard and monitoring logic. More flexible but higher operational burden.

OpenRouter Dashboard

OpenRouter provides native cost analytics and account health for their platform, but locks you into their gateway. No self-hosted option or support for multiple providers.

Custom In-House Solution

Build monitoring directly into your gateway or middleware. Maximum control and integration, but significant engineering effort and ongoing maintenance.

Software development agency

Build on CPA-Manager-Plus with DEV.co software developers

Get real-time visibility into AI costs and gateway health. Install via one-click script or Docker Compose in minutes.

Talk to DEV.co

Related open-source tools

Surfaced by semantic similarity across the DEV.co open-source index.

Related on DEV.co

Explore the category and the services that help you build with it.

CPA-Manager-Plus FAQ

Can I run CPA Manager Plus without CPA/CLIProxyAPI?
Yes, it supports any OpenAI-compatible gateway. CPA is the primary integration, but not required if your gateway exposes compatible APIs.
Where is my data stored?
All data is stored in local files inside the container volume or native binary data directory. No cloud sync or external database by default.
Does CPAMP phone home or collect telemetry?
No. By default, it only calls your configured gateway. Optional features (model price sync, OAuth, provider checks) use external services you explicitly configure or trigger.
What happens if an account hits its quota limit?
CPAMP automatically pauses the account (disables auth file) and re-enables it at the scheduled reset time. Manual disables are not overridden.

Custom software development services

Adopting CPA-Manager-Plus is usually one piece of a larger software development effort. As a software development agency, DEV.co provides software development services and web development expertise — pairing senior software developers and web developers with your team to design, build, and operate open-source observability software in production.

Deploy CPA Manager Plus for Your Gateway

Get real-time visibility into AI costs and gateway health. Install via one-click script or Docker Compose in minutes.