alvinunreal/tmuxai

解決的問題

TmuxAI 是一個直接整合至 tmux 會話的智慧型終端助理，扮演配對程式設計師的角色。它讓 AI 能觀察你的 tmux 面板內容，並代表你執行命令，從而無需在終端與外部 AI 聊天介面之間切換。

工作原理

TmuxAI 將 tmux 窗口分為三個功能區域：用於互動的聊天面板、用於執行命令的執行面板，以及提供上下文的唯讀面板。它在多種模式下運作：

• 觀察模式：預設模式，AI 讀取可見面板內容，提出命令建議，並在收到輸出前保持等待。
• 準備模式：透過自訂 shell 提示符來追蹤命令完成狀態與退出碼，而非使用固定等待時間，從而提升精確度。
• 準備模式：主動模式，AI 持續監控終端活動，根據使用者定義的目標即時提供建議或標記錯誤。
• 知識庫與技能：使用者可載入基於 markdown 的參考文件（知識庫）或結構化指令（技能），為 AI 提供專案特定的上下文或新能力。

適用對象

將 tmux 作為主要終端多工器，並希望獲得能感知當前終端環境的 AI 協助的開發者與系統管理員。

主要特色

• 上下文感知：自動捕獲 shell 類型、作業系統與可見面板內容。
• 命令執行：在專用面板中執行建議命令，需使用者確認並顯示風險指示。
• 上下文管理：包含「壓縮」機制，用於總結聊天歷史並管理 token 使用量。
• 可擴展性：支援自訂知識庫與技能，適用於特定工作流程。
• 外部編輯器整合：透過鍵盤快速鍵，可在設定的外部文字編輯器中編輯長提示。