Konfigurationsreferenz

Wo die Konfiguration liegt

YeePilot speichert die Hauptkonfiguration unter:

~/.yeepilot/config.yml

Legacy-Hinweis:

• ältere Installationen können noch ~/.yeepilot/config.yaml besitzen
• YeePilot kann diese Altdatei weiterhin lesen
• neue Schreibvorgänge verwenden config.yml

Zurücksetzen und neu erzeugen:

yeepilot setup --reset

Gute Ausgangskonfiguration

ai:
  provider: openrouter
  model: openai/gpt-oss-120b:free
  autonomy_profile: guarded
  vibe_coding: true
  token_mode: normal
  think_mode: medium
 
security:
  mode: strict
  require_confirmation: true
 
sandbox:
  enabled: true
  use_namespaces: true
  network_access: true
 
tui:
  theme: auto
  live_stream_panel_enabled: true
 
vault:
  enabled: false
  auto_lock_duration: 15m
 
update:
  auto_check: true
  channel: public

ai: Anbieter, Modell und Laufzeitverhalten

Das sind die Einstellungen, die Endnutzer am häufigsten berühren:

Provider-Standards

Wenn Sie nur ai.provider setzen, ergänzt YeePilot automatisch Standardmodell und Base-URL:

• OpenRouter: openai/gpt-oss-120b:free
• OpenAI: gpt-4o
• Anthropic: claude-sonnet-4-20250514

ai.codeintel: besseres lokales Projektverständnis

ai:
  codeintel:
    enabled: true
    index_backend: sqlite
    ast_enabled: true
    embeddings_enabled: true
    embeddings_provider: provider
    max_indexed_files: 10000
    max_file_size_bytes: 524288
    rebuild_on_startup: false

Die meisten Endnutzer sollten hier die Standardwerte beibehalten, außer ein Projekt muss deutlich kleiner oder leichter indexiert werden.

ai.verification, ai.recovery und ai.agentic

Diese Bereiche steuern, wie sorgfältig YeePilot Ergebnisse verifiziert und wie stark automatische Reparaturversuche begrenzt werden.

Verification

ai:
  verification:
    require_post_mutation_verify: true
    max_verify_retries: 1

Recovery

ai:
  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

missing_dependency_policy:

• smart
• fallback_only
• auto_install

Für Endnutzer ist smart fast immer die beste Wahl.

Agentic-Verhalten

ai:
  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

Das sind fortgeschrittene Regler. Endnutzer lassen sie normalerweise auf den Standardwerten.

ai.knowledge und ai.context7

Diese Einstellungen beeinflussen Frische und externe Wissensquellen:

ai:
  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

Empfehlung für normale Nutzung:

• knowledge.enabled: true
• offline_behavior: graceful_fallback
• source_policy: official_first

ai.failover

Wenn Sie Fallback-Anbieter möchten:

ai:
  failover:
    enabled: true
    chain:
      - provider: openai
        model: gpt-4o
      - provider: openrouter
        model: openai/gpt-oss-120b:free

Das ist optional, aber nützlich, wenn Verfügbarkeit wichtig ist.

security

security:
  mode: strict
  require_confirmation: true
  blocked_patterns:
    - "shutdown"
  audit_log_path: ~/.yeepilot/audit.log
  audit_max_size_mb: 10
  audit_max_archives: 50

Wichtige Nutzerhinweise:

• auf wichtigen Systemen strict verwenden
• require_confirmation: true beibehalten
• blocked_patterns für eigene No-Go-Befehle nutzen

sandbox

sandbox:
  enabled: true
  use_namespaces: true
  network_access: true
  max_cpu_seconds: 300
  max_memory_mb: 512
  max_filesize_mb: 100
  max_processes: 64
  denied_paths:
    - /etc/shadow
    - /etc/gshadow
    - /root

Das ist der Hauptbereich für Ausführungsisolation. Meist sollten Endnutzer ihn eingeschaltet lassen und nur Netzwerkzugriff oder Limits gezielt anpassen.

tui

Das sind die wichtigsten Oberflächeneinstellungen:

tui:
  theme: auto
  sidecar_emoji_mode: off
  stats_panel: true
  sidecar_module: sysmon
  code_line_numbers: false
  live_stream_panel_enabled: true
  live_stream_panel_height: 12
  live_stream_panel_scope: all_mutating_tools
  live_stream_panel_animation: true
  live_stream_panel_redact_sensitive: true

Wichtige Werte:

• theme: auto, dark, light, neon
• sidecar_module: sysmon, vault, tasks, notes, explorer
• live_stream_panel_scope: all_mutating_tools, file_tools_only, off

HUD- und Keybind-Konfiguration

Sie können außerdem sehen:

• tui.hud.*
• tui.keybinds.actions

Diese Einstellungen sind real, sollten aber in der Praxis meist über das Neural HUD statt per Hand editiert werden.

files

files:
  max_entries: 20
  max_file_size: 102400
  max_total: 524288
  upload_dir: ~/.yeepilot/uploads
  clipboard_paste_mode: auto

clipboard_paste_mode:

• auto
• on
• off

vault

vault:
  enabled: false
  start_locked: true
  auto_lock_duration: 15m
  bruteforce_protection_enabled: true
  wipe_on_bruteforce_enabled: false
  wipe_after_failures: 15

Wichtiger Hinweis:

• wipe_on_bruteforce_enabled ist bewusst ein Hochrisiko-Schalter
• nur aktivieren, wenn Sie die Wiederherstellungsfolgen vollständig verstehen

personality

personality:
  tone: casual
  language: auto
  use_emoji: false
  verbosity: normal

Wichtige Werte:

• tone: casual, professional, minimal
• language: auto, en, de
• verbosity: normal, brief, detailed

platform

platform:
  server_url: https://yee.to

Das ist die Basis-URL für Plattform-Login, Heartbeats, Diagnostics und entitlement-bezogene Client-Aufrufe.

update

update:
  auto_check: true
  check_interval_hours: 1
  channel: public
  channel_token: ""

Wichtige Werte:

• channel: public oder canary
• channel_token: nötig für geschützte Canary-Nutzung

Empfohlene Reihenfolge für Endnutzer

Nutzen Sie diese Wege in dieser Reihenfolge:

1. Setup-Assistent für Anbieter und Auth
2. Neural HUD Settings Tab für den Alltag
3. direkte Bearbeitung von config.yml nur für fortgeschrittene oder gebündelte Änderungen

So bleibt die Konfiguration nachvollziehbar und unnötige Low-Level-Fehler werden vermieden.