Create

Sign in to ReadmeX

or

How we handle your data: Privacy Policy

ReadmeX

Your AI reading companion

What would you like to catch up on?

Pick a briefing, or ask your own question.

Your community and people briefings stay personal to you.

cc-switch-cli

cc-switch-cli: Manage Claude Code, Codex, Gemini, OpenCode, Hermes, OpenClaw, and Pi from one interactive TUI or scriptable CLI.

What problem it solves

Developers using multiple AI command-line tools need a consistent way to manage providers, accounts, prompts, MCP servers, sessions, and configuration. Switching configurations manually across applications can also make it difficult to inspect usage, preserve settings, or use different providers in separate terminal sessions.

Key features

  • Provider management — Manage API configurations for seven supported AI command-line applications from the TUI or CLI. Provider profiles can be switched, edited, duplicated, exported, tested, and used for remote model discovery.

    Source: README

  • Unified MCP and prompt management — Manage Model Context Protocol servers across Claude, Codex, Gemini, OpenCode, and Hermes, including synchronization with live configuration files. System prompt presets are also available across the supported applications.

    Source: README

  • Managed OAuth accounts — Manage ChatGPT and Codex OAuth accounts locally and reuse them across provider profiles. The account workflow supports login, listing, default selection, removal, reauthentication, and provider binding without copying long-lived tokens into every provider.

    Source: README

  • Session and usage history — Review saved assistant sessions across supported applications, inspect messages and token or cost details, and resume sessions with a generated command. Local session logs can also be imported into usage statistics.

    Source: README

  • Configuration, proxy, and session launch controls — Back up, import, export, validate, and synchronize configuration, including through WebDAV. Per-application proxy routes can be inspected and controlled, while targeted launches allow a Claude or Codex session to use a provider without changing the global provider.

    Source: README

Quick start

Copied verbatim from the project's README.

curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash
cc-switch
cc-switch provider list              # List providers
cc-switch provider switch <id>       # Switch provider
cc-switch use <id>                   # Switch provider (shortcut)
cc-switch provider export <id>       # Export a Claude provider to a standalone settings file
cc-switch provider stream-check <id> # Check provider stream health
cc-switch start claude <id>          # Launch Claude with this provider without switching globally
cc-switch start codex <id>           # Launch Codex with this provider without switching globally
cc-switch start codex <id> --shared-sessions # Share persistent Codex history across providers
cc-switch start claude <id> --dry-run # Preview the launch without starting Claude
cc-switch auth list                  # List managed ChatGPT/Codex OAuth accounts
cc-switch sessions list --all        # Review saved assistant sessions
cc-switch sessions sync-usage --all  # Import local session token/cost usage
cc-switch config webdav show         # Inspect WebDAV sync settings
cc-switch env tools                  # Check local CLI tools
cc-switch mcp sync                   # Sync MCP servers
cc-switch proxy show                 # Inspect proxy routes and status

# Use the global `--app` flag to target specific applications:
cc-switch --app claude provider list    # Manage Claude providers
cc-switch --app codex mcp sync          # Sync Codex MCP servers
cc-switch --app gemini prompts list     # List Gemini prompts
cc-switch --app hermes provider list    # Manage Hermes providers
cc-switch --app openclaw provider list  # Manage OpenClaw providers
cc-switch --app pi provider list        # Manage Pi providers

# Supported apps: `claude` (default), `codex`, `gemini`, `opencode`, `hermes`, `openclaw`, `pi`

Who it may suit

Inference: This may suit developers who use multiple AI coding assistants and want centralized provider, account, prompt, MCP, session, and configuration workflows. It may also suit terminal-focused users who prefer scripting or an interactive TUI over application-specific configuration files.

Topics to discuss

  • Which provider and account workflows should be prioritized in future CLI releases?

  • How should cross-app synchronization handle conflicting configuration changes?

  • Which additional AI command-line applications should receive first-class support?


Written by ReadmeX AI from the project's README, source and public GitHub data; it may contain mistakes.

Read the original README https://github.com/SaladDay/cc-switch-cli#readme

ReadmeX opened this community for a trending project; it is not run by the project. Maintainers can claim it from the community page.

github.comhttps://github.com/SaladDay/cc-switch-cli

Comments

…