設定リファレンス

設定ファイルの場所

メイン設定は次にあります。

~/.yeepilot/config.yml

古い環境には ~/.yeepilot/config.yaml が残ることがありますが、現在の正しいパスは config.yml です。

変更方法

実用的な方法は 3 つです。

• yeepilot setup
• Neural HUD の Settings
• config.yml の手動編集

優先順位

実務上の優先順位:

1. 環境変数
2. ~/.yeepilot/config.yml
3. 内部デフォルト

ai セクション

主な AI 動作を制御します。

• provider
• model
• base_url
• thinking
• token_mode
• vibe_coding

例:

ai:
  provider: openrouter
  model: openai/gpt-oss-120b:free
  thinking: auto
  token_mode: balanced
  vibe_coding: false

ai の上級サブセクション

環境によっては次も使います。

• ai.recovery
• ai.agentic
• ai.failover
• ai.knowledge
• ai.context7
• ai.codeintel
• ai.verification
• ai.scheduler

エンドユーザーとしては、理解しているものだけを小さく変更するのが安全です。

security セクション

承認、セキュリティ姿勢、監査関連を制御します。

よく見る項目:

• mode
• require_confirmation
• audit

sandbox セクション

ローカル runtime に許す範囲を制限します。

主なキー:

• enabled
• use_namespaces
• network_access
• max_cpu_seconds
• max_memory_mb
• max_filesize_mb
• max_processes
• denied_paths

例:

sandbox:
  enabled: true
  network_access: false
  max_cpu_seconds: 120
  max_memory_mb: 1024

tui セクション

ターミナル UI を制御します。

• theme
• language
• live stream
• sidecar
• 見た目の挙動

tui.hud.* のような内部寄り設定は、手編集より HUD から変える方が扱いやすいことが多いです。

Keybinds

エンドユーザーは HUD の Keybinds タブからショートカットを管理するのが基本です。tui.keybinds.actions は存在しますが、内部 action ID を手編集する運用は通常おすすめしません。

files セクション

添付ファイル、コンテキスト、ローカルファイルの扱いを制御します。大きなリポジトリを扱う場合はここを見直すとよいです。

vault セクション

ロック、autolock、Vault の挙動に関する設定です。秘密情報へのアクセスや回復に関わるため慎重に扱ってください。

personality セクション

ユーザーから見えるトーンや運用プロフィールを調整します。組織で明確な方針がある場合だけ変更するのが無難です。

platform セクション

実行環境に関する設定です。多くのユーザーは頻繁に変更しません。

update セクション

更新確認と適用方法を制御します。

主なキー:

• auto_check
• check_interval_hours
• channel
• channel_token

例:

update:
  auto_check: true
  check_interval_hours: 24
  channel: public

主操作として使うべきでないもの

古い情報では ai.agent_mode が出てくることがありますが、これは互換性目的です。現在の主要コントロールとして使うべきなのは次です。

• /plan
• /autonomy
• /think
• ai.vibe_coding

実務的な勧め

• まず HUD や yeepilot setup から変える
• 手編集は理解している設定だけに絞る
• 重要な変更は小さなタスクで試してから広げる