alvinunreal/tmuxai

AI-Powered, Non-Intrusive Terminal Assistant

解决的问题

TmuxAI 是一个直接集成到 tmux 会话中的智能终端助手,充当配对程序员。它允许 AI 观察你的 tmux 窗口内容并代表你执行命令,从而无需在终端和外部 AI 聊天界面之间切换。

工作原理

TmuxAI 将 tmux 窗口划分为三个功能区域:用于交互的聊天面板、用于运行命令的执行面板,以及用于提供上下文的只读面板。它在多种模式下运行:

  • 观察模式:默认模式,AI 读取可见面板内容,提出命令建议,并在收到输出前保持等待。
  • 准备模式:通过自定义 shell 提示符来追踪命令完成状态和退出码,而非使用固定等待时间,从而提高精确度。
  • 准备模式:主动模式,AI 持续监控终端活动,根据用户定义的目标实时提供建议或标记错误。
  • 知识库与技能:用户可加载基于 markdown 的参考文件(知识库)或结构化指令(技能),为 AI 提供项目特定上下文或新能力。

适用人群

将 tmux 作为主要终端多路复用器,并希望获得能感知当前终端环境的 AI 辅助的开发者和系统管理员。

主要亮点

  • 上下文感知:自动捕获 shell 类型、操作系统和可见面板内容。
  • 命令执行:在专用面板中执行建议命令,需用户确认并显示风险指示。
  • 上下文管理:包含“压缩”机制,用于总结聊天历史并管理令牌使用量。
  • 可扩展性:支持自定义知识库和技能,适用于特定工作流。
  • 外部编辑器集成:通过键盘快捷键,可在配置的外部文本编辑器中编辑长提示。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目