如何用好 pi coding agent？awesome-pi-agent 五大类 50+ 资源清单与完整概览

• 文档
• AI Agent
• 网页爬虫

awesome-pi-agent 是一个专为pi coding agent（pi-mono 官方编码智能体）打造的社区精选资源清单（Awesome List），收录了 50+ 个经过筛选的扩展（Extensions）、技能（Skills）、工具、提示模板与主题，并附带 Discord 社区资源自动抓取工具，帮你一站式找到提升 pi agent 效率的组件。无论你是刚接触 pi coding agent 的新手，还是想扩展已有工作流的老用户，这份清单都能成为你的"工具箱地图"。

🧭 快速上手：awesome-pi-agent 是什么？

一句话概括：awesome-pi-agent = pi coding agent 的"插件商店目录"。

它本身不是一个工具，而是一份持续维护的资源清单，解决的核心问题是——pi agent 装什么、去哪找、值不值得用。每个条目都要求：

• 项目近一年内活跃维护
• 有文档/README
• 一行描述 + 链接，按字母序排列

主要项目是官方仓库pi (pi-mono)，本清单围绕它生态中的第三方组件整理而成。

🚀 一键获取资源清单

仓库是只读清单，直接浏览即可使用，无需安装：

git clone https://gitcode.com/gh_mirrors/aw/awesome-pi-agent

克隆后打开核心文件 README.md，即可看到按类别组织的完整清单。想追踪最新收录记录，可以查看 CHANGELOG.md，每次更新都注明了新增项目及其验证情况。

📋 五大核心资源类别速览

清单将资源分为五大类，先给你一张总览表，方便按需取用：

1️⃣ Extensions：pi coding agent 扩展，最能改变体验的一类

扩展是清单中数量最多、实用性最强的类别，按功能可以分为几个方向：

• 安全与权限：security拦截危险 bash 命令、filter-output在 LLM 看到前脱敏 API 密钥，permission提供四级权限控制，toolwatch用 SQLite 记录并审计每次工具调用
• 会话管理：checkpoint/pi-rewind-hook基于 Git 做检查点，对话分叉时可回滚代码状态；handoff把上下文转移到新的专注会话
• 成本控制：cost-tracker、usage-bar、pi-cost-dashboard从会话日志分析 API 花费，帮你掌握 token 消耗
• 远程开发：pi-ssh-remote把所有文件操作和命令重定向到远程主机，等于把 pi agent 装到服务器上
• 通知与状态：pi-notify系列在 agent 完成并等待输入时推送桌面/Telegram 通知；pi-powerline-footer提供带 Git 感知的状态栏
• GUI 与可视化：pi-gui提供图形界面，pi-canvas用原生 TUI 内联渲染日历、文档等画布

2️⃣ Skills：用自然语言教 agent 完成复杂任务

Skills 采用 SKILL.md 格式，用自然语言描述可复用工作流。社区合集pi-skills中收录了多个开箱即用的方向：

• 信息获取：brave-search网页搜索、youtube-transcript抓取 YouTube 字幕
• 浏览器自动化：browser-tools通过 Chrome DevTools Protocol 实现交互式浏览器操作
• Google 全家桶：gccli（日历）、gdcli（网盘）、gmcli（邮件）三个 CLI 技能
• 音频转写：transcribe通过 Groq Whisper API 实现语音转文字

相比自己写提示词，Skills 让同样的复杂任务每次都能稳定复现。

3️⃣ Tools & Utilities：沙箱、进程管理与多端支持

这一类解决的是"pi agent 在什么环境里跑"的问题：

• 隔离沙箱：nono提供内核级能力沙箱（Linux 用 Landlock、macOS 用 Seatbelt），从操作系统层面拦截危险命令；gondolin、lima提供 Linux 微虚拟机环境
• 并行处理：PiSwarm利用 Git worktrees 并行处理 GitHub issue 和 PR；task-factory提供队列式任务编排与 Web UI
• 跨端使用：agent-desktop是原生 UI 桌面应用，pi-mobile是支持 Tailscale 会话的 Android 客户端
• 用量追踪：CodexBar是 macOS 菜单栏应用，跟踪 AI 编码工具的会话与周限额

4️⃣ Prompt Templates 与 5️⃣ Themes：小而美

• Prompt Templates（原称 slash commands）：创建带参数的可复用提示快捷方式，目前社区模板仍在征集阶段，是最容易贡献的方向
• Themes：如pi-rose-pine提供 Rose Pine 系列（main/moon/dawn 三种变体）终端配色

此外清单还有Providers & Integrations（模型供应商接入，如pi-synthetic开源模型接入）和Examples & Recipes（dotfiles、Nix 配置等实战示例）两个辅助板块，可一并浏览。

💡 新手使用建议：三步用好这份清单

1. 先解决安全感：从安全类扩展入手（security、permission、safe-git），再考虑效率类组件
2. 按需而非全装：清单 50+ 资源并非都要用，建议只装 3~5 个高频场景组件——成本追踪 + 一个通知 + 一个安全类，通常就够
3. 关注官方文档：README 中的 Official Documentation 板块深链到 pi-mono 官方仓库的扩展指南、主题指南与迁移指南，动手前先看一眼统一扩展 API

🛠️ 清单如何保鲜？自动化抓取 + 链接校验

这份清单的"长尾内容"能持续更新，靠的是仓库内置的自动化机制，值得其他资源列表借鉴：

• Discord 抓取工具：位于 discord_scraping/ 目录，基于 Puppeteer 扫描 Discord 服务器（含论坛帖），自动提取 GitHub 链接并与清单对比，输出"新发现但未收录"的仓库。运行入口为 discord_scraping/run.sh，核心逻辑在 discord_scraping/scraper.js，详细配置见 discord_scraping/README.md
• 链接校验 CI：通过 mlc_config.json 配置链接检查器，所有条目 URL 定期校验，失效项目会被移除（CHANGELOG 中可见一次移除 404 仓库的记录）
• 更新协议：AGENTS.md 定义了完整的"抓取 → 审核 → 更新 → PR"流程，保证每次变更可审计

✍️ 如何向 awesome-pi-agent 贡献资源

想把自己做的 pi agent 组件收录进清单？遵循 CONTRIBUTING.md 的规范即可：

1. Fork 仓库并创建特性分支（禁止直接提交 main）
2. 在对应类别下添加一行条目：简短描述 + 链接，按字母序插入
3. 提交 Pull Request 并请求 review

项目基于 MIT 协议开源，见 LICENSE。

总结

awesome-pi-agent 把 pi coding agent 生态中最有价值的 50+ 组件整理成五大类清单，配合 Discord 自动抓取与 CI 链接校验，保证内容新鲜可用。对新手来说，它是上手 pi 扩展生态的最佳入口；对老用户来说，是发现新工具的最短路径。打开 README.md 挑一个最痛的点开始，就是最好的第一步 🚀

• 文档
• AI Agent
• 网页爬虫