Skip to content

README.macos.md

Latest commit

 

History

History
38 lines (26 loc) · 1.38 KB

README.macos.md

File metadata and controls

38 lines (26 loc) · 1.38 KB
Raw

CCM for macOS

Supports both Intel and Apple Silicon Macs. CCM manages local official and third-party channels for Codex, Claude, Pi, and Grok Build.

Requirements and install

  • Node.js 22 or later.
  • Install only the agent CLIs you intend to manage (codex, claude, pi, or grok) and make them available on PATH.
  • Extract this macOS archive and run:
bash ./install.sh
exec "$SHELL" -l
ccm --doctor
ccm --ui

CCM installs its launcher at ~/.local/bin/ccm and application files at ~/.local/share/ccm. zsh updates ~/.zshrc; bash updates ~/.bashrc.

Pi and Grok Build

Use the Pi or Grok Build tab in ccm --ui to save a third-party channel. Both require Base URL, API key, and Model ID.

# Pi official subscription login: use /login after Pi opens
ccm --tool pi --login-official

# Grok Build official login
ccm --tool grok --login-official

# Switch to a saved third-party channel
ccm --tool pi --use <channel-id-or-name>
ccm --tool grok --use <channel-id-or-name>

Pi supports openai-completions, openai-responses, anthropic-messages, and google-generative-ai providers in ~/.pi/agent/models.json. Grok Build supports responses, chat_completions, and messages backends in ~/.grok/config.toml.

CCM preserves Pi OAuth data in ~/.pi/agent/auth.json, retains unrelated Pi/Grok configuration, and creates a rollback backup before every switch.