Skip to main content

​
Installation

Native shell installers (curl/irm) are deprecated. Use npm installation for all platforms. Legacy installers will be removed in v5.0.

​
Cross-Platform Installation

npm install -g @kaitranntt/ccs

​
Benefits

  • ✅ Cross-platform compatibility
  • ✅ Automatic PATH configuration
  • ✅ Auto-creates config files via postinstall script
  • ✅ Easy updates: npm update -g @kaitranntt/ccs
  • ✅ Clean uninstall: npm uninstall -g @kaitranntt/ccs
  • ✅ Version pinning support
  1. npm downloads and installs the package
  2. Postinstall script creates ~/.ccs/config.json and ~/.ccs/glm.settings.json
  3. npm creates ccs command in your PATH
If you use npm install --ignore-scripts, config files won’t be created. Run without that flag or use npm install -g @kaitranntt/ccs --force.

​
What Gets Installed

Configuration Directory (~/.ccs/): 
~/.ccs/
├── config.json             # Profile configuration
├── glm.settings.json       # GLM profile
├── instances/              # Account-based profile instances
├── cliproxy/               # OAuth provider auth tokens
└── shared/                 # Shared commands/skills/agents

​
Requirements

macOS / Linux

Windows

  • PowerShell 5.1+ (pre-installed on Windows 10+)
  • Node.js 14+
  • Claude CLI

​
Upgrading

# npm (recommended)
npm update -g @kaitranntt/ccs

# Or force reinstall
ccs update --force

​
Uninstalling

npm uninstall -g @kaitranntt/ccs
This removes the CCS command but preserves your ~/.ccs/ configuration directory.