cliproxyapi-plusplus
Welcome to the unified docs surface.
cliproxyapi-plusplus Docs
cliproxyapi-plusplus is an OpenAI-compatible proxy that routes one client API surface to multiple upstream providers.
Who This Documentation Is For
- Operators running a shared internal LLM gateway.
- Platform engineers integrating existing OpenAI-compatible clients.
- Developers embedding cliproxyapi-plusplus in Go services.
- Incident responders who need health, logs, and management endpoints.
What You Can Do
- Use one endpoint (
/v1/*) across heterogeneous providers. - Configure routing and model-prefix behavior in
config.yaml. - Manage credentials and runtime controls through management APIs.
- Monitor health and per-provider metrics for operations.
Start Here
- Getting Started for first run and first request.
- Install for Docker, binary, and source options.
- Provider Usage for provider strategy and setup patterns.
- Provider Quickstarts for provider-specific 5-minute success paths.
- Provider Catalog for provider block reference.
- Provider Operations for on-call runbook and incident workflows.
- Routing and Models Reference for model resolution behavior.
- Troubleshooting for common failures and concrete fixes.
- Planning Boards for source-linked execution tracking and import-ready board artifacts.
API Surfaces
- API Index for endpoint map and when to use each surface.
- OpenAI-Compatible API for
/v1/*request patterns. - Management API for runtime inspection and control.
- Operations API for health and operational workflows.
Audience-Specific Guides
- Docsets for user, developer, and agent-focused guidance.
- Feature Guides for deeper behavior and implementation notes.
- Planning Boards for source-to-solution mapping across issues, PRs, discussions, and external requests.
Fast Verification Commands
bash
# Basic process health
curl -sS http://localhost:8317/health
# List models exposed by your current auth + config
curl -sS http://localhost:8317/v1/models | jq '.data[:5]'
# Check provider-side rolling stats
curl -sS http://localhost:8317/v1/metrics/providers | jq