pi-tmux-task
一个极简的、基于tmux的AI代理任务管理器。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-tmux-task。 它的用途是：一个极简的、基于tmux的AI代理任务管理器。 完整的 Skill 内容见：https://321skill.com/skills/pi-tmux-task/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
对AI代理说：“开始执行数据备份和清理的每周任务。” 代理启动后，pi-tmux-task会自动创建一个tmux会话。您只需在终端输入`tmux attach -t pi-task`，就能看到一个分窗格的面板，实时显示“数据库备份”、“日志清理”等子任务的进度，以及“备份完成”、“发送通知”等技能触发和系统消息。
介绍
pi-tmux-task 旨在解决AI代理在复杂或长时间运行任务时，缺乏直观、轻量级进度监控和管理界面的问题。它提供了一个基于tmux会话的可视化面板，让用户能够清晰地看到代理正在执行的任务、已触发的技能以及系统通知，从而摆脱了仅依赖纯文本日志的局限。
使用方式非常直接：通过npm安装后，在您的AI代理项目中引入并配置该模块。当代理开始执行任务时，它会自动在后台启动一个tmux会话，并将任务分解为不同的窗格进行展示。您只需切换到对应的tmux会话，即可实时观察任务状态、技能调用记录和关键通知，而无需中断代理的运行。
它非常适合那些使用AI代理（如基于Claude、GPT等模型的自主工作流）进行自动化开发、数据处理或长期监控的开发者、DevOps工程师和AI研究员。特别是当任务链涉及多个步骤、需要调用不同技能或等待外部事件时，它能显著提升任务的可观测性。
建议在Linux或macOS的终端环境下使用，并确保系统已安装tmux。由于它专注于“仅技能和通知”的展示，因此不提供复杂的交互控制功能（如通过tmux直接向代理发送指令）。主要将其作为一个被动的“仪表盘”来使用，核心的任务逻辑和控制仍需在您的代理代码中实现。
核心特点
核心区别在于其极简主义设计：它不试图成为一个全功能的代理控制台，而是专注于在tmux中可视化“技能调用”和“系统通知”这两项最关键的信息流，提供了比滚动日志更结构化、更即时的视图。
注意事项
不适合需要复杂交互控制、图形化界面或在Windows原生终端（无tmux）环境下直接使用的场景。
常见问题
pi-tmux-task 是任务调度器吗？
不是，它是一个任务状态和技能调用的可视化监视器，不负责调度或执行逻辑。
需要提前安装tmux吗？
是的，必须在系统环境中预先安装并配置好tmux才能正常运行。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-tmux-task/raw/index.md 读取 pi-tmux-task 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-tmux-task/raw/index.md（查看排版版本）