@0xkahi/pi-arsenal

Pi多工具扩展,非阻塞tmux弹出编辑器

安装使用

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

帮我安装这个 AI Skill:@0xkahi/pi-arsenal。
它的用途是:Pi多工具扩展,非阻塞tmux弹出编辑器
完整的 Skill 内容见:https://321skill.com/skills/0xkahi-pi-arsenal/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

'帮我用nvim打开项目根目录下的config.json,我需要修改数据库连接参数',Pi会调用tmux_popup工具在弹出窗口中打开该文件,同时继续执行其他任务,编辑完成后关闭窗口即可。

介绍

这个Skill解决了在Pi(AI编码代理)会话中需要编辑文件却不得不中断当前任务的问题。实际开发中,AI代理经常需要打开配置文件、日志或代码进行修改,但传统终端编辑会阻塞代理的执行流程,导致等待或上下文丢失。

使用方式很简单,你只需要安装扩展并启用tmux_popup工具。之后就可以通过自然语言指令让Pi打开指定文件,例如“用nvim打开配置文件”。Pi会在tmux中创建一个非阻塞的弹出窗口,编辑器独立运行,代理可以继续执行其他任务,编辑完成后关闭弹出窗口即可。

它非常适合已经使用tmux进行多窗口管理的开发者和AI代理用户。尤其是那些需要将Pi作为主力编码助手,同时又希望保留手动编辑能力的团队或个人。

建议在配置时先确保$TMUX环境变量已设置,且tmux命令在PATH中。注意fileCommand支持自定义编辑器(如code --wait),但务必使用可信的配置,因为该命令会作为shell前缀执行。

常见问题

如何配置tmux_popup工具?

在`<agent-dir>/extensions/pi-arsenal/config.json`中设置`tmux_popup.enabled: true`,并可自定义宽度/高度/编辑器命令。

tmux_popup支持哪些编辑器?

默认使用`nvim`,可通过`fileCommand`配置任意编辑器,如`code --wait`、`vim`等,但需确保该命令在PATH中。

给 AI 助手的安装指引

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

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