Configuration Reference¶

claudio config init

completion:
  default_action: prompt

tui:
  auto_focus_on_input: true
  max_output_lines: 1000
  sidebar_width: 36
  theme: default

tui:
  theme: dracula  # or: monokai, nord, claude-code, etc.

# Generate a template
claudio config theme create my-theme

# Export an existing theme for customization
claudio config theme export dracula > ~/.config/claudio/themes/my-dracula.yaml

# List all available themes
claudio config theme list

instance:
  output_buffer_size: 100000
  capture_interval_ms: 100
  tmux_width: 200
  tmux_height: 50
  activity_timeout_minutes: 30
  completion_timeout_minutes: 60

ai:
  backend: claude
  claude:
    command: claude
    skip_permissions: true
  codex:
    command: codex
    approval_mode: full-auto

branch:
  prefix: claudio
  include_id: true

pr:
  draft: false
  auto_rebase: true
  use_ai: true
  auto_pr_on_stop: false
  template: ""
  labels:
    - automated
  reviewers:
    default:
      - tech-lead
    by_path:
      "src/api/**": [backend-team]
      "*.md": [docs-team]

pr:
  template: |
    ## Summary
    {{.Summary}}

    ## Changes
    {{.Changes}}

    ## Testing
    {{.Testing}}

paths:
  # Use default (.claudio/worktrees relative to repo root)
  worktree_dir: ""

  # Or use a custom location:
  # worktree_dir: ~/claudio-worktrees
  # worktree_dir: /fast-ssd/worktrees
  # worktree_dir: .worktrees

paths:
  sparse_checkout:
    enabled: true
    directories:
      - "services/api/"
      - "shared/utils/"
      - "packages/common/"
    always_include:
      - ".github/"
      - "scripts/"
      - "Makefile"
    cone_mode: true

logging:
  enabled: true
  level: info
  max_size_mb: 10
  max_backups: 3

# Recent logs
claudio logs

# Follow in real-time
claudio logs -f

# Filter by level
claudio logs --level warn

# Search pattern
claudio logs --grep "conflict"

cleanup:
  warn_on_stale: true
  keep_remote_branches: true

resources:
  cost_warning_threshold: 5.00
  cost_limit: 0
  token_limit_per_instance: 0
  show_metrics_in_sidebar: true

session:
  auto_start_on_add: true

ultraplan:
  max_parallel: 3
  notifications:
    enabled: true
    use_sound: false
    sound_path: ""

tripleshot:
  auto_approve: false
  adversarial: false

adversarial:
  max_iterations: 10
  min_passing_score: 8

plan:
  output_format: issues
  multi_pass: false
  labels:
    - claudio-generated
  output_file: .claudio-plan.json

experimental:
  intelligent_naming: false
  triple_shot: false
  inline_plan: false  # enables :multiplan; :plan is always available
  inline_ultraplan: false
  grouped_instance_view: false

# ~/.config/claudio/config.yaml

# iOS builds can take a while - extend timeout
instance:
  activity_timeout_minutes: 45
  completion_timeout_minutes: 120

# Parallel instances can overwhelm Xcode builds
ultraplan:
  max_parallel: 2

# iOS PRs often need specific reviewers
pr:
  reviewers:
    default: [ios-lead]
    by_path:
      "*.swift": [ios-team]
      "*.xib": [ios-team]
      "*.storyboard": [ios-team]
      "*.xcconfig": [ios-team, devops]
      "Podfile*": [ios-team, devops]
      "Package.swift": [ios-team]

# iOS builds are resource-intensive
resources:
  cost_warning_threshold: 10.00

# Optional: Use fast SSD for worktrees (faster builds)
# paths:
#   worktree_dir: /Volumes/FastSSD/claudio-worktrees

# Optional: Sparse checkout for iOS in a large monorepo
# paths:
#   sparse_checkout:
#     enabled: true
#     directories:
#       - "ios/"
#       - "shared/"
#     always_include:
#       - "scripts/"
#       - ".github/"
#     cone_mode: true

# ~/.config/claudio/config.yaml

# What to do when instance completes
completion:
  default_action: prompt

# TUI settings
tui:
  auto_focus_on_input: true
  max_output_lines: 1000

# Instance process settings
instance:
  output_buffer_size: 100000
  capture_interval_ms: 100
  tmux_width: 200
  tmux_height: 50

# Branch naming
branch:
  prefix: claudio
  include_id: true

# Pull request settings
pr:
  draft: false
  auto_rebase: true
  use_ai: true
  auto_pr_on_stop: false
  labels:
    - ai-generated
  reviewers:
    default: []
    by_path:
      "src/api/**": [backend-team]
      "src/frontend/**": [frontend-team]

# File paths
paths:
  worktree_dir: ""  # Default: .claudio/worktrees

# Cleanup behavior
cleanup:
  warn_on_stale: true
  keep_remote_branches: true

# Resource limits
resources:
  cost_warning_threshold: 5.00
  cost_limit: 0
  token_limit_per_instance: 0
  show_metrics_in_sidebar: true

# Ultra-plan settings
ultraplan:
  max_parallel: 3
  notifications:
    enabled: true
    use_sound: false

# Experimental features (disabled by default)
experimental:
  intelligent_naming: false
  triple_shot: false
  inline_plan: false
  inline_ultraplan: false
  grouped_instance_view: false

# Show current config (validates syntax)
claudio config show

# Check config file path
claudio config path