セッションと履歴
YeePilotの会話を保存、再開、管理。トークン使用量の追跡やセッションのエクスポートも可能です。
セッションの仕組み
YeePilotを使用するたびに、会話は自動的にセッションとして保存されます。セッションにはプロンプト、AIの応答、コマンドプラン、承認判断、実行出力がキャプチャされます。手動で保存する必要はありません -- バックグラウンドで自動的に行われます。
YeePilotを起動すると、最新のセッションが再開されます。新しく始めたい場合は /new コマンドを使用してください。
セッションの管理
新しいセッションの作成
> /newクリーンな会話履歴で新しいセッションを作成します。以前のセッションは保存され、後で再開できます。
すべてのセッションの一覧表示
> /sessions保存されたセッションの一覧が、名前、作成日、メッセージ数とともに表示されます。一覧からセッションを選択して切り替えます。
Sessions:
1. nginx-troubleshooting (12 messages, 2h ago)
2. database-migration (8 messages, yesterday)
3. firewall-setup (23 messages, 3 days ago)
Switch to: _セッションの名前変更
デフォルトでは、セッションに自動的に名前が付けられます。後で見つけやすいように意味のある名前を付けましょう：
> /rename nginx-troubleshooting引数なしで名前変更することで、名前の入力を求められることもできます：
> /rename
Enter new name: prod-server-auditセッションのエクスポート
現在のセッションをプレーンテキストのトランスクリプトとしてエクスポートします：
> /exportプロンプト、AIの応答、提案されたコマンド、実行出力を含む完全な会話が読みやすいテキストファイルとして保存されます。エクスポートはドキュメント、インシデントレポート、同僚との共有に便利です。
コンテキストウィンドウの管理
AIモデルには限られたコンテキストウィンドウ -- 一度に考慮できるテキストの量 -- があります。会話が長くなるにつれて、この制限に近づきます。YeePilotはコンテキストコンパクションによりこれを自動的に処理します。
コンパクションの仕組み
コンテキストウィンドウが約 80%の容量 に達すると、YeePilotは自動コンパクションをトリガーします：
- 会話の最も古い80%のメッセージが選択される
- これらのメッセージが簡潔な要約にまとめられる
- 要約が元のメッセージを置き換える
- 最新の20%のメッセージはそのまま残る
このプロセスはシームレスです。何もアクションを取る必要はなく、会話は通常通り続きます。AIは会話の初期の本質的なコンテキストを保持しつつ、新しいやり取りのためのスペースを確保します。
コンパクションで保持されるもの
要約には以下が保持されます：
- 重要な決定と結果
- 重要なファイルパスと設定値
- エラーメッセージとその解決策
- セッションの全体的な目標
自然に失われるもの：
- セッション初期の正確なコマンド出力
- 冗長な中間ステップ
- 成果につながらなかった探索的なコマンド
長いセッションの初期の正確な出力を参照する必要がある場合は、コンパクション前にセッションをエクスポートするか、次のタスク用に新しいセッションを開始することを検討してください。
トークン追跡
YeePilotはすべてのセッションのトークン使用量を追跡し、API消費量とコストの可視性を提供します。
トークン使用量の表示
セッション中に Ctrl+S を押すと、統計パネルが表示されます。以下が含まれます：
- プロンプトトークン -- AIに送信されたトークン（メッセージとコンテキスト）
- 完了トークン -- AIが生成したトークン
- 合計トークン -- セッションの合計使用量
- 推定コスト -- モデルのトークンあたりの料金から計算
トークンコストの理解
トークン使用量は以下の要因で大きく異なります：
- 会話の長さ -- 長いセッションでは、完全な履歴がコンテキストとして送信されるため、メッセージごとにより多くのトークンを使用
- エージェントモード -- マルチステップタスクは、繰り返しのコンテキストとツール呼び出しによりより多くのトークンを消費
- 思考モード -- より高い思考レベルはより多くの完了トークンを使用
- ファイルコンテキスト --
/fileで読み込まれたファイルはプロンプトトークン数に加算
コストを抑える
- ルーチンタスクには 無料のOpenRouterモデル を使用
- 非常に長い会話を続けるのではなく、
/newで新しいセッションを開始 - 不要になったファイルは
/unfileでコンテキストから削除 - 単純なタスクには低い思考モード（
/think low）を使用 - Ctrl+S で定期的に使用量を監視
セッションの保存場所
セッションは ~/.yeepilot/sessions/ にローカルに保存されます。各セッションは完全な会話履歴とメタデータを含むJSONファイルです。これらのファイルはあなたのユーザーアカウントからのみアクセスできます。
セッションはYeePilotのサーバーに送信されることはありません。完全にあなたのマシン上に残ります。システムから出るデータは、通常のプロンプト/レスポンスフローの一部として選択したAIプロバイダーに送信するもののみです。
実践的なワークフロー
タスクベースのセッション
個別のタスクごとに新しいセッションを作成します：
> /new
> /rename firewall-audit-2026-02
> Check all iptables rules and identify any overly permissive entriesこれによりセッションが整理され、後で見つけやすくなります。
インシデント対応
インシデント発生時、セッションは調査のリアルタイムログになります：
- 新しいセッションを開始：
/new - 名前を付ける：
/rename incident-2026-02-27-api-outage - YeePilotと一緒に診断を進める
- 解決したらエクスポート：
/export
エクスポートされたトランスクリプトは、何が確認され、何が発見され、どのようなアクションが取られたかを正確に示すインシデントレポートとして機能します。
作業の再開
翌日タスクに戻る場合：
> /sessions関連するセッションを選択します。AIは完全な会話コンテキストを持っており、中断したところから再開できます。