CC Switch

This is a community package of CC Switch, maintained independently.

CC Switch is a cross-platform desktop app for managing and switching provider configurations for Claude Code, Codex, and Gemini CLI.

• Manage multiple provider configurations and endpoints
• One-click switch and sync to client live configurations
• MCP servers and Prompt/Skills management

By default this package can access only its own data (~/.cc-switch) — your home stays private. Grant access for the tools you actually use, otherwise changes cc-switch makes for them are silently discarded by the sandbox:

• Claude Code: flatpak override --user --filesystem=home com.ccswitch.desktop. Claude keeps ~/.claude.json directly in the home root, and exposing a single file to the sandbox breaks cc-switch's atomic config writes (EBUSY on rename), so the parent directory — your home — must be granted instead.
• Codex: flatpak override --user --filesystem=~/.codex:create com.ccswitch.desktop
• Gemini CLI: flatpak override --user --filesystem=~/.gemini:create com.ccswitch.desktop
• OpenCode: flatpak override --user --filesystem=~/.config/opencode:create com.ccswitch.desktop
• OpenClaw: flatpak override --user --filesystem=~/.openclaw:create com.ccswitch.desktop

General rule for any other tool (or a custom config directory): if the tool's config lives in a directory, grant that directory; if it is a bare file, grant the file's parent directory, never the file itself — and when that file sits in the home root, the parent is home.

Warning: even after granting home, do not remove the default ~/.cc-switch permission (for example by toggling it off in Flatseal). Removing a directory permission records an explicit deny, and the sandbox masks a denied directory with an empty one that overrides the home grant — cc-switch would then lose its own settings on every restart.