DocsConfigurationConfiguration Reference
Back to Docs
Configuration

Configuration Reference

Reference for key YeePilot config sections: AI runtime, recovery, knowledge, security, vault, sandbox, and TUI.

Last updated: March 1, 2026

Config File Location

~/.yeepilot/config.yaml

Regenerate/reset:

bash
yeepilot setup --reset

High-Value Sections

yaml
ai:
  provider: openrouter
  model: openai/gpt-oss-120b:free
  engine: v2
  autonomy_profile: high
  token_mode: normal
  think_mode: off
 
  recovery:
    enabled: true
    global_max_cycles: 4
    auto_fix_cycles_max: 4
    stop_on_repeated_signature: true
    require_verify_after_auto_fix: true
    missing_dependency_policy: smart
    kind_budgets:
      patch_conflict: 2
      build_breakage: 2
      test_regression: 2
      verification_failed: 1
 
  agentic:
    preedit_auto_context_enabled: true
    recovery_auto_context_enabled: true
    auto_verify_rerun_enabled: true
    auto_checklist_rerun_enabled: true
    auto_patch_synthesis_enabled: true
    auto_patch_max_candidates: 2
    auto_patch_apply_strategy: patch_first
    auto_patch_confidence_threshold: 0.70
    max_auto_repair_passes: 3
 
  knowledge:
    enabled: true
    freshness_policy: auto_live
    offline_behavior: graceful_fallback
    source_policy: official_first
    max_sources: 4
    cache_ttl: 6h
 
  context7:
    enabled: true
    base_url: https://context7.com
    max_chars: 8000
 
security:
  mode: moderate
  require_confirmation: true
 
vault:
  enabled: false
  start_locked: true
  auto_lock_duration: 15m
  bruteforce_protection_enabled: true
  wipe_on_bruteforce_enabled: false
  wipe_after_failures: 15
 
sandbox:
  enabled: true
  use_namespaces: true
  network_access: true
 
tui:
  theme: auto
  live_stream_panel_enabled: true

ai Core Keys

  • provider: openrouter | openai | anthropic
  • model: provider model ID
  • engine: recommended v2
  • autonomy_profile: high | guarded | strict_review | ultra
  • token_mode: normal | saver
  • think_mode: off | on | low | medium | high

Recovery Keys (ai.recovery)

Controls bounded automatic repair loops.

Important knobs:

  • global cycle limit
  • per-failure-kind budgets
  • repeated-signature stop protection
  • verify-after-fix requirement

Agentic Keys (ai.agentic)

Controls auto-context, verification reruns, and patch synthesis behavior.

Freshness Keys (ai.knowledge, ai.context7)

Controls web-freshness behavior and optional Context7 retrieval.

security Keys

  • mode: strict | moderate | permissive
  • require_confirmation: force confirmation prompts
  • blocked_patterns: extra regex hard-blocks
  • audit controls (audit_log_path, rotation settings)

vault Keys

  • enabled
  • start_locked
  • auto_lock_duration (off allowed)
  • bruteforce_protection_enabled
  • wipe_on_bruteforce_enabled
  • wipe_after_failures

sandbox Keys

  • enabled
  • use_namespaces (Linux)
  • network_access
  • resource limits (max_cpu_seconds, max_memory_mb, max_filesize_mb, max_processes)
  • denied_paths

update Keys

yaml
update:
  auto_check: true
  check_interval_hours: 1

Environment Variable Overrides

Use YEEPILOT_ prefix with dot-to-underscore mapping:

bash
YEEPILOT_AI_PROVIDER=openai
YEEPILOT_AI_MODEL=gpt-4o
YEEPILOT_AI_AUTONOMY_PROFILE=guarded
YEEPILOT_SECURITY_MODE=strict
YEEPILOT_PLATFORM_SERVER_URL=https://yee.to
Previous

Credential Vault

Security

Next

Environment Variables

Configuration