alvinunreal/tmuxai

何を解決するか

TmuxAI は、tmux セッションに直接統合される知能型ターミナルアシスタントであり、ペアプログラマーとして機能します。AI が tmux パネルの内容を観察し、あなたの代わりにコマンドを実行できるため、ターミナルと外部のAIチャットインターフェースの間を切り替える必要がありません。

動作方法

TmuxAI は tmux ウィンドウを3つの機能領域に分類します：対話用のチャットパネル、コマンド実行用の実行パネル、コンテキスト表示用の読み取り専用パネル。複数のモードで動作します。

• 観察モード：デフォルトモード。AI は表示されているパネルの内容を読み取り、コマンドの提案を行い、出力が返ってくるまで待機します。
• 準備モード：シェルプロンプトをカスタマイズして、コマンドの完了状態や終了コードを追跡することで、固定の待機時間を使わず、より正確な制御を実現します。
• 準備モード：積極的モード。AI がターミナルの活動を継続的に監視し、ユーザーが定義した目標に基づいてリアルタイムで提案を提供したり、エラーを検出したりします。
• 知識ベースとスキル：ユーザーはマークダウン形式のリファレンスファイル（知識ベース）や構造化された指示（スキル）をロードし、AI にプロジェクト固有のコンテキストや新しい機能を提供できます。

対象ユーザー

tmux を主なターミナルマルチプレクサとして使用し、現在のターミナル環境を意識したAI支援を求める開発者やシステム管理者。

特徴

• コンテキスト認識：シェルタイプ、OS、表示されているパネルの内容を自動で取得。
• コマンド実行：ユーザーの承認とリスクインジケータを伴い、専用パネルで提案されたコマンドを実行。
• コンテキスト管理：チャット履歴を要約する「サンドイッチ」メカニズムを備え、トークン使用量を管理。
• 拡張性：専用ワークフロー用にカスタム知識ベースとスキルをサポート。
• 外部エディタ連携：キーボードショートカットで設定済みの外部テキストエディタで長いプロンプトを編集可能。