@romansix/pi-tmux
为Pi Agent提供按项目管理的tmux会话能力
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@romansix/pi-tmux。 它的用途是：为Pi Agent提供按项目管理的tmux会话能力 完整的 Skill 内容见：https://321skill.com/skills/romansix-pi-tmux/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“为当前项目创建一个tmux会话并进入”，它会自动初始化一个以项目命名的tmux会话并将你的终端附加进去。之后你可以说“切换到项目B的会话”，Pi会帮你保存当前会话状态并跳转到项目B的专属终端环境。
介绍
该Skill为Pi Coding Agent扩展了tmux会话管理功能，核心是解决开发者在多项目并行时终端会话混乱、切换繁琐的问题。它允许Pi Agent为每个项目创建独立的tmux会话，并自动保存和恢复会话状态，用户只需通过简单的指令即可在不同项目的开发环境间无缝跳转。
使用方式非常直接，安装此Skill后，Pi Agent便获得了管理tmux会话的命令集。开发者可以指示Pi为当前项目“创建”或“附加”到一个专属的tmux会话，后续所有在该项目下的终端操作都将在此隔离的会话中进行，有效避免了不同项目命令和进程的相互干扰。
它非常适合需要同时处理多个代码仓库或长期维护复杂项目的软件工程师、DevOps以及全栈开发者。对于习惯使用终端进行编码、构建、测试和部署，并希望借助AI助手来优化终端工作流效率的用户来说，这是一个非常实用的工具。
建议在使用前确保系统已安装tmux。由于它依赖于Pi Agent的上下文和项目路径，最佳实践是在进入项目根目录后调用相关命令。请注意，它管理的是Pi Agent进程内的终端会话，并非替代系统级的tmux客户端，因此更适合与Pi协同工作的场景。
核心特点
与同类终端管理工具或Skill不同，它深度集成于Pi Agent，实现了会话管理与AI工作流的绑定，能根据项目上下文自动关联和恢复会话，而非提供通用的、需要手动管理的tmux wrapper。
注意事项
不适合不依赖终端进行开发，或主要使用图形化IDE、非Pi Agent环境进行编码的用户。
常见问题
这个skill需要提前安装tmux吗？
是的，需要系统已安装tmux。
它能在非Pi Agent的普通终端里用吗？
不能，它是专为扩展Pi Agent功能设计的。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/romansix-pi-tmux/raw/index.md 读取 @romansix/pi-tmux 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/romansix-pi-tmux/raw/index.md（查看排版版本）