@vanillagreen/pi-agents-tmux

Pi AI 的 tmux 代理管理扩展,实现任务委派与持久化会话。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:@vanillagreen/pi-agents-tmux。
它的用途是:Pi AI 的 tmux 代理管理扩展,实现任务委派与持久化会话。
完整的 Skill 内容见:https://321skill.com/skills/vanillagreen-pi-agents-tmux/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

‘为我的数据清洗项目启动一个名为 data-cleaner 的持久化代理。’,它会创建一个新的 tmux 会话并启动代理。之后你可以随时断开,下次

对AI说:‘连接到 data-cleaner 代理。’,它就会重新附加到那个会话,让你继续之前的工作。

介绍

这个 Skill 解决了在 Pi AI 环境中高效管理和委派任务给不同代理(如项目代理或用户代理)的难题。它通过集成 tmux,允许用户创建持久化的会话窗格,即使关闭终端或断开连接,代理的工作状态也能得以保留,从而避免了重复初始化环境或丢失上下文。

使用方式非常直接。在 Pi AI 中安装并启用此 Skill 后,你可以通过简单的指令创建、列出、附加到或销毁特定的 tmux 代理会话。例如,你可以为不同的项目启动独立的代理,每个代理都在自己的 tmux 窗格中运行,互不干扰,并能随时切换。

它非常适合需要长时间运行多个 AI 代理任务的项目负责人、开发者和研究人员。无论是进行需要多步交互的复杂代码调试、持续的数据分析流水线,还是管理多个并行的文档生成任务,这个 Skill 都能提供稳定的会话支持。

使用建议是,为每个独立的长期任务创建一个专门的代理会话,并为其命名以便管理。需要注意的是,虽然 tmux 会话是持久的,但请确保服务器或主机本身是稳定运行的,以避免因系统重启等外部因素导致会话丢失。同时,合理管理会话数量,避免资源耗尽。

核心特点

核心区别在于将 AI 代理任务与 tmux 的持久化会话深度绑定,实现了代理状态的离线保存和随时恢复,而同类 Skill 通常只提供临时的、单次性的代理调用。

注意事项

不适合需要即时、一次性快速响应的简单问答或命令执行场景。

常见问题

如何恢复一个之前创建的代理会话?

使用 Skill 提供的命令(如附加会话)并指定会话名称即可恢复。

这个 Skill 和直接使用 tmux 有什么区别?

它封装了 tmux 操作,专门为在 Pi AI 中管理 AI 代理而设计,提供了更贴合 AI 工作流的命令接口。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/vanillagreen-pi-agents-tmux/raw/index.md 读取 @vanillagreen/pi-agents-tmux 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。