id          = "cline"
name        = "Cline CLI"
homepage    = "https://github.com/cline/cline"
description = "Run Cline in your terminal for interactive or headless sessions."
executables      = ["cline"]

[dotfiles]
paths       = []
secret      = ["~/.cline/data/settings/providers.json"]

# Cline's official CLI reference identifies providers.json as containing API
# keys and provider configuration, so the entire file is credential material.
# https://github.com/cline/cline/blob/main/docs/cli/cli-reference.mdx

[commands]
format = 1
label = "Run Cline"
description = "Run Cline with a prompt, or open its TUI. Subcommands (auth, config, mcp ...) and secrets such as API keys are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]
id = "help"
kind = "help"
url = "https://github.com/cline/cline/blob/main/docs/cli/cli-reference.mdx"
revision = "2026-10-27"
evidence = """
Usage: cline [options] [command] [prompt]
  -p, --plan                    Run in plan mode
  --json                        Output messages as JSON instead of styled text
  --auto-approve <boolean>      Set tool auto-approval for all tools (default: true)
  -c, --cwd <path>              Working directory
  --thinking <level>            Set reasoning effort: none|low|medium|high|xhigh.
  -i, --tui                     Open the terminal user interface (TUI) for interactive sessions
  -P, --provider <id>           Provider id (default: cline)
  -m, --model <model-id>        Model to use for the session with the selected provider
  -t, --timeout <seconds>       Optional timeout in seconds (default: 0 for no timeout)
  --worktree                    Auto-create a detached git worktree under ~/.cline/worktrees/ and run the task there
  -v, --verbose                 Show verbose output
"""

[[commands.field]]
id = "prompt"
label = "Prompt"
description = "Task for Cline. Omit to start interactively."
type = "string"
position = 0
sources = ["help"]

[[commands.field]]
id = "plan"
label = "Plan mode"
type = "boolean"
option = ["--plan", "-p"]
sources = ["help"]

[[commands.field]]
id = "cwd"
label = "Working directory"
type = "path"
option = ["--cwd", "-c"]
path = { kind = "directory", role = "input" }
sources = ["help"]

[[commands.field]]
id = "provider"
label = "Provider"
type = "string"
option = ["--provider", "-P"]
sources = ["help"]

[[commands.field]]
id = "model"
label = "Model"
type = "string"
option = ["--model", "-m"]
sources = ["help"]

[[commands.field]]
id = "thinking"
label = "Reasoning effort"
type = "enum"
option = ["--thinking"]
choices = [{ value = "none", label = "none" }, { value = "low", label = "low" }, { value = "medium", label = "medium" }, { value = "high", label = "high" }, { value = "xhigh", label = "xhigh" }]
sources = ["help"]

[[commands.field]]
id = "auto_approve"
label = "Auto-approve tools"
description = "Default is true."
type = "enum"
option = ["--auto-approve"]
choices = [{ value = "true", label = "Yes" }, { value = "false", label = "No" }]
sources = ["help"]

[[commands.field]]
id = "json"
label = "JSON output"
type = "boolean"
option = ["--json"]
sources = ["help"]

[[commands.field]]
id = "timeout"
label = "Timeout (seconds)"
type = "integer"
option = ["--timeout", "-t"]
sources = ["help"]

[[commands.field]]
id = "tui"
label = "Open TUI"
type = "boolean"
option = ["--tui", "-i"]
sources = ["help"]

[[commands.field]]
id = "worktree"
label = "Run in a git worktree"
type = "boolean"
option = ["--worktree"]
sources = ["help"]

[[commands.field]]
id = "verbose"
label = "Verbose"
type = "boolean"
option = ["--verbose", "-v"]
sources = ["help"]

[[commands.task]]
id = "run"
label = "Run a prompt"
fields = ["prompt", "cwd", "provider", "model", "auto_approve", "timeout"]
required = ["prompt"]

[[commands.task]]
id = "plan"
label = "Plan only"
set = { plan = [true] }
lock = ["plan"]
fields = ["prompt", "plan", "cwd", "model"]
required = ["prompt"]

[[commands.task]]
id = "tui"
label = "Interactive TUI"
set = { tui = [true] }
lock = ["tui"]
fields = ["tui", "cwd", "model"]
required = []

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["prompt", "plan", "cwd", "model", "tui"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["provider", "thinking", "auto_approve", "json", "timeout", "worktree", "verbose"]