Skip to content

README.windows.md

Latest commit

 

History

History
47 lines (32 loc) · 2.01 KB

README.windows.md

File metadata and controls

47 lines (32 loc) · 2.01 KB
Raw

CCM for Windows

CCM manages official and third-party channels for Codex, Claude, Pi, and Grok Build. It runs locally; channel registries and rollback backups remain under %LOCALAPPDATA%\ccm.

Requirements

  • Windows 10/11 and Node.js 22 or later.
  • Install only the CLI(s) you plan to use and make each available on PATH: codex, claude, pi, or grok.
  • Codex can be installed with:
irm https://chatgpt.com/codex/install.ps1 | iex

Install

Extract this Windows archive and double-click Install-CCM.cmd. Open a new PowerShell window, then run:

ccm --doctor
ccm --ui

The installer places the app in %LOCALAPPDATA%\Programs\CCM and adds the ccm launcher.

Pi

  • Official: run ccm --tool pi --login-official. Pi starts in the terminal; enter /login and choose the official subscription provider. CCM does not overwrite %USERPROFILE%\.pi\agent\auth.json.
  • Third party: in ccm --ui, select Pi, add a channel with Base URL, API key, required Model ID, and protocol: openai-completions, openai-responses, anthropic-messages, or google-generative-ai.
  • CCM writes only its managed provider into %USERPROFILE%\.pi\agent\models.json, selects it in settings.json, and backs up both files before each switch.

Grok Build

  • Official: run ccm --tool grok --login-official; CCM first selects the built-in grok-build model, then runs grok login.
  • Third party: select Grok Build in ccm --ui, then enter Base URL, API key, required Model ID, and backend: responses, chat_completions, or messages.
  • CCM adds a managed [model."ccm-..."] entry to %USERPROFILE%\.grok\config.toml and preserves unrelated Grok model entries.

Command line

ccm --tool pi --list
ccm --tool pi --use <channel-id-or-name>
ccm --tool grok --list
ccm --tool grok --use <channel-id-or-name>

Pi configuration follows the Pi provider documentation. Grok model entries follow the Grok Build settings reference.