工程開發
tmux avatar

tmux

遠端控制 tmux 工作階段,透過發送鍵盤指令、監控輸出及管理窗格與視窗,以自動化互動式 CLI 工具。

簡介

tmux 技能為 OpenClaw 環境中的代理程式提供了一個強大的介面,以便與長時間運行的終端機應用程式進行互動。它的設計旨在作為助手與互動式命令列介面 (CLI)(如 Claude Code、Shell 指令碼或後台開發任務)之間的橋樑。透過抽象化 tmux 工作階段、視窗和窗格的複雜性,此技能允許對無頭或持久的終端機環境進行細粒度控制,確保自動化工作流程在斷線後仍能保持穩定。

  • 精確的輸入傳遞:向任何目標 tmux 窗格發送特定的鍵盤指令、標準文字或控制序列(如 Ctrl+C、Ctrl+D 或 Enter)。

  • 輸出可觀測性:即時擷取窗格捲動緩衝區,以分析處理程序狀態、監控錯誤日誌或解析互動式提示。

  • 工作階段生命週期管理:透過程式設計方式建立、重新命名、列出和終止 tmux 工作階段,以維護有組織的工作空間環境。

  • 導航控制:使用索引目標 (session:window.pane) 在 tmux 視窗和特定窗格之間動態切換。

  • 互動式自動化:監控終端機輸出中的特定模式或狀態變化,以觸發自動回應,例如批准提示或繼續長時間運行的建置任務。

  • 此工具最適合代理程式必須在終端機中維持狀態持久性的情境,例如除錯、持續整合或運行互動式助手。

  • 使用 capture-pane -p 命令直接擷取資料,以進行後續處理或代理程式決策。請始終使用 session:window.pane 格式以避免輸入錯誤。處理互動式 TUI 時,請將文字輸入與 Enter 鍵以短暫延遲分開,以防止輸入緩衝或多行邊緣情況。請注意,此技能不適用於一次性的 Shell 執行;對於簡單的非互動式命令,建議改用系統 exec 工具。始終確保目標 tmux 工作階段存在後再發送命令,以防止執行失敗。

倉庫統計

Star 數
365,899
Fork 數
75,022
Open Issue 數
6,951
主要語言
TypeScript
預設分支
main
同步狀態
閒置
最近同步時間
2026年4月29日 上午01:33
在 GitHub 查看