@r3b1s/tmux-pilot
在独立tmux窗口中启动和管理子代理进程,提供完整的TUI观测能力。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:@r3b1s/tmux-pilot。 它的用途是:在独立tmux窗口中启动和管理子代理进程,提供完整的TUI观测能力。 完整的 Skill 内容见:https://321skill.com/skills/r3b1s-tmux-pilot/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请使用tmux-pilot启动一个子代理,在后台运行数据清洗脚本并监控其日志。',它会创建一个分离的tmux窗口运行你的脚本,并返回窗口ID。你可以随时切换到该窗口查看实时输出,或通过TUI界面观察进程状态和调试日志,而主对话不受干扰。
介绍
tmux-pilot 解决了在单一AI对话中难以并行运行多个、长时间或资源密集型代理任务的问题。它允许你将子代理作为独立的进程生成在分离的tmux窗口中,从而避免干扰主对话,并能同时处理多个开发或分析任务。
使用方式很简单,在AI对话中通过特定指令触发,tmux-pilot会创建一个新的tmux会话或窗口来运行指定的代理任务。你可以在其中进行实时编码、运行脚本或执行命令,同时通过TUI(终端用户界面)全面观察进程状态、输出日志和资源使用情况。
该Skill非常适合需要并行处理复杂任务或长时间运行进程的开发者、工程师和研究人员。例如,全栈开发者在调试后端服务的同时,可以另开一个窗口监控前端构建;量化交易员可以同时回测多个策略。
建议在使用前确保系统已安装tmux,并熟悉基本的tmux操作命令(如切换窗口、分离会话)。由于子代理运行在独立进程中,请注意管理好这些进程的生命周期,避免产生僵尸进程或资源泄漏。对于简单的、一次性的短任务,直接在主对话中完成可能更高效。
核心特点
与仅能在当前对话内调用工具或运行简单命令的Skill不同,tmux-pilot将子代理作为真正的独立操作系统进程运行,提供了完整的终端环境、进程守护、生命周期管理和基于TUI的实时观测界面,包括设置UI和调试日志查看器,实现了对长时间运行任务的可靠托管和可视化监控。
注意事项
不适合执行简单的、即时的、无需观测进程状态或终端交互的一次性命令。
常见问题
tmux-pilot需要提前安装tmux吗?
是的,必须确保系统中已安装tmux终端复用器。
生成的子代理进程如何关闭?
可以通过tmux命令在对应会话中退出,或通过Skill提供的生命周期管理功能终止。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/r3b1s-tmux-pilot/raw/index.md 读取 @r3b1s/tmux-pilot 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/r3b1s-tmux-pilot/raw/index.md(查看排版版本)