Skip to content

clinvk config

Manage configuration.

Synopsis

clinvk config [command] [flags]

Description

The config command provides subcommands for viewing and modifying clinvk configuration. The configuration is stored in ~/.clinvk/config.yaml by default.

Subcommands

Command Description
show Display current configuration
get Get a specific configuration value
set Set a configuration value

clinvk config show

Display the current configuration.

Usage

clinvk config show

Output

default_backend: claude

unified_flags:
  approval_mode: default
  sandbox_mode: default
  verbose: false
  dry_run: false
  max_turns: 0
  max_tokens: 0
  command_timeout_secs: 0

backends:
  claude:
    model: claude-opus-4-5-20251101
    enabled: true
  codex:
    model: o3
    enabled: true
  gemini:
    model: gemini-2.5-pro
    enabled: true

session:
  retention_days: 30
  store_token_usage: true

output:
  format: json
  show_tokens: false
  show_timing: false
  color: true

server:
  host: 127.0.0.1
  port: 8080

parallel:
  max_workers: 3
  fail_fast: false

clinvk config get

Get a specific configuration value.

Usage

clinvk config get <key>

Key Format

Use dot notation for nested keys:

clinvk config get default_backend
clinvk config get backends.claude.model
clinvk config get session.retention_days

Examples

Get default backend:

clinvk config get default_backend
# Output: claude

Get Claude model:

clinvk config get backends.claude.model
# Output: claude-opus-4-5-20251101

Get session retention:

clinvk config get session.retention_days
# Output: 30

clinvk config set

Set a configuration value.

Usage

clinvk config set <key> <value>

Key Format

Use dot notation for nested keys:

clinvk config set default_backend codex
clinvk config set backends.claude.model claude-sonnet-4-20250514
clinvk config set session.retention_days 7

Examples

Set default backend:

clinvk config set default_backend codex

Set Claude model:

clinvk config set backends.claude.model claude-sonnet-4-20250514

Set session retention:

clinvk config set session.retention_days 7

Set parallel workers:

clinvk config set parallel.max_workers 5

Enable verbose output:

clinvk config set unified_flags.verbose true

Value Types

Type Example Notes
String "claude" Quotes optional unless containing spaces
Integer 30 No quotes
Boolean true, false No quotes
Array ["item1", "item2"] YAML array syntax

Configuration File Location

Default location: ~/.clinvk/config.yaml

Use --config flag to specify a different file:

clinvk --config /path/to/config.yaml config show

Configuration Priority

Configuration values are resolved in this order (highest to lowest):

  1. CLI Flags - Command-line arguments
  2. Environment Variables - CLINVK_* variables
  3. Config File - ~/.clinvk/config.yaml
  4. Defaults - Built-in defaults

Common Errors

Error Cause Solution
key not found Configuration key doesn't exist Check spelling and use dot notation
invalid value Value type doesn't match Use correct type for the key
config file not found Config file missing Create one with clinvk config set
permission denied Can't write config file Check file permissions

Exit Codes

Code Description
0 Success
1 Invalid key or value
3 Configuration error
  • prompt - Execute prompts with config settings
  • serve - Start server with config settings

See Also