chuan/CLIProxyAPI
1
0
Fork 0
mirror of https://github.com/router-for-me/CLIProxyAPI.git synced 2026-03-02 04:24:11 +08:00
Code Issues Packages Projects Releases Wiki Activity
684 Commits 5 Branches 504 Tags
a6cb16bb481bc901adafe4d8ff5ee73acfc89dfd
Commit Graph

54 Commits

  • feat: Add Amp CLI integration with comprehensive documentation 
    Add full Amp CLI support to enable routing AI model requests through the proxy
while maintaining Amp-specific features like thread management, user info, and
telemetry. Includes complete documentation and pull bot configuration.

Features:
- Modular architecture with RouteModule interface for clean integration
- Reverse proxy for Amp management routes (thread/user/meta/ads/telemetry)
- Provider-specific route aliases (/api/provider/{provider}/*)
- Secret management with precedence: config > env > file
- 5-minute secret caching to reduce file I/O
- Automatic gzip decompression for responses
- Proper connection cleanup to prevent leaks
- Localhost-only restriction for management routes (configurable)
- CORS protection for management endpoints

Documentation:
- Complete setup guide (USING_WITH_FACTORY_AND_AMP.md)
- OAuth setup for OpenAI (ChatGPT Plus/Pro) and Anthropic (Claude Pro/Max)
- Factory CLI config examples with all model variants
- Amp CLI/IDE configuration examples
- tmux setup for remote server deployment
- Screenshots and diagrams

Configuration:
- Pull bot disabled for this repo (manual rebase workflow)
- Config fields: AmpUpstreamURL, AmpUpstreamAPIKey, AmpRestrictManagementToLocalhost
- Compatible with upstream DisableCooling and other features

Technical details:
- internal/api/modules/amp/: Complete Amp routing module
- sdk/api/httpx/: HTTP utilities for gzip/transport
- 94.6% test coverage with 34 comprehensive test cases
- Clean integration minimizes merge conflict risk

Security:
- Management routes restricted to localhost by default
- Configurable via amp-restrict-management-to-localhost
- Prevents drive-by browser attacks on user data

This provides a production-ready foundation for Amp CLI integration while
maintaining clean separation from upstream code for easy rebasing.

Amp-Thread-ID: https://ampcode.com/threads/T-9e2befc5-f969-41c6-890c-5b779d58cf18
    Ben Vargas · 2025-11-19 18:23:17 -07:00
    9ad0f3f91e
  • **refactor(api/config): centralize legacy OpenAI compatibility key migration** 
    Introduce `migrateLegacyOpenAICompatibilityKeys` to streamline and reuse the normalization of OpenAI compatibility entries. Remove redundant loops and enhance maintainability for compatibility key handling. Add cleanup for legacy `api-keys` in YAML configuration during persistence.
    Luis Pater · 2025-11-16 11:39:35 +08:00
    1d0f0301b4
  • **feat(runtime): add payload configuration support for executors** 
    Introduce `PayloadConfig` in the configuration to define default and override rules for modifying payload parameters. Implement `applyPayloadConfig` and `applyPayloadConfigWithRoot` to apply these rules across various executors, ensuring consistent parameter handling for different models and protocols. Update all relevant executors to utilize this functionality.
    Luis Pater · 2025-11-13 23:27:40 +08:00
    fcd98f4f9b
  • fix(management): improve error handling and normalize YAML comment indentation 
    Enhance error management for file operations and clean up temporary files. Add `NormalizeCommentIndentation` function to ensure YAML comments maintain consistent formatting.
    Luis Pater · 2025-11-11 08:37:57 +08:00
    dc804e96fb
  • fix(management): sanitize keys and normalize headers
    hkfires · 2025-11-09 12:13:02 +08:00
    51d2766d5c
  • refactor(config): rename SyncGeminiKeys; use Sanitize* methods
    hkfires · 2025-11-09 08:29:47 +08:00
    a00ba77604
  • feat(config): support HTTP headers across providers
    hkfires · 2025-11-08 20:52:05 +08:00
    cfb9cb8951
  • fix(config): skip persisting empty API key and compat entries
    hkfires · 2025-10-31 15:56:47 +08:00
    2021ae3891
  • fix(config): stabilize YAML sequence merges by reordering items
    hkfires · 2025-10-31 15:21:58 +08:00
    5c65938113
  • fix(config): dedupe and normalize Gemini keys and headers
    hkfires · 2025-10-31 13:20:10 +08:00
    16be3f0a12
  • feat(gemini): add Gemini API key endpoints
    hkfires · 2025-10-31 11:09:28 +08:00
    7c1c4ee60b
  • feat(claude): add model alias mapping and improve key normalization 
    - Introduced model alias mapping for Claude configurations, enabling upstream and client-facing model name associations.
- Added `computeClaudeModelsHash` to generate a consistent hash for model aliases.
- Implemented `normalizeClaudeKey` function to standardize input API key configuration, including models.
- Enhanced executor to resolve model aliases to upstream names dynamically.
- Updated documentation and configuration examples to reflect new model alias support.
    Luis Pater · 2025-10-28 00:14:19 +08:00
    c7196ba7dc
  • feat(ws): add WebSocket auth
    hkfires · 2025-10-26 07:46:04 +08:00
    359b8de44e
  • feat: add DisableCooling configuration to manage quota cooldown behavior
    Luis Pater · 2025-10-21 21:51:30 +08:00
    9678be7aa4
  • feat(config): use block style for YAML maps/lists; keep [] for empty
    hkfires · 2025-10-14 15:43:58 +08:00
    4bc1ed6031
  • feat(config): Treat empty BaseURL for Codex keys as deletion
    hkfires · 2025-10-13 13:48:27 +08:00
    0aa8706ef7
  • feat(config): Remove OpenAI providers with empty BaseURL
    hkfires · 2025-10-13 13:48:27 +08:00
    5fd4a8b974
  • feat(config): disable logging and usage stats by default
    hkfires · 2025-10-11 22:11:08 +08:00
    4c033b3af7
  • feat(config): Gracefully handle empty or invalid optional config
    hkfires · 2025-10-11 20:49:15 +08:00
    fc6aa8ef77
  • refactor(provider): remove Gemini Web cookie-based support
    hkfires · 2025-10-11 12:56:07 +08:00
    c3f88126e6
  • fix(config): treat directory as absent for optional config in cloud deploy mode
    hkfires · 2025-10-10 19:40:02 +08:00
    78738ca3f0
  • feat(server): Add cloud deploy mode
    hkfires · 2025-10-10 18:52:43 +08:00
    ac01c74c02
  • feat(gemini-web): Replace code-mode with flexible gem-mode
    hkfires · 2025-10-07 19:36:22 +08:00
    43665cb649
  • feat(management): add support for control panel asset synchronization 
    - Introduced `EnsureLatestManagementHTML` to sync `management.html` asset from the latest GitHub release.
- Added config option `DisableControlPanel` to toggle control panel functionality.
- Serve management control panel via `/management.html` endpoint, with automatic download and update mechanism.
- Updated `.gitignore` to include `static/*` directory for control panel assets.
    Luis Pater · 2025-10-01 03:18:39 +08:00
    c589c0d998
  • refactor(auth): simplify inline API key provider logic and improve configuration consistency 
    - Replaced `SyncInlineAPIKeys` with `MakeInlineAPIKeyProvider` for better clarity and reduced redundancy.
- Removed legacy logic for inline API key syncing and migration.
- Enhanced provider synchronization logic to handle empty states consistently.
- Added normalization to API key handling across configurations.
- Updated handlers to reflect streamlined provider update logic.
    Luis Pater · 2025-10-01 00:55:09 +08:00
    7c157d6ab1
  • feat(auth): add per-key proxy support and enhance API key configuration handling 
    - Introduced `ProxyURL` field to Claude and Codex API key configurations.
- Added support for `api-key-entries` in OpenAI compatibility section with per-key proxy configuration.
- Maintained backward compatibility for legacy `api-keys` format.
- Updated logic to prioritize `api-key-entries` where applicable.
- Improved documentation and examples to reflect new proxy support.
    Luis Pater · 2025-09-30 09:24:40 +08:00
    f6de2a709f
  • fix(config): Inline SDKConfig for proper YAML parsing
    hkfires · 2025-09-27 12:23:20 +08:00
    da72ac1f6d
  • refactor(access): migrate to SDKConfig for authentication and provider management 
    - Replaced `config.Config` with `SDKConfig` in authentication and provider logic for consistency with SDK changes.
- Updated provider registration, reconciliation, and build functions to align with the `SDKConfig` structure.
- Refactored related imports and handlers to support the new configuration approach.
- Improved clarity and reduced redundancy in API key synchronization and provider initialization.
    Luis Pater · 2025-09-27 05:18:11 +08:00
    d512f20c56
  • refactor(config): migrate to SDKConfig and streamline proxy handling 
    - Replaced `config.Config` with `config.SDKConfig` across components for simpler configuration management.
- Updated proxy setup functions and handlers to align with `SDKConfig` improvements.
- Reorganized handler imports to match new SDK structure.
    Luis Pater · 2025-09-27 04:50:23 +08:00
    57c9ba49f4
  • feat(config, usage): add usage-statistics-enabled option and dynamic toggling 
    - Introduced `usage-statistics-enabled` configuration to control in-memory usage aggregation.
- Updated API to include handlers for managing `usage-statistics-enabled` and `logging-to-file` options.
- Enhanced `watcher` to log changes to both configurations dynamically.
- Updated documentation and examples to reflect new configuration options.
    Luis Pater · 2025-09-26 03:19:44 +08:00
    25ba042493
  • feat(logging): introduce centralized logging with custom format and Gin integration 
    - Implemented a global logger with structured formatting for consistent log output.
- Added support for rotating log files using Lumberjack.
- Integrated new logging functionality with Gin HTTP server for unified log handling.
- Replaced direct `log.Info` calls with `fmt.Printf` in non-critical paths to simplify core functionality.
    Luis Pater · 2025-09-26 00:54:52 +08:00
    cf734f7e7b
  • rebuild branch
    Luis Pater · 2025-09-25 10:32:48 +08:00
    f5dc380b63
  • remove all
    Luis Pater · 2025-09-25 10:31:02 +08:00
    3f69254f43
  • refactor(config, auth): remove allow-localhost-unauthenticated support and related handlers 
    - Eliminated `allow-localhost-unauthenticated` configuration field and its usage.
- Removed associated management API handlers and middleware logic.
- Simplified authentication middleware by deprecating localhost-specific checks.
    Luis Pater · 2025-09-25 09:00:38 +08:00
    688547b063
  • refactor(config): remove force-gpt-5-codex option and related handlers 
    - Eliminated the deprecated `force-gpt-5-codex` configuration option from all configs, handlers, and documentation.
- Updated examples and README files to reflect the removal.
- Streamlined related code by dropping unused fields and logging.
    Luis Pater · 2025-09-25 08:19:45 +08:00
    58f74ebad1
  • refactor(gemini-web): Remove auto-refresh, auto-close, and caching 
    This commit simplifies the Gemini web client by removing several complex, stateful features. The previous implementation for auto-refreshing cookies and auto-closing the client involved background goroutines, timers, and file system caching, which made the client's lifecycle difficult to manage.

The following features have been removed:
- The cookie auto-refresh mechanism, including the background goroutine (`rotateCookies`) and related configuration fields.
- The file-based caching for the `__Secure-1PSIDTS` token. The `rotate1PSIDTS` function now fetches a new token on every call.
- The auto-close functionality, which used timers to close the client after a period of inactivity.
- Associated configuration options and methods (`WithAccountLabel`, `WithOnCookiesRefreshed`, `Close`, etc.).

By removing this logic, the client becomes more stateless and predictable. The responsibility for managing the client's lifecycle and handling token expiration is now shifted to the caller, leading to a simpler and more robust integration.
    hkfires · 2025-09-23 12:48:30 +08:00
    8e485e5868
  • feat(auth): introduce auth.providers for flexible authentication configuration 
    - Replaced legacy `api-keys` field with `auth.providers` in configuration, supporting multiple authentication providers including `config-api-key`.
- Added synchronization to maintain compatibility with legacy `api-keys`.
- Updated core components like request handling and middleware to use the new provider system.
- Enhanced management API endpoints for seamless integration with `auth.providers`.
    Luis Pater · 2025-09-22 17:36:31 +08:00
    4008be19f4
  • feat(gemini-web): squash all features and fixes for gemini-web
    hkfires · 2025-09-17 20:24:23 +08:00
    e4dd22b260
  • Add support for forcing GPT-5 Codex model configuration 
    - Introduced a new `ForceGPT5Codex` configuration option in settings.
- Added relevant API endpoints for managing `ForceGPT5Codex`.
- Enhanced Codex client to handle GPT-5 Codex-specific logic and mapping.
- Updated example configuration file to include the new option.

Add GPT-5 Codex model support and configuration options in documentation
    Luis Pater · 2025-09-16 04:40:19 +08:00
    b84cbee77a
  • Add JSON annotations to configuration structs and new /config management endpoint 
    - Added JSON annotations across all configuration structs in `config.go`.
- Introduced `/config` management API endpoint to fetch complete configuration.
- Updated management API documentation (`MANAGEMENT_API.md`, `MANAGEMENT_API_CN.md`) with `/config` usage.
- Implemented `GetConfig` handler in `config_basic.go`.
    Luis Pater · 2025-09-06 20:45:51 +08:00
    6164f5c35b
  • Add support for Codex API key authentication 
    - Introduced functionality to handle Codex API keys, including initialization and management via new endpoints in the management API.
- Updated Codex client to support both OAuth and API key authentication.
- Documented Codex API key configuration in both English and Chinese README files.
- Enhanced logging to distinguish between API key and OAuth usage scenarios.
    Luis Pater · 2025-09-03 03:36:56 +08:00
    c4a42eb1f0
  • Add management API handlers for config and auth file management 
    - Implemented CRUD operations for authentication files.
- Added endpoints for managing API keys, quotas, proxy settings, and other configurations.
- Enhanced management access with robust validation, remote access control, and persistence support.
- Updated README with new configuration details.

Fixed OpenAI Chat Completions for codex
    Luis Pater · 2025-08-31 14:29:23 +08:00
    db43930b98
  • Add support for localhost unauthenticated requests 
    - Introduced `AllowLocalhostUnauthenticated` flag allowing unauthenticated requests from localhost.
- Updated authentication middleware to bypass checks for localhost when enabled.

Add new Gemini CLI models and update model registry function

- Introduced `GetGeminiCLIModels` for updated Gemini CLI model definitions.
- Added new models: "Gemini 2.5 Flash Lite" and "Gemini 2.5 Pro".
- Updated `RegisterModels` to use `GetGeminiCLIModels` in Gemini client initialization.
    Luis Pater · 2025-08-27 21:20:25 +08:00
    1c4183d943
  • Add OpenAI compatibility support and improve resource cleanup 
    - Introduced OpenAI compatibility configurations for external providers, enabling model alias routing via the OpenAI API format.
- Enhanced provider logic in `GetProviderName` to handle OpenAI aliases and added new helper functions for compatibility checks.
- Updated API handlers and client initialization to support OpenAI compatibility models.
- Improved resource cleanup across clients by closing response bodies and streams using deferred functions.
    Luis Pater · 2025-08-26 03:33:46 +08:00
    ed8873fbb0
  • Refactor API handlers to implement retry mechanism with configurable limits and improved error handling 
    - Introduced retry counter with a configurable ` RequestRetry ` limit in all handlers.
- Enhanced error handling with specific HTTP status codes for switching clients.
- Standardized response forwarding for non-retriable errors.
- Improved logging for quota and client switch scenarios.
    Luis Pater · 2025-08-25 23:43:49 +08:00
    9102ff031d
  • Refactor codebase
    Luis Pater · 2025-08-25 16:58:16 +08:00
    8c555c4e69
  • Add claude code support
    Luis Pater · 2025-08-21 02:53:28 +08:00
    d58cc55cb2
  • Add openai codex support
    Luis Pater · 2025-08-16 01:22:33 +08:00
    de7b8501cc
  • Refactor API handlers organization and simplify error response handling 
    - Modularized handlers into dedicated packages (`gemini`, `claude`, `cli`) for better structure.
- Centralized `ErrorResponse` and `ErrorDetail` types under `handlers` package for reuse.
- Updated all handlers to utilize the shared `ErrorResponse` model.
- Introduced specialization of handler structs (`GeminiAPIHandlers`, `ClaudeCodeAPIHandlers`, `GeminiCLIAPIHandlers`) for improved clarity and separation of concerns.
- Refactored `getClient` logic with additional properties and better state management.

Refactor `translator` package by modularizing code for `claude` and `gemini`

- Moved Claude-specific logic (`PrepareClaudeRequest`, `ConvertCliToClaude`) to `translator/claude/code`.
- Moved Gemini-specific logic (`FixCLIToolResponse`) to `translator/gemini/cli` for better package structure.
- Updated affected handler imports and method references.

Add comprehensive package-level documentation across key modules

- Introduced detailed package-level documentation for core modules: `auth`, `client`, `cmd`, `handlers`, `util`, `watcher`, `config`, `translator`, and `api`.
- Enhanced code readability and maintainability by clarifying the purpose and functionality of each package.
- Aligned documentation style and tone with existing codebase conventions.

Refactor API handlers and translator modules for improved clarity and consistency

- Standardized handler struct names (`GeminiAPIHandlers`, `ClaudeCodeAPIHandlers`, `GeminiCLIAPIHandlers`, `OpenAIAPIHandlers`) and updated related comments.
- Fixed unnecessary `else` blocks in streaming logic for cleaner error handling.
- Renamed variables for better readability (`responseIdResult` to `responseIDResult`, `activationUrl` to `activationURL`, etc.).
- Addressed minor inconsistencies in API handler comments and SSE header initialization.
- Improved modularization of `claude` and `gemini` translator components.

Standardize configuration field naming for consistency across modules

- Renamed `ProxyUrl` to `ProxyURL`, `ApiKeys` to `APIKeys`, and `ConfigQuotaExceeded` to `QuotaExceeded`.
- Updated all relevant references and comments in `config`, `auth`, `api`, `util`, and `watcher`.
- Ensured consistent casing for `GlAPIKey` debug logs.
    Luis Pater · 2025-08-05 23:11:31 +08:00
    1483c31c73
  • Add support for Generative Language API Key and improve client initialization 
    - Added `GlAPIKey` support in configuration to enable Generative Language API.
- Integrated `GenerativeLanguageAPIKey` handling in client and API handlers.
- Updated response translators to manage generative language responses properly.
- Enhanced HTTP client initialization logic with proxy support for API requests.
- Refactored streaming and non-streaming flows to account for generative language-specific logic.
    Luis Pater · 2025-07-06 02:13:11 +08:00
    589ae6d3aa