CC Switch is a free, open-source Mac utility that lets you save, switch, and restore configuration profiles for AI coding agents — eliminating the manual friction of reconfiguring tools like Claude Code every time you change context.
What is CC Switch?
CC Switch is a configuration profile manager purpose-built for AI coding agents on macOS. Instead of editing config files by hand each time you jump between projects, clients, or personas, CC Switch stores named snapshots of your agent settings and lets you flip between them instantly.
If you run Claude Code against multiple codebases — say, a TypeScript monorepo for one client and a Python FastAPI service for another — you already know the pain: different allowed tools, different memory files, different permission sets, different API key scopes. CC Switch turns that shuffle into a single command.
What does CC Switch do best?
Its strongest suit is frictionless context-switching: save the exact configuration state you have right now, give it a name, and reload it later with no manual editing.
- Named profiles — snapshot any configuration state under a human-readable label (e.g., client-alpha, personal-oss, readonly-audit).
- Instant restore — switch the active profile in one step; your agent picks up the right settings on its next invocation.
- Zero runtime overhead — CC Switch operates purely on config files; it adds nothing to your agent's execution path.
- Open source — the full source lives on GitHub, so you can inspect exactly what it reads and writes before trusting it with your environment.
I have been using it to separate a permissive personal profile (broad tool access, verbose memory) from a tight client-facing profile (scoped permissions, no cross-project context leakage). What used to be a three-minute manual diff is now one line.
Is CC Switch free?
Yes — CC Switch is completely free to download and use, with no paid tier, no subscription, and no telemetry. It is distributed as an open-source project on GitHub under a permissive licence, which means you can fork, audit, or adapt it to your workflow without restriction.
Who should use CC Switch?
CC Switch is aimed squarely at power users who run AI coding agents — particularly Claude Code — across more than one distinct context. If you only ever work in a single project with a single set of permissions, the built-in config files are probably sufficient and you do not need another layer of tooling.
But if any of the following sounds familiar, CC Switch earns its place in your menu bar:
- You bill multiple clients and need clean separation between their codebases and your agent's memory.
- You maintain both permissive dev profiles and locked-down read-only audit profiles for security reviews.
- You pair with teammates who each need a personal agent persona on a shared machine.
- You frequently experiment with new agent settings and want a safe rollback point before you start.
Developers working inside large monorepos — where one team's settings would be noise for another — will also find it particularly useful.
What are the best CC Switch alternatives?
There is no exact equivalent in the Mac utility space because CC Switch fills a niche that only emerged with the rise of AI coding agents. The closest analogies are general-purpose profile managers like Mackup (which backs up and restores app settings via symlinks) or shell-function approaches using direnv to load environment variables per directory. Both work, but neither gives you named, switchable snapshots that are explicitly scoped to agent configuration semantics.
For environment variables specifically, EnvPane or manual .env files with a shell alias can approximate part of what CC Switch does, but you lose the named-profile concept and the restore workflow becomes a manual operation again. CC Switch wins on intentionality: it was designed for exactly this job.
How does CC Switch compare to managing configs manually?
Manual config management means remembering which fields to change, editing JSON or TOML by hand, and hoping you did not introduce a typo that silently breaks your agent session. CC Switch replaces all of that with a save/load model familiar from any IDE workspace switcher.
The key advantage is consistency: because CC Switch serialises and deserialises the same fields every time, a profile you saved three weeks ago restores faithfully. Manual edits drift. Beyond correctness, the speed difference is real — profile switching that took several minutes of careful editing now takes seconds, which means I actually do it rather than lazily running the wrong profile for the task at hand.
