otty / apps

All apps/CC Switch CLI

CC Switch CLI

cc-switch-cli

Runs as cc-switch|macOS, Linux, Windows|github.com

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

CC Switch CLI in your home directory Every rule on this page, by file

· settings.json Sync

· cc-switch.db Never synced

· config.json Never synced

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/cc-switch-cli/otty.tomlThe file this page is generated from

id = "cc-switch-cli"

name = "CC Switch CLI"

homepage = "https://github.com/SaladDay/cc-switch-cli"

executables = ["cc-switch"]

[dotfiles]

# The project's official README documents ~/.cc-switch as its config root,

# with settings.json as settings and cc-switch.db/config.json as the database

# and legacy provider store. Those stores can contain provider credentials and

# are therefore secret files rather than syncable plaintext.

# https://github.com/SaladDay/cc-switch-cli/blob/main/README.md

paths = ["~/.cc-switch/settings.json"]

secret = ["~/.cc-switch/cc-switch.db", "~/.cc-switch/config.json"]

[commands]

format = 1

label = "Launch with a provider"

description = "Start Claude or Codex with a chosen provider in this terminal only, without switching the global provider. Other subcommands (provider, auth, sessions, mcp, proxy) are left out; run cc-switch alone for the full-screen interface."

quality = "ai-draft"

parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.subcommand]]

path = ["start"]

label = "Start an agent with a provider"

[[commands.subcommand.source]]

id = "readme"

kind = "manual"

url = "https://github.com/SaladDay/cc-switch-cli"

revision = "5.11.3"

evidence = """

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

"""

[[commands.subcommand.field]]

id = "agent"

label = "Agent"

type = "enum"

position = 0

choices = [{ value = "claude", label = "Claude" }, { value = "codex", label = "Codex" }]

sources = ["readme"]

[[commands.subcommand.field]]

id = "provider"

label = "Provider id"

type = "string"

position = 1

sources = ["readme"]

[[commands.subcommand.field]]

id = "dry_run"

label = "Preview only"

type = "boolean"

option = ["--dry-run"]

sources = ["readme"]

[[commands.subcommand.field]]

id = "shared_sessions"

label = "Share Codex sessions"

description = "macOS/Linux, Codex only."

type = "boolean"

option = ["--shared-sessions"]

sources = ["readme"]

[[commands.subcommand.task]]

id = "start"

label = "Start with a provider"

fields = ["agent", "provider", "dry_run"]

required = ["agent", "provider"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["agent", "provider", "dry_run", "shared_sessions"]

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/cc-switch-cli. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these keeps all credential files out.