id = "claude-code-router"
name = "Claude Code Router"
homepage = "https://musistudio.github.io/claude-code-router/"
description = "Tool to route Claude Code requests to different models and customize any request"
executables = ["ccr"]

[dotfiles]

# The project's official configuration guide documents the current SQLite
# database at ~/.claude-code-router/config.sqlite on macOS/Linux and
# %APPDATA%/claude-code-router/config.sqlite on Windows. Legacy config.json is
# retained as a migration source when no SQLite database exists.
# https://github.com/musistudio/claude-code-router/blob/main/docs/src/content/docs/en/configuration/configuration-file.md
paths = ["~/.claude-code-router/"]

secret = [
  "~/.claude-code-router/config.sqlite",
  "~/.claude-code-router/config.json",
]

[commands]
format = 1
label = "Start CCR service"
description = "Start the CCR management service and model gateway in the background. Profile launching and other service modes are not covered."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = false, short_bundles = false }

[[commands.subcommand]]
path = ["start"]
label = "Start in background"

[[commands.subcommand.source]]
id = "docs"
kind = "manual"
url = "https://ccrdesk.top/en/guides/cli/"
revision = "2026-10-27"
evidence = """
ccr start [--host <host>] [--port <port>] [--open|--no-open] [--gateway|--no-gateway]
--host <host> Management service listen address, default 127.0.0.1. --host=value is also accepted.
--port <port> Preferred management service port, default 3458.
"""

[[commands.subcommand.field]]
id = "host"
label = "Listen address"
type = "string"
option = ["--host"]
sources = ["docs"]

[[commands.subcommand.field]]
id = "port"
label = "Port"
type = "integer"
option = ["--port"]
sources = ["docs"]

[[commands.subcommand.task]]
id = "start"
label = "Start service"
fields = ["host", "port"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["host", "port"]