Commit Graph
145 Commits
Author SHA1 Message Date
Tam Nhu Tran 60b1c043c7 feat(droid): align BYOK provider mapping for ccsd
- add Droid provider resolver aligned with Factory BYOK schema

- persist and normalize CCS_DROID_PROVIDER across CLI and dashboard flows

- use Droid managed selector aliases with safe legacy fallback

- add unit coverage for provider inference and selector usage

Closes #632
2026-02-25 20:58:35 +07:00
Tam Nhu Tran 0a5b12b46b docs(readme): document dashboard updates center
- add direct updates hub URL under dashboard quick start

- include Updates Center in dashboard capability overview
2026-02-25 18:05:53 +07:00
Tam Nhu Tran 172e599574 docs(cli): document target defaults and ccsd cliproxy usage
- add multi-target help examples for ccsd codex and ccsd agy

- document per-profile target defaults for API and CLIProxy profiles

- include dashboard parity notes for target configuration
2026-02-25 15:54:22 +07:00
Tam Nhu Tran 0309630193 fix(auth): harden shared-context isolation and config safety 2026-02-25 04:19:28 +07:00
Tam Nhu Tran 4fed74c64b feat(auth): add opt-in shared context groups across accounts 2026-02-24 23:54:03 +07:00
Tam Nhu Tran 0aed60febb fix(ci): enforce parity gate and stabilize test execution 2026-02-23 23:53:09 +07:00
Tam Nhu Tran 2385d9028a feat(cliproxy): add Claude quota windows and account failover 2026-02-22 01:19:02 +07:00
Tam Nhu Tran f2ffb815ab docs(spawn): document claudecode env sanitization behavior
- note delegation compatibility with Claude nested-session guard

- document CLAUDECODE sanitization invariant in code standards

Refs #588
2026-02-20 23:01:21 +07:00
Tam Nhu Tran cf8070b5f0 fix(profile): handle km compatibility for legacy kimi api users 2026-02-19 12:43:41 +07:00
Tam Nhu Tran 91edc9565b docs(targets): document built-in and env droid aliases
- add README guidance for ccsd argv[0] auto-target behavior

- document CCS_DROID_ALIASES runtime extension in architecture docs
2026-02-17 20:53:03 +07:00
Tam Nhu Tran 4fc19c4390 feat(cliproxy): expose codex weekly reset schedule in quota views 2026-02-15 09:48:39 +07:00
Tam Nhu Tran 14dd34187d docs(kiro): document method-aware auth behavior
- add README Kiro auth-method examples and AWS default details

- update architecture docs for method-aware Kiro flow semantics

Refs #552

Refs #233
2026-02-14 13:34:08 +07:00
Tam Nhu Tran 8395364970 feat(cliproxy): add explicit start and restart commands 2026-02-14 09:41:40 +07:00
Tam Nhu Tran 0e55db88a5 fix(cursor): address CI gate and review regressions 2026-02-14 06:41:57 +07:00
Tam Nhu Tran be9d7cf73e feat(cursor): complete daemon wiring and add dedicated dashboard page 2026-02-14 06:22:28 +07:00
Huynh Duc DungandClaude c9604be5e1 docs: add Ollama to Built-in Providers table and usage examples
Update README.md to include:
- Ollama and Ollama Cloud in the Built-in Providers table
- Ollama integration note with setup instructions
- ccs ollama in Basic Commands section
- Ollama example in Parallel Workflows

Ref: https://github.com/kaitranntt/ccs/pull/354

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-22 17:04:36 +08:00
opastorello a14c7f3f6b feat(docker): add Docker/Compose setup for CCS dashboard 2026-01-17 00:19:53 -03:00
kaitranntt eee62a46a2 docs: update minimax preset references to 'mm'
Align README and CLI help with actual preset ID.
2026-01-14 17:43:52 -05:00
kaitranntt 8ea1e333bc docs(agy): add quota management and failover documentation
- Add ccs cliproxy doctor command to help text
- Document Antigravity auto-failover in README
2026-01-05 13:31:34 -05:00
kaitranntt e7066b9997 feat(api): add Minimax, DeepSeek, Qwen provider presets
Add three new Anthropic-compatible API providers as presets:
- Minimax: M2.1/M2.1-lightning/M2 models with 1M context
- DeepSeek: V3.2 and R1 reasoning model (128K context)
- Qwen: Alibaba Cloud qwen3-coder-plus (256K context)

Closes #123
2025-12-24 18:32:07 -05:00
kaitrannttandMinhOmega 31bafaab8d feat(api): add Azure Foundry preset
Add Microsoft Azure AI Foundry as a provider preset for `ccs api create`.

Usage: `ccs api create --preset foundry`

This is a cleaner implementation than the postinstall-based approach,
leveraging the existing preset system.

Co-authored-by: MinhOmega <49482201+MinhOmega@users.noreply.github.com>
2025-12-22 15:34:27 -05:00
kaitranntt b93b91c925 docs: update documentation for kiro and ghcp providers
- add ccs kiro and ccs ghcp to README commands

- update project-overview-pdr with v7.2 and FR-003 OAuth flows

- update system-architecture with OAuth flow types

- update codebase-summary with 7 CLIProxy providers

- update project-roadmap with Phase 11 completion
2025-12-22 01:09:25 -05:00
kaitranntt 743d34a881 docs: add CLIProxyAPIPlus attribution for Kiro and Copilot
- Credit CLIProxyAPIPlus contributors for new OAuth providers
- Add @em4go (Copilot), @fuko2935, @Ravens2121 (Kiro)
2025-12-21 22:28:13 -05:00
kaitranntt ec7781bbc8 docs: update documentation for v7.1 remote CLIProxy feature
- README: add remote CLIProxy section with CLI flags and quick setup
- code-standards: add Config Priority Pattern (CLI > ENV > config.yaml)
- codebase-summary: add new remote proxy files, update test counts (638)
- project-overview-pdr: add FR-008 requirement, v7.1 release section
- project-roadmap: add Phase 10 (Remote CLIProxy), mark #142 complete
- system-architecture: add Remote CLIProxy Flow diagram
2025-12-21 20:09:46 -05:00
kaitranntt 676929fc87 docs(readme): add OpenRouter to built-in providers
- add OpenRouter row to providers table

- add OpenRouter integration section with v7.0.0 features

- add screenshot for OpenRouter API profiles
2025-12-21 01:01:16 -05:00
kaitranntt a9d21c21f2 perf(assets): convert screenshots to WebP, add new feature images
- Convert PNG to WebP (85% smaller: ~1.5MB → ~250KB each)
- Add new screenshots: analytics, live-auth-monitor, cliproxyapi, copilot-api, websearch
- Remove old PNG screenshots (analytics-light, api_profiles, cliproxy)
- Update README image references to use .webp format
2025-12-19 20:31:21 -05:00
kaitranntt 0dc2da6e5a docs(readme): update providers, websearch, and add star history
- Add Copilot to built-in providers table with OAuth auth
- Add "Powered by" section crediting CLIProxyAPI and copilot-api
- Update WebSearch from MCP to CLI tool fallback chain (Gemini/OpenCode/Grok)
- Add centered Star History section before footer
- Remove redundant Project Structure (codebase-summary.md is source of truth)
2025-12-19 20:18:21 -05:00
kaitranntt 8d8d4c248a refactor: rename proxy to cliproxy_server and update API routes 2025-12-19 02:14:49 -05:00
kaitranntt 196422cee1 docs(cliproxy): add remote proxy documentation
- add proxy CLI flags section to help command output

- add proxy environment variables section to help

- add Remote Proxy section to README with config examples

- document CLI flag overrides and priority resolution
2025-12-19 01:18:05 -05:00
kaitranntt 071ec041ed feat(websearch): add multi-tier MCP fallback for third-party profiles
Implements CCS WebSearch Native Infrastructure (Phases 1-3):

Phase 1 - Multi-tier MCP Fallback:
- Add mcp-manager.ts with ensureMcpWebSearch() for auto-configuration
- Support web-search-prime (primary), Brave Search, and Tavily MCPs
- Case-insensitive detection of existing web search MCPs
- Block-websearch hook for optional native WebSearch blocking

Phase 2 - User Configuration:
- Add WebSearchConfig interface to unified-config-types.ts
- Add getWebSearchConfig() to unified-config-loader.ts
- Support configurable webSearchPrimeUrl for security
- Add GET/PUT /api/websearch endpoints in routes.ts
- Add WebSearch settings UI in settings.tsx dashboard

Phase 3 - Documentation & Testing:
- Add WebSearch section to README.md
- Create comprehensive docs/websearch.md guide
- Add 23 unit tests for MCP manager logic

Enables web search for gemini, codex, agy, qwen, glm, kimi profiles
that cannot access Anthropic's native WebSearch API.
2025-12-16 00:42:13 -05:00
kaitranntt 945920832f Merge origin/dev into kai/feat/improve-config-home
Resolves conflicts:
- Accept dev branch structure (docs moved to external submodule)
- Keep README with extensibility messaging updates:
  - Universal profile manager tagline
  - Built-in Providers section (renamed from Supported Providers)
  - API Profiles pillar emphasizes Anthropic-compatible APIs
  - Added tip about custom provider support
2025-12-13 02:54:23 -05:00
kaitranntt 703d1aa2e3 docs: emphasize CCS extensibility and universal API support
- Update tagline: "universal AI profile manager for Claude Code"
- Add "Custom API Profiles" section for bring-your-own APIs
- Clarify built-in OAuth providers are not the only option
- Add note about Anthropic-compatible API extensibility
- Update Architecture section to highlight extensibility
- Add "Unlimited Profiles" to What CCS Gives You
- Update Japanese and Vietnamese READMEs with same messaging
2025-12-13 02:48:48 -05:00
kaitranntt f520b8919d docs: add assets folder with images for README 2025-12-13 01:56:25 -05:00
kaitranntt 0a8a22347c docs: use Mintlify-hosted URLs for README images 2025-12-13 01:55:01 -05:00
kaitranntt 8d46317cf6 docs: migrate to Mintlify docs submodule
- Add kaitranntt/ccs-docs as git submodule under docs/
- Update README links to point to docs.ccs.kaitran.ca
- Remove old local docs (migrated to Mintlify MDX format)

Phase 3 of README restructure complete.
2025-12-13 00:49:21 -05:00
kaitranntt 25741ac515 docs(readme): restructure with 3-pillars format and add screenshots
- reduce main README from ~1070 to ~250 lines

- add dashboard screenshots (analytics, api_profiles, cliproxy)

- update Vietnamese and Japanese translations to match new structure

- add light/dark theme analytics screenshots
2025-12-12 22:39:58 -05:00
kaitranntt 53259ce1c7 docs: update project documentation with recent features 2025-12-12 05:49:48 -05:00
kaitranntt 41f4e56865 docs: add codex provider examples to auth section
- Add examples for codex provider authentication
- Clarify that gemini, codex, and agy are different providers
- Show account listing and switching examples for each provider
2025-12-10 23:56:08 -05:00
kaitranntt 8f6684f948 feat(cliproxy): add --use and --accounts flags for multi-account switching
- Add findAccountByQuery() to search accounts by nickname/email/id
- Add --accounts flag to list all accounts for a provider
- Add --use <name> flag to switch between accounts
- Filter CCS-specific flags from Claude CLI args
- Update help documentation with new multi-account commands
2025-12-09 17:28:41 -05:00
kaitranntt 8aae0db7da feat(ui): redesign health dashboard to match ccs doctor output
- Rewrite health-service.ts with 20+ comprehensive checks in 5 groups
  (System, Configuration, Profiles & Delegation, System Health, CLIProxy)
- Add async support for port checking functionality
- Create new health-check-item.tsx component with collapsible design
- Redesign health.tsx with professional grouped layout, hero section,
  summary stats, and issues panel with actionable fix commands
- Update use-health.ts with HealthGroup type support
- Add development server documentation to CLAUDE.md
2025-12-08 15:00:07 -05:00
kaitranntt 481570f7b2 docs: update documentation to reflect v2.0 architecture
- Fix README.md dashboard command (ccs config) and port info
- Update all documentation to reflect React 19 dashboard
- Document new tooling: Bun, Vite, semantic release
- Add TypeScript strict mode and type coverage details
- Update architecture with WebSocket and modern stack
- Revise project roadmap with current implementation status
2025-12-07 17:41:18 -05:00
kaitranntt 6427ecf5af feat(cliproxy): add crud commands for variant profiles
- Add `ccs cliproxy create/list/remove` commands for variant management
- Interactive wizard with provider/model selection from catalog
- Settings file auto-generated with all 6 ANTHROPIC_* env fields
- Fix `ccs api create` to include all 4 model fields (was missing 3)
- Fix `--config` flag to save to correct variant settings file
- Remove paid tier badge from AGY models (all free via Antigravity)
- Add settings file format example to README for CLIProxy variants
- Add 22 unit tests for cliproxy command validation and config handling
2025-12-05 21:44:41 -05:00
semantic-release-botandkaitranntt bd46c8de12 fix(tests): migrate test suite from mocha to bun test runner
- Replace before()/after() with beforeAll()/afterAll()
- Remove this.timeout() calls (unsupported by bun)
- Update package.json scripts to use bun test
- Fix error message regex for cross-runtime compatibility
- Skip integration tests requiring network/child process mocking
- Format source files with prettier
2025-12-03 21:43:29 -05:00
kaitranntt ce9d60d0ca feat(cliproxy): add user-defined CLIProxy variants
Allow users to create custom profile names that route through CLIProxy
providers with different model configurations.

Config example:
{
  "cliproxy": {
    "flash": { "provider": "gemini", "settings": "~/.ccs/gemini-flash.settings.json" },
    "pro": { "provider": "gemini", "settings": "~/.ccs/gemini-pro.settings.json" }
  }
}

Usage: ccs flash "quick task" or ccs pro "complex analysis"

Changes:
- Add CLIProxyVariantConfig types to src/types/config.ts
- Update profile-detector to check config.cliproxy section (Priority 1)
- Pass customSettingsPath through executor chain
- Update getEffectiveEnvVars to support custom settings path
- Document feature in README.md and CLAUDE.md
- Bump version to 5.0.2
2025-11-30 04:02:43 -05:00
kaitranntt 3c4578d423 docs: add CLIProxy profile type to Architecture section
- Add profile priority order (CLIProxy → settings → account → default)
- Document CLIProxy profile with OAuth auth, port 8317, binary location
- Include model mappings for gemini, codex, agy providers
- Add cliproxy/auth/ to profile-specific data
- Link to CLIProxyAPI GitHub repo
2025-11-28 21:19:56 -05:00
kaitranntt 6ce590e0cf docs(readme): add Zero-Config OAuth Providers section
- Add OAuth section with gemini, codex, agy providers
- Include provider table with accurate model mappings
- Add authentication commands (--auth, --headless, --logout)
- Add OAuth vs API key comparison table
- Add troubleshooting section for timeout, port, binary issues
- Credit CLIProxyAPI as underlying technology
2025-11-28 21:16:55 -05:00
kaitranntt 296d5661d0 docs: mark native shell installers as deprecated across all documentation
Phase 02 of "Deprecate Native Installers" plan:

Documentation updates (10 files, 3 languages):
- README.md: Mark curl/irm installers as deprecated in collapsed section
- docs/en/installation.md: Add deprecation warnings, emphasize npm as primary
- docs/en/troubleshooting.md: Add FAQ for deprecation warning users see
- docs/en/usage.md: Update uninstall to show npm first, legacy second
- docs/version-management.md: Strikethrough deprecated release checklist items
- docs/ja/README.md: Japanese deprecation notice
- docs/vi/README.md: Vietnamese deprecation notice
- docs/vi/installation.vi.md: Vietnamese installation deprecation
- docs/vi/troubleshooting.vi.md: Vietnamese troubleshooting deprecation
- src/commands/help-command.ts: npm as recommended uninstall method

Code quality:
- Fixed emoji violations: replaced ⚠️ with [!] per CLAUDE.md ASCII-only rule
- Consistent messaging across EN/JA/VI translations
- Updated codebase-summary.md with Phase 02 achievements

All documentation now consistently recommends:
  npm install -g @kaitranntt/ccs

Legacy installers (curl/irm) show deprecation warning and auto-redirect
to npm installation when Node.js is available.
2025-11-28 02:39:48 -05:00
kaitranntt 739895a29e feat(config): introduce shared settings.json across profiles 2025-11-23 20:31:39 -05:00
kaitranntt c4e5bcc40b docs: reorganize translated README files into docs/ folder structure 2025-11-22 21:48:18 -05:00
kaitranntt ebb33b7843 feat(installer): add deprecated agent cleanup logic 2025-11-22 13:24:13 -05:00