mirror of
https://github.com/tiennm99/ccs.git
synced 2026-07-15 22:21:20 +00:00
7dba36fb03d56da03e0abff152d7a582eb4f10fa
11
Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
 Kai (Tam Nhu) TranandTam Nhu Tran
|
4f2dd70b8c | fix: avoid relative completion backend execution | ||
|
Tam Nhu Tran
|
24ba2abe10 |
feat(cli): refresh help and shell completion UX
- add a shared command catalog for root help and completion routing - replace shell-local completion logic with a hidden __complete backend - add topic help and parity tests for router, help, and completion coverage |
||
|
Tam Nhu Tran
|
a98f4a5427 |
fix(env): sync CLIProxy profiles across all shell completions and improve error messages
- Add profile name completions to fish env subcommand - Add iflow, kiro, ghcp, claude to zsh proxy_profiles and PS1 cliproxyProfiles - Distinguish non-API profile type error from "profile not found" |
||
|
Tam Nhu Tran
|
3f5ecd4d69 |
fix(env): address P1-P3 review items from code review
- P1: Fix bash completion $cliproxy_profiles scoping — inline profiles in env block since variable is only defined at COMP_CWORD=1 scope - P2: Detect account-based profiles and show specific error message instead of generic "not found" - P2: Show `ccs migrate` hint when unified mode is disabled and settings profile resolution fails - P2: transformToOpenAI omits empty entries at transform time instead of relying on output filter (removes fragile coupling) - P3: Add zsh and auto to --shell completions across all 4 shells; map --shell zsh to bash in command handler since syntax is identical - P3: Auto-detect PowerShell from SHELL containing pwsh on non-Windows - Tests: 33 pass (+1 pwsh detection test, updated transform assertions) |
||
|
Tam Nhu Tran
|
76457a567d |
fix(env): add key sanitization and shell completions
- Validate env var keys match ^[A-Za-z_][A-Za-z0-9_]*$ before output to prevent injection via crafted config files - Add env command to all 4 shell completion scripts (bash, zsh, fish, PowerShell) with sub-completions for --format and --shell flags |
||
|
kaitranntt
|
59a2f2b717 |
feat(completions): enhance cliproxy help and update shell completion scripts
- Styled cliproxy help output with UI primitives and added status hint - Added cliproxy --help reference to main help command - Updated bash, zsh, fish, and PowerShell completions with: - Missing commands (api, cliproxy) - CLIProxy OAuth profiles (gemini, codex, agy, qwen) - Provider flags and update command flags |
||
|
|
7ec8cc8369 |
feat(profile,shell-completion,prompt): add profile commands and improve input handling (#34)
* fix(cliproxy): use double-dash flags for cliproxyapi auth (#24) CLIProxyAPI updated from single-dash to double-dash CLI flags. Changed -login to --login, -codex-login to --codex-login, -antigravity-login to --antigravity-login, -config to --config, and -no-browser to --no-browser. * chore(release): 5.1.1-beta.1 [skip ci] ## [5.1.1-beta.1](https://github.com/kaitranntt/ccs/compare/v5.1.0...v5.1.1-beta.1) (2025-12-01) ### Bug Fixes * **cliproxy:** use double-dash flags for cliproxyapi auth ([#24](https://github.com/kaitranntt/ccs/issues/24)) ([ |
||
|
Kai (Tam Nhu) Tranandkaitranntt
|
d34dbcac1f |
feat: add 'ccs update' command with smart update notifications
Add comprehensive update functionality with intelligent notification system. Supports manual update checking, automatic notifications every 24h, and works across npm and direct installations with proper error handling. Closes #12 |
||
|
Kai (Tam Nhu) Tranandkaitranntt
|
fe4ff882b0 |
feat(cli): enhance version and help display formatting (#11)
* feat: add -sc short flag for --shell-completion Add -sc as a short flag alias for --shell-completion, matching the pattern of -h for --help and -v for --version. Changes: - bin/ccs.js: Add -sc support in help text and flag detection - lib/ccs: Add -sc support in help text and flag detection - lib/ccs.ps1: Add -sc support in help text and flag detection * chore: bump version to 4.1.4 * chore: bump version to 4.1.5 * feat: emphasize concurrent account usage in auth help text Update all auth-related help messages to emphasize the ability to run multiple Claude accounts concurrently. Changes: - bin/ccs.js: "Run multiple Claude accounts concurrently" - bin/auth/auth-commands.js: "CCS Concurrent Account Management" - lib/ccs: Updated both main help and auth_help function - lib/ccs.ps1: Updated both main help and Show-AuthHelp function * feat: implement ccs update command across all platforms Add cross-platform ccs update command to sync delegation commands and skills from ~/.ccs/.claude/ to ~/.claude/. Replaces vague "CCS items" wording with specific "delegation commands and skills". Changes: - bin/ccs.js: Add update command handler and update help text - bin/utils/claude-symlink-manager.js: Update user-facing messages - lib/ccs: Implement update_run() function with symlink logic - lib/ccs.ps1: Implement Update-Run function with Junction/SymbolicLink support Features: - Automatically backs up existing files before symlinking - Skips items that are already correctly symlinked - Reports installed vs up-to-date counts - Handles Windows permissions gracefully (suggests Admin/Developer Mode) Cross-platform parity: bash, PowerShell, and Node.js now all support ccs update * refactor: rename ccs update to ccs sync for clarity Rename the update command to sync across all platforms to avoid confusion with updating the CCS tool itself. The sync command clearly communicates syncing delegation features from the CCS package to ~/.claude/. Changes: - bin/ccs.js: Rename handleUpdateCommand → handleSyncCommand - bin/utils/claude-symlink-manager.js: Rename update() → sync() - lib/ccs: Rename update_run() → sync_run() - lib/ccs.ps1: Rename Update-Run → Sync-Run - All: Update help text "update" → "sync" - All: Update messages "Updating" → "Syncing" Command usage: ccs sync or ccs --sync * fix: update GitHub documentation links to stable permalink Update broken #usage anchor links to stable /blob/main/README.md permalink format. This matches the format already used in PowerShell version and ensures links always work. Changes: - bin/ccs.js: Update link from #usage to /blob/main/README.md - lib/ccs: Update link from #usage to /blob/main/README.md - Now consistent with lib/ccs.ps1 which already used this format Old: https://github.com/kaitranntt/ccs#usage New: https://github.com/kaitranntt/ccs/blob/main/README.md * feat: add sync command and -sc flag to shell completions Update all shell completion scripts to include the newly added sync command and -sc short flag for --shell-completion. Changes across all completion scripts (bash, zsh, fish, PowerShell): - Add 'sync' command to completion suggestions - Add '-sc' as short flag for '--shell-completion' - Update fish to handle both -sc and --shell-completion for subflags - Update PowerShell to recognize -sc for shell completion flags - Add sync command description: "Sync delegation commands and skills" This ensures tab completion discovers the sync command and users can use both -sc and --shell-completion interchangeably. * fix: standardize help text across all implementations Fix inconsistencies in help text that appeared after merge from main. Ensures all three implementations (bash, PowerShell, Node.js) display identical help messages. Changes: - lib/ccs: Update "Delegation (Token Optimization)" → "Delegation (inside Claude Code CLI)" - lib/ccs: Remove redundant /ccs:create line, simplify description - lib/ccs.ps1: Add missing Delegation section - All: Now use consistent messaging about delegation features This ensures users see the same information regardless of which platform they're using (Linux/macOS bash, Windows PowerShell, or npm). * fix: update description text to emphasize concurrent sessions Update outdated description in lib/ccs and lib/ccs.ps1 to match the improved wording already in bin/ccs.js. The new description better emphasizes running concurrent Claude CLI sessions. Changes: - lib/ccs: Update description to emphasize "Run different Claude CLI sessions concurrently" - lib/ccs.ps1: Update description to match bash and Node.js versions - Remove "(work, personal, team)" examples to keep description cleaner - Emphasize "Run different Claude CLI sessions concurrently" over vague "Concurrent sessions" Old: "Switch between multiple Claude accounts (work, personal, team) and alternative models (GLM, Kimi) instantly. Concurrent sessions with auto-recovery. Zero downtime." New: "Switch between multiple Claude accounts and alternative models (GLM, Kimi) instantly. Run different Claude CLI sessions concurrently with auto-recovery. Zero downtime." All three implementations now show identical, clearer description text. * feat(cli): enhance version display formatting and delegation status --------- |
||
|
Kai (Tam Nhu) Tranandkaitranntt
|
2671b97039 |
fix(completion): improve shell completion UI/UX and fix mkdir errors (#10)
* fix(shell-completion): resolve ENOTDIR error when parent path is a file
Fixes issue where `--shell-completion` fails with ENOTDIR error when
a file exists where a directory should be created (e.g., ~/.zsh exists
as a file instead of a directory).
Changes:
- Added ensureDirectory() helper that safely creates directories
- Validates parent paths are directories, not files
- Provides clear error message when file conflicts occur
- Applied to all shell installers (bash, zsh, fish, powershell)
- Maintains idempotent behavior (safe to call multiple times)
Before: mkdir with recursive:true fails silently with ENOTDIR
After: Clear error message guides user to resolve file conflict
* chore: bump version to 4.1.4
* feat(completion): improve UI/UX with descriptions and grouping
Improves shell completion UI/UX across all shells (bash, zsh, fish,
PowerShell) with better organization and clearer descriptions.
Changes:
- Zsh: Added descriptions for all profiles and grouped by category
- Commands: "auth", "doctor" with descriptions
- Model profiles: glm, glmt, kimi, etc. with descriptions
- Account profiles: Dynamic with "Account-based profile" label
- Used _alternative for visual grouping
- Fish: Added explicit completions with descriptions for known profiles
- Replaced generic profile listing with specific entries
- Each profile now shows clear description (e.g., "GLM-4.6 (cost-optimized)")
- Bash: Added --shell-completion flag and subflags completion
- PowerShell: Added --shell-completion flag and subflags completion
- All shells: Added completion for --shell-completion subflags
Before (zsh):
ccs
auth -- Manage multiple Claude accounts
doctor -- Run health check and diagnostics
default glm glmt kimi max
After (zsh):
commands
auth -- Manage multiple Claude accounts
doctor -- Run health check and diagnostics
model profiles
default -- Default Claude Sonnet 4.5
glm -- GLM-4.6 (cost-optimized)
glmt -- GLM-4.6 with thinking mode
kimi -- Kimi for Coding (long-context)
max -- Claude Opus (maximum capability)
account profiles
work -- Account-based profile
personal -- Account-based profile
Consistent, organized, and informative completion across all shells.
* fix(completion): handle custom profiles and fix zsh syntax errors
Fixes two issues:
1. Zsh syntax errors with _describe -t flag in _alternative
2. Adds general handling for custom settings profiles (e.g., m2)
Changes:
- Zsh: Fixed _alternative syntax (removed -t tag from _describe calls)
- Error was: "_describe:21: bad option: -M"
- Cause: Tag is auto-derived in _alternative, don't specify with -t
- Fish: Added __fish_ccs_get_custom_settings_profiles function
- Dynamically loads non-hardcoded profiles from config.json
- Shows "Settings-based profile" description for custom profiles
- Removed 'max' from hardcoded known profiles
- 'max' is user's account-based profile, not a default setting
Now supports any custom settings profile (e.g., m2.settings.json for
Minimax M2) without hardcoding. Custom profiles show with generic
"Settings-based profile" description.
Installation properly overwrites:
- fs.copyFileSync overwrites completion files by default
- RC files only modified if marker not already present
* fix(zsh): simplify completion to avoid _alternative syntax issues
Replaced _alternative with multiple _describe calls to fix persistent
zsh completion errors.
The _alternative approach was causing:
- '_describe:21: bad option: -M'
- '(eval):1: bad substitution'
- Unwanted variable expansion in completion menu
New approach uses sequential _describe calls which zsh handles correctly.
Simpler, more reliable, and still shows grouped completion with
descriptions.
Before: _alternative with complex nested _describe calls (broken)
After: Three simple _describe calls (works correctly)
* feat(zsh): add colors and improved formatting to completion
Enhances zsh completion UI/UX with colors and better spacing:
Colors:
- Blue: commands (auth, doctor)
- Green: model profiles (default, glm, glmt, kimi, custom)
- Yellow: account profiles
- Gray: descriptions
Formatting:
- Wider separator ( -- ) for better readability
- Group headers in bold cyan
- Menu selection enabled for navigation
- list-rows-first for better column layout
Before:
auth -- Manage multiple Claude accounts
default -- Default Claude Sonnet 4.5
doctor -- Run health check and diagnostics
glm -- GLM-4.6 (cost-optimized)
After:
commands (cyan header)
auth -- Manage multiple Claude accounts (blue)
doctor -- Run health check and diagnostics (blue)
model profiles (cyan header)
default -- Default Claude Sonnet 4.5 (green)
glm -- GLM-4.6 (cost-optimized) (green)
glmt -- GLM-4.6 with thinking mode (green)
kimi -- Kimi for Coding (long-context) (green)
account profiles (cyan header)
max -- Account-based profile (yellow)
Table-like appearance with colors matching --help output style.
* feat(fish): add colors to completion descriptions
Adds color-coded descriptions to Fish completion matching zsh style:
Colors:
- Blue: commands (auth, doctor)
- Green: model profiles (default, glm, glmt, kimi, custom)
- Yellow: account profiles
Fish has excellent native color support via set_color, making this
straightforward to implement.
Before:
auth Manage multiple Claude accounts
default Default Claude Sonnet 4.5
glm GLM-4.6 (cost-optimized)
max Account profile
After:
auth Manage multiple Claude accounts (blue)
default Default Claude Sonnet 4.5 (green)
glm GLM-4.6 (cost-optimized) (green)
max Account profile (yellow)
Consistent color scheme across zsh and fish shells.
* fix(zsh): correct color application for commands vs descriptions
Fixed color codes being applied backwards - commands were gray while
descriptions were colorful.
Issue:
- Used '1;34' format which zsh misinterpreted
- Commands appeared gray (unreadable)
- Descriptions appeared in color
Fix:
- Simplified color codes from '1;34' to '34' (just the color, no style prefix)
- Pattern now: =(#b)(command)(-- description)=34=90
- First group (command): color 34 (blue/green/yellow)
- Second group (description): color 90 (gray)
Before:
auth -- Manage multiple Claude accounts (gray) (blue)
After:
auth -- Manage multiple Claude accounts (blue) (gray)
Commands now properly colored, descriptions muted.
* feat(zsh): improve section header visibility with separators
Makes section headers more distinct and recognizable as dividers:
Before:
commands
auth -- ...
After:
── commands ──
auth -- ...
Changes:
- Added blank line before headers ($'\n')
- Bold yellow with decorative separators (── text ──)
- Clearly distinguishes section headers from actual commands
Now it's obvious that 'commands', 'model profiles', and 'account
profiles' are just section labels, not completable items.
* fix(zsh): use full ANSI color codes to fix reversed colors
The issue was using shorthand color codes (34, 90) instead of full
ANSI format (0;34, 2;37). Zsh was misinterpreting the shorthand,
causing colors to be applied to wrong groups.
Fixed:
- Commands: 0;34 (normal blue) - was appearing gray
- Model profiles: 0;32 (normal green) - was appearing gray
- Account profiles: 0;33 (normal yellow) - was appearing gray
- Descriptions: 2;37 (dim white) - was appearing colorful
Color codes must be escaped as 0\;34 in zsh strings.
Before fix:
auth (gray) -- description (blue)
After fix:
auth (blue) -- description (dim gray)
* fix(zsh): swap color order for completion groups
Zsh may apply colors in reverse order to capture groups on some systems.
Swapped color order: group 2 first, then group 1.
Pattern: (command)(separator + description)
Was: =blue=dim_white (applied as: blue to cmd, dim to desc)
Now: =dim_white=blue (applied as: dim to desc, blue to cmd)
Testing if this resolves the reversed color issue.
* fix(zsh): add empty leading color to fix reversed coloring
ROOT CAUSE: Zsh list-colors apply first color to WHOLE match, then
override with subsequent colors for each group. Without an empty
leading color, the whole match color leaks to groups without overrides.
Pattern behavior:
=(#b)(cmd)(desc)=BLUE=DIM
→ Whole: BLUE, Group1: DIM (override), Group2: BLUE (no override)
→ Result: cmd=dim, desc=BLUE (REVERSED!)
=(#b)(cmd)(desc)==BLUE=DIM
→ Whole: none, Group1: BLUE, Group2: DIM
→ Result: cmd=BLUE, desc=dim (CORRECT!)
The '==' at start means 'no whole-match color', preventing color bleed.
Now commands will be colorful (blue/green/yellow) and descriptions dim.
* refactor(help): remove specific account examples and generalize description
Removed deterministic account examples (work, personal, team) to make
the help text more generic and less prescriptive.
Changes:
- Removed 'ccs work' and 'ccs personal' example lines
- Removed 'Multi-account workflow' examples section
- Updated description from 'multiple Claude accounts (work, personal, team)'
to 'multiple Claude accounts and alternative models'
- Changed to 'Run different Claude CLI sessions concurrently'
- Applied consistently across Node.js (bin/ccs.js), bash (lib/ccs),
and PowerShell (lib/ccs.ps1)
This makes the help text more flexible and doesn't imply specific
use cases or account naming conventions.
* refactor(help): clarify delegation section and remove non-existent command
Updated delegation section in help text across all implementations:
Changes:
- Renamed section from 'Delegation (Token Optimization)' to
'Delegation (inside Claude Code CLI)' to clarify context
- Removed non-existent '/ccs:create m2' command
- Simplified description to focus on cost savings
- Updated command descriptions:
- '/ccs:glm' now 'for simple tasks' (clearer use case)
- '/ccs:kimi' unchanged (already clear)
- Added delegation section to PowerShell help (was missing)
- Consistent messaging across Node.js, bash, and PowerShell
The new section makes it immediately clear that delegation commands
are used within Claude Code CLI sessions, not as standalone commands.
---------
|
||
|
Kai (Tam Nhu) TranandGitHub
|
f40e9647ec |
feat(cli): comprehensive UX improvements for v3.5.0 (#7)
Implements 6-phase CLI UX improvement plan with comprehensive error handling, interactive features, and cross-platform consistency. ### Added - Shell auto-completion (bash, zsh, PowerShell, Fish) - Error codes (E101-E901) with documentation URLs - Fuzzy matching "Did you mean?" suggestions (Levenshtein distance) - Progress indicators (doctor [n/9] counter, GLMT proxy spinner) - Interactive confirmation prompts with --yes/-y automation flag - JSON output format (--json) for auth commands - Impact display (session count, paths) before destructive operations - Comprehensive test suite (15 tests, 100% pass rate) - Complete error documentation in docs/errors/ - Cross-platform `--shell-completion` command ### Changed - Error boxes: Unicode (╔═╗) → ASCII (===) for compatibility - JSON output uses CCS version instead of schema version - Help text includes EXAMPLES section across platforms - Test suite properly counts test cases (not assertions) ### Fixed - --yes flag bug (returned false instead of true) - Help text consistency (added Uninstall section to bash) - Test pass rate calculation (excludes skipped tests) - Help section comparison (locale-specific sort) ### Testing - 13/13 tests passing (2 legitimately skipped) - Cross-platform verified (Node.js, bash, PowerShell) - All error codes documented and tested |