alvinunreal/tmuxai

解决的问题

TmuxAI 是一个智能终端助手，专为在 tmux 会话中提供 AI 驱动的配对编程而设计。它消除了在终端和外部 AI 聊天界面之间切换的需要，让 AI 能够观察当前终端状态，并代表用户执行命令。

工作原理

TmuxAI 运行于单个 tmux 窗口中，将其划分为交互用的聊天面板、命令执行用的执行面板以及只读的上下文面板。它通过三种主要模式工作：

• 观察模式：默认模式，TmuxAI 捕获所有可见面板的内容，使用 LLM 处理请求并提出命令建议。若获得批准，将在执行面板中执行这些命令并监控输出。
• 准备模式：通过自定义 shell 提示符（bash、zsh、fish）来追踪命令完成状态和退出码，从而消除对固定等待时间的需求，提高精确度。
• 监控模式：一种主动模式，AI 持续监控终端活动，根据用户定义的目标建议更高效的命令或标记错误。

适用人群

专为将 tmux 作为主要终端多路复用器的开发者和系统管理员设计，他们希望获得一个能理解其 shell 环境实时上下文的深度集成 AI 助手。

主要亮点

• 上下文感知支持：读取所有 tmux 面板的可见内容，以理解项目的当前状态。
• 知识库与技能：支持加载基于 markdown 的参考文件（知识库）和结构化、富含元数据的指令（技能），以教授 AI 特定工作流程。
• 命令执行：可在用户确认和风险指示下，在专用面板中执行命令。
• 上下文管理：包含“压缩”功能，可总结聊天历史并管理令牌使用量。
• 外部编辑器集成：通过键盘快捷键，允许用户在首选的外部文本编辑器中编辑复杂提示。