pi-tmux-spinner
为pi编码代理提供tmux窗口名动画加载效果
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:pi-tmux-spinner。 它的用途是:为pi编码代理提供tmux窗口名动画加载效果 完整的 Skill 内容见:https://321skill.com/skills/pi-tmux-spinner/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“启动后端服务并监控运行状态”,它会在对应tmux窗口名位置展示动态旋转加载动画,待服务启动完成后自动恢复原有窗口名称。
对AI说:“批量更新项目依赖包”,它会在整个任务执行周期持续显示动画,你无需切换窗口就能快速判断任务是否在正常推进。
介绍
在使用pi编码代理配合tmux执行耗时开发任务时,终端窗口往往没有直观的运行状态标识,用户很难快速判断任务是在正常推进还是已经卡死,容易出现重复触发操作、浪费等待时间的问题,这款工具就是为了解决tmux场景下pi代理任务状态可视化缺失的痛点。 安装完成后,它会自动关联pi编码代理的任务执行流程,当pi代理启动任务时,对应tmux窗口名会自动切换为动态旋转的spinner动画,任务执行结束后会自动恢复为原本的窗口名称,使用过程中不需要手动触发或切换动画状态。 它适合日常使用tmux作为终端复用工具、同时依赖pi编码代理处理各类开发任务的开发者,尤其是经常同时开启多个tmux窗口运行并行任务、需要快速感知各窗口任务状态的后端、运维及全栈开发人员。 使用前请确保当前tmux版本开放了窗口名动态修改权限,尽量避免同时启用其他会自动修改tmux窗口名的插件,防止出现显示冲突;如果需要自定义动画样式,可以直接修改包内的帧序列配置文件调整显示效果。
核心特点
它是专门适配pi编码代理的tmux窗口名动画工具,直接绑定pi代理任务生命周期触发效果,相比通用tmux spinner无需额外配置状态监听规则,适配成本为零。
注意事项
仅支持搭配pi编码代理使用,无法直接为其他AI编码工具或普通终端任务提供tmux窗口动画效果。
常见问题
这个工具可以脱离pi编码代理单独使用吗?
不可以,它是专门为pi编码代理设计的,需搭配pi代理才能触发动画效果。
安装后tmux窗口不显示动画怎么办?
请检查tmux是否开放窗口名修改权限,且未启用其他修改窗口名的同类插件。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/pi-tmux-spinner/raw/index.md 读取 pi-tmux-spinner 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/pi-tmux-spinner/raw/index.md(查看排版版本)