From 7d87cfa4482de239a3c2a23257885a882ef53192 Mon Sep 17 00:00:00 2001 From: Tam Nhu Tran Date: Thu, 19 Mar 2026 10:24:34 -0400 Subject: [PATCH] docs(cliproxy): document api profile bridge flow - explain the new CLIProxy to API Profiles bridge in README - record issue #649 in roadmap and PDR updates Refs #649 --- README.md | 4 +++- docs/project-overview-pdr.md | 7 +++++-- docs/project-roadmap.md | 5 +++-- 3 files changed, 11 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 815aa9fb..400629ec 100644 --- a/README.md +++ b/README.md @@ -80,7 +80,7 @@ The dashboard provides visual management for all account types: - **Claude Accounts**: Isolation-first by default (work, personal, client), with explicit shared context opt-in - **OAuth Providers**: One-click auth for Gemini, Codex, Antigravity, Kiro, Copilot -- **API Profiles**: Configure GLM, Kimi with your keys +- **API Profiles**: Configure GLM, Kimi with your keys, or create routed profiles from configured CLIProxy providers without copying proxy URLs or internal tokens - **Factory Droid**: Track Droid install location and BYOK settings health - **Updates Center**: Track support rollouts (Droid target, CLIProxy provider changes, WebSearch integrations) - **Health Monitor**: Real-time status across all profiles @@ -148,6 +148,8 @@ The dashboard provides visual management for all account types: > **OAuth providers** authenticate via browser on first run. Tokens are cached in `~/.ccs/cliproxy/auth/`. +> **CLIProxy -> API Profiles bridge:** After you configure a provider in `ccs config` -> `CLIProxy` or the embedded control panel, open `API Profiles` and use the CLIProxy provider entry to create a routed profile. CCS fills the provider route and current proxy auth automatically. + **Powered by:** - [CLIProxyAPIPlus](https://github.com/router-for-me/CLIProxyAPIPlus) - Extended OAuth proxy with Kiro ([@fuko2935](https://github.com/fuko2935), [@Ravens2121](https://github.com/Ravens2121)) and Copilot ([@em4go](https://github.com/em4go)) support - [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI) - Core OAuth proxy for Gemini, Codex, Antigravity diff --git a/docs/project-overview-pdr.md b/docs/project-overview-pdr.md index f6384588..0d85756b 100644 --- a/docs/project-overview-pdr.md +++ b/docs/project-overview-pdr.md @@ -1,6 +1,6 @@ # CCS Product Development Requirements (PDR) -Last Updated: 2026-02-04 +Last Updated: 2026-03-19 ## Product Overview @@ -37,6 +37,8 @@ CCS provides: 5. **Automatic WebSearch**: MCP fallback for third-party providers 6. **Usage Analytics**: Token tracking, cost analysis, model breakdown +Configured CLIProxy providers can also be bridged into routed API Profiles from the dashboard, so users do not have to hand-copy `/api/provider/{provider}` URLs or internal proxy auth tokens. + --- ## Target Users @@ -73,6 +75,7 @@ CCS provides: - Support Anthropic-compatible APIs - Model mapping and configuration - OpenRouter integration with 300+ models +- Create routed API Profiles from configured CLIProxy providers without manually copying proxy URLs or internal auth tokens ### FR-005: Dashboard UI - Visual profile management @@ -332,5 +335,5 @@ CCS provides: - [Codebase Summary](./codebase-summary.md) - Technical structure - [Code Standards](./code-standards.md) - Development conventions -- [System Architecture](./system-architecture.md) - Architecture diagrams +- [System Architecture](./system-architecture/index.md) - Architecture diagrams - [Project Roadmap](./project-roadmap.md) - Development phases and GitHub issues diff --git a/docs/project-roadmap.md b/docs/project-roadmap.md index ebaef666..97f3aabe 100644 --- a/docs/project-roadmap.md +++ b/docs/project-roadmap.md @@ -1,6 +1,6 @@ # CCS Project Roadmap -Last Updated: 2026-03-18 +Last Updated: 2026-03-19 Forward-looking roadmap documenting current priorities, GitHub issues, and future feature plans. @@ -41,6 +41,7 @@ All major modularization work is complete. The codebase evolved from monolithic ### Recent Fixes +- **2026-03-19**: **#649** CLIProxy and API Profiles now share a guided bridge flow. Users can configure a provider in CLIProxy or the embedded control panel, jump into `API Profiles`, and create a routed profile without manually typing `/api/provider/{provider}` URLs, proxy auth tokens, or default model wiring. Bridge profiles are labeled in the API list/editor and resolve against the current local or remote CLIProxy target. - **2026-03-18**: **#755** Marketplace refresh no longer reuses one shared `known_marketplaces.json` across isolated instances. CCS now keeps marketplace payload directories shared while reconciling per-instance marketplace metadata so Claude Code validation succeeds for alternating or concurrent profiles, including Windows copy fallback. - **2026-03-17**: Deprecated user-facing GLMT discovery across CLI help, completions, presets, and docs. Existing `glmt` profiles now run through a compatibility path that normalizes legacy proxy settings to the direct GLM endpoint. - **#748**: API profile creation now keeps provider selection compact by collapsing advanced presets behind an explicit toggle, shrinking chooser cards so the form fields stay visually primary, and giving `llama.cpp` a dedicated provider logo. @@ -240,6 +241,6 @@ The check mode supports a maintainability regression gate that blocks increases - [Codebase Summary](./codebase-summary.md) - Current structure - [Code Standards](./code-standards.md) - Patterns and conventions -- [System Architecture](./system-architecture.md) - Architecture diagrams +- [System Architecture](./system-architecture/index.md) - Architecture diagrams - [Hardening Debt Burndown Tracker](./hardening-debt-burndown.md) - Legacy shim + sync-fs debt tracking - [CLAUDE.md](../CLAUDE.md) - AI development guidance