Docs設定設定リファレンス
ドキュメントに戻る
設定

設定リファレンス

config.yamlのすべてのYeePilot設定オプションの完全リファレンス

最終更新: 2026年3月1日

設定ファイル

YeePilotは設定を ~/.yeepilot/config.yaml に保存します。このファイルは初回セットアップ時に自動作成され、手動で編集するか yeepilot setup コマンドで変更できます。

yaml
# 最小設定の例
ai:
  provider: openai
  model: gpt-4o
 
security:
  mode: strict
 
personality:
  language: en

設定をデフォルト値で再生成するには：

bash
yeepilot setup --reset

AI設定

ai: セクションは、YeePilotが使用するAIプロバイダーとモデル、言語モデルとの対話方法を制御します。

yaml
ai:
  provider: openai
  model: gpt-4o
  api_key: ""
  base_url: ""
  max_tokens: 4096
  token_mode: normal
  conversation_max_history: 10
  output_truncate_length: 500
  max_response_length: 102400
  engine: v2
  autonomy_profile: guarded
  think_mode: "off"
  agent_mode: false

provider

使用するAIバックエンド。サポートされる値：openai、anthropic、openrouter。

yaml
ai:
  provider: openai

model

特定のモデル識別子。選択したプロバイダーの有効なモデルIDである必要があります。

プロバイダーモデル例
openaigpt-4o、gpt-4o-mini、o3-mini
anthropicclaude-sonnet-4-20250514、claude-haiku-4-20250414
openrouteropenai/gpt-4o、anthropic/claude-sonnet-4-20250514

api_key

設定されたプロバイダーのAPIキー。ここに設定することもできますが、yeepilot setup --auth によるOSキーリングや環境変数の使用がセキュリティ上推奨されます。

yaml
ai:
  api_key: "sk-..."

base_url

デフォルトのAPIエンドポイントを上書きします。プロキシ、ローカルモデル、代替のAPI互換サービスに便利です。

yaml
ai:
  provider: openai
  base_url: "http://localhost:11434/v1"

max_tokens

AIが1回の応答で生成できる最大トークン数。デフォルト：4096。

yaml
ai:
  max_tokens: 8192

token_mode

YeePilotがトークン使用量をどの程度積極的に管理するかを制御します。デフォルト：normal。

  • normal -- 完全なコンテキストと詳細な応答。
  • saver -- より短いシステムプロンプト、圧縮された履歴、より積極的なコンテキストコンパクション。コストを大幅に削減します。
yaml
ai:
  token_mode: saver

conversation_max_history

会話コンテキストに保持する過去のメッセージ数。デフォルト：10。値を下げるとトークン使用量が減り、AIが最近のタスクに集中します。

yaml
ai:
  conversation_max_history: 10

output_truncate_length

AIコンテキストに含めるコマンド出力の最大文字数。デフォルト：500。大きな出力がトークン予算を消費するのを防ぎます。

yaml
ai:
  output_truncate_length: 500

max_response_length

AI応答サイズのハード制限（バイト単位）。デフォルト：102400（100 KB）。

yaml
ai:
  max_response_length: 102400

engine

実行エンジンのバージョン。デフォルト：v2。

  • v2 -- エージェントループ、ツール呼び出し、マルチステップ実行を備えた現行エンジン。
  • legacy -- ツール呼び出しなしの単一ターンコマンド生成。
yaml
ai:
  engine: v2

autonomy_profile

AIが確認なしでコマンドを実行できる自由度を制御します。デフォルト：guarded。

  • high -- SAFEおよびMODERATEコマンドを自動実行。DANGEROUSコマンドのみ確認が必要。
  • guarded -- SAFEコマンドを自動実行。MODERATEおよびDANGEROUSコマンドは確認が必要。
  • strict_review -- リスクレベルに関係なく、すべてのコマンドが実行前に明示的な確認を要求。
yaml
ai:
  autonomy_profile: guarded

think_mode

拡張推論をサポートするプロバイダー（Anthropic、OpenAI推論モデル）で拡張推論を有効にします。デフォルト：off。

  • off -- 拡張思考なし。
  • on -- プロバイダーのデフォルトバジェットで思考を有効化。
  • low -- 最小限の思考バジェット。
  • medium -- 複雑なタスク向けの中程度の思考バジェット。
  • high -- 最も難しい問題向けの最大思考バジェット。
yaml
ai:
  think_mode: medium

セッション中に /think スラッシュコマンドで切り替えることもできます。

agent_mode

AIエージェントループを有効にし、AIが複雑なタスクを完了するために複数のツール呼び出しとコマンドを連鎖できるようにします。デフォルト：false。

yaml
ai:
  agent_mode: true

セキュリティ設定

security: セクションはコマンドの安全性チェック、確認要件、監査ログを制御します。

yaml
security:
  mode: strict
  require_confirmation: true
  blocked_patterns:
    - "rm -rf /"
    - "mkfs"
    - "dd if=/dev/zero"
  audit_log_path: "~/.yeepilot/audit.log"
  audit_max_size_mb: 10
  audit_max_archives: 50

mode

全体的なセキュリティ姿勢。デフォルト：strict。

  • strict -- 最大の安全性。最も破壊的なコマンドは完全にブロック。本番サーバーに推奨。
  • moderate -- バランスの取れた安全性。破壊的なコマンドは確認が必要だがブロックはされない。
  • permissive -- 最小限の制限。最も危険なコマンド（ディスクのワイプなど）のみブロック。隔離された開発環境のみに適切。
yaml
security:
  mode: strict

require_confirmation

コマンド実行前にプロンプトを表示するかどうか。デフォルト：true。false に設定すると、自律プロファイルがどのコマンドを自動実行するかを決定します。

yaml
security:
  require_confirmation: true

blocked_patterns

完全にブロックする追加コマンドパターン。YeePilotの70以上の危険パターンの組み込みブロックリストに追加されます。

yaml
security:
  blocked_patterns:
    - "shutdown"
    - "reboot"
    - "halt"
    - "init 0"

audit_log_path

改ざん検知可能な監査ログのファイルパス。デフォルト：~/.yeepilot/audit.log。

yaml
security:
  audit_log_path: "/var/log/yeepilot/audit.log"

audit_max_size_mb

ローテーション前の単一監査ログファイルの最大サイズ。デフォルト：10 MB。

yaml
security:
  audit_max_size_mb: 10

audit_max_archives

保持するローテーション済み監査ログファイルの数。デフォルト：50。

yaml
security:
  audit_max_archives: 50

サンドボックス設定

sandbox: セクションはコマンド実行の分離を設定します。サンドボックス設定はコマンドの動作を制限し、システムを保護します。

yaml
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"
    - "/root/.ssh"

enabled

実行サンドボックスの有効/無効。デフォルト：true。無効にするとすべての実行制限が解除されます。

yaml
sandbox:
  enabled: true

use_namespaces

完全なプロセス分離のためにLinuxカーネル名前空間（user、PID、mount、network）を使用します。デフォルト：true。Linuxでのみ利用可能。macOSとWindowsではプロセスレベルの制限にフォールバックします。

yaml
sandbox:
  use_namespaces: true

network_access

コマンドのネットワークアクセスを許可します。デフォルト：true。false に設定するとコマンド実行をネットワークから完全に分離します。

yaml
sandbox:
  network_access: false

max_cpu_seconds

単一のコマンドが消費できる最大CPU時間。デフォルト：300 秒（5分）。

yaml
sandbox:
  max_cpu_seconds: 300

max_memory_mb

コマンドが使用できる最大メモリ。デフォルト：512 MB。

yaml
sandbox:
  max_memory_mb: 512

max_filesize_mb

コマンドが作成できる単一ファイルの最大サイズ。デフォルト：100 MB。

yaml
sandbox:
  max_filesize_mb: 100

max_processes

コマンドが生成できる子プロセスの最大数。デフォルト：64。

yaml
sandbox:
  max_processes: 64

denied_paths

コマンドが読み書きできないファイルパス。組み込みの保護パスに追加されます。

yaml
sandbox:
  denied_paths:
    - "/etc/shadow"
    - "/etc/passwd"
    - "/root/.ssh"
    - "/home/*/.ssh/id_*"

パーソナリティ設定

personality: セクションはYeePilotのコミュニケーション方法を制御します。

yaml
personality:
  tone: casual
  language: en
  use_emoji: true
  verbosity: normal

tone

AI応答の会話トーン。デフォルト：casual。

  • casual -- フレンドリーで会話的な応答。
  • professional -- フォーマルで簡潔な応答。仕事環境に適しています。
  • minimal -- 最小限の説明。コマンドと結果のみ。
yaml
personality:
  tone: professional

language

YeePilotのインターフェースとAI応答の言語。デフォルト：en。

  • en -- 英語
  • de -- ドイツ語（Deutsch）
  • auto -- システムロケールから検出
yaml
personality:
  language: auto

use_emoji

AI応答とステータスメッセージに絵文字を含める。デフォルト：true。

yaml
personality:
  use_emoji: false

verbosity

AIが応答に含める詳細度。デフォルト：normal。

  • brief -- 短く要点を絞った説明。
  • normal -- コンテキストを含むバランスの取れた説明。
  • detailed -- 背景情報を含む徹底的な説明。
yaml
personality:
  verbosity: detailed

TUI設定

tui: セクションはターミナルユーザーインターフェースの外観と動作をカスタマイズします。

yaml
tui:
  theme: auto
  stats_panel: true
  code_line_numbers: true
  live_stream_panel_enabled: true
  live_stream_panel_height: 12

theme

ターミナルインターフェースのカラーテーマ。デフォルト：auto（ターミナルの背景に合わせる）。

利用可能なテーマ：auto、dark、light、neon など。

yaml
tui:
  theme: neon

stats_panel

トークン使用量、コスト、セッション情報を含む統計パネルの表示。デフォルト：true。

yaml
tui:
  stats_panel: true

code_line_numbers

TUIに表示されるコードブロックに行番号を表示。デフォルト：true。

yaml
tui:
  code_line_numbers: true

live_stream_panel_enabled

コマンド実行中にリアルタイムで出力をストリーミングするライブパネルの表示。デフォルト：true。

yaml
tui:
  live_stream_panel_enabled: true

live_stream_panel_height

ライブストリームパネルの行数。デフォルト：12。

yaml
tui:
  live_stream_panel_height: 16

ボールト設定

vault: セクションは、データベースパスワードやAPIトークンなどのシークレットを保管する暗号化クレデンシャルボールトを設定します。

yaml
vault:
  enabled: true
  start_locked: true
  auto_lock_duration: "15m"
  bruteforce_protection_enabled: true

enabled

暗号化ボールト機能の有効化。デフォルト：true。

yaml
vault:
  enabled: true

start_locked

YeePilot起動時にボールトをロック状態にし、アンロックを要求するかどうか。デフォルト：true。

yaml
vault:
  start_locked: true

auto_lock_duration

この非アクティブ期間後にボールトを自動的にロック。デフォルト：15m。Go期間形式をサポート（例：5m、1h、30s）。

yaml
vault:
  auto_lock_duration: "30m"

bruteforce_protection_enabled

繰り返しの失敗後にアンロック試行を制限するブルートフォース保護の有効化。デフォルト：true。

yaml
vault:
  bruteforce_protection_enabled: true

プラットフォーム設定

platform: セクションはYeePilotプラットフォームサービスへの接続を設定します。

yaml
platform:
  server_url: "https://yee.to"

server_url

YeePilotプラットフォームサーバーのURL。デフォルト：https://yee.to。セルフホストのプラットフォームインスタンスを使用する場合のみ変更してください。

yaml
platform:
  server_url: "https://yee.to"

アップデート設定

update: セクションは自動アップデート動作を制御します。

yaml
update:
  auto_check: true
  check_interval_hours: 1

auto_check

YeePilot起動時にアップデートを自動チェック。デフォルト：true。

yaml
update:
  auto_check: true

check_interval_hours

アップデートチェックの頻度（時間単位）。デフォルト：1。

yaml
update:
  check_interval_hours: 24

ファイル設定

files: セクションは、AIコンテキストとしてファイルをアップロードする /file コマンドの動作を制御します。

yaml
files:
  max_entries: 20
  max_file_size: 102400
  max_total: 524288
  upload_dir: ""

max_entries

セッションに添付できる最大ファイル数。デフォルト：20。

yaml
files:
  max_entries: 20

max_file_size

単一ファイルの最大サイズ（バイト）。デフォルト：102400（100 KB）。

yaml
files:
  max_file_size: 102400

max_total

添付されたすべてのファイルの合計最大サイズ（バイト）。デフォルト：524288（512 KB）。

yaml
files:
  max_total: 524288

upload_dir

一時的なファイルアップロード用のカスタムディレクトリ。空欄でシステムのデフォルトを使用。

yaml
files:
  upload_dir: "/tmp/yeepilot-files"

完全な設定例

以下は、すべてのセクションと一般的に調整される値を含む包括的な設定ファイルです：

yaml
ai:
  provider: openai
  model: gpt-4o
  max_tokens: 4096
  token_mode: normal
  conversation_max_history: 10
  output_truncate_length: 500
  max_response_length: 102400
  engine: v2
  autonomy_profile: guarded
  think_mode: "off"
  agent_mode: false
 
security:
  mode: strict
  require_confirmation: true
  blocked_patterns: []
  audit_log_path: "~/.yeepilot/audit.log"
  audit_max_size_mb: 10
  audit_max_archives: 50
 
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: []
 
personality:
  tone: casual
  language: en
  use_emoji: true
  verbosity: normal
 
tui:
  theme: auto
  stats_panel: true
  code_line_numbers: true
  live_stream_panel_enabled: true
  live_stream_panel_height: 12
 
vault:
  enabled: true
  start_locked: true
  auto_lock_duration: "15m"
  bruteforce_protection_enabled: true
 
platform:
  server_url: "https://yee.to"
 
update:
  auto_check: true
  check_interval_hours: 1
 
files:
  max_entries: 20
  max_file_size: 102400
  max_total: 524288
前へ

クレデンシャルボールト

Security

次へ

環境変数

Configuration