$ cat ~/map/pi-kit.md

pi-kit

社区维护的 pi 编码代理扩展合集，覆盖守护类、工作流与第三方集成。

extensions✓ 10月16日

pi install git:github.com/butttons/pi-kit

## 速览

个人 pi 工具箱——扩展、技能与一套主题：safe-delete 拦截破坏性 bash，/fold 把历史折叠成摘要，另有计划模式、会话回溯与多个 provider 集成，可整体安装也可按需挑选。

## 要点

• $只保留 pi 专属内容：与 harness 无关的通用技能（git 工作流、obi、playwright-cli、dora、exe-dev 等）放在单独的 agents.dotfiles 仓库，由各 harness 直接加载。
• $在 ~/.pi/agent/settings.json（或项目级 .pi/settings.json）的 git 包源下列出 extensions、skills、themes 即可按需挑选——省略某键表示加载该类型全部，[] 表示不加载，!pattern 表示排除；pi config 可在 TUI 里逐项开关。
• $安全护栏：safe-delete 拦截破坏性 bash（对受保护或大路径的 rm、find -delete、递归 chmod/chown、git clean -fdx、dd 写设备、通配符爆炸等），safe-commit 在 git 提交前弹出确认。
• $上下文管理：/fold 把会话历史折叠为携带简要摘要的哨兵标记，配 search_folded 与 get_folded_message 检索；context-usage 是感知折叠的页脚，显示缓存命中、成本与上下文条；thinking-stash 用 /rethink 把捕获的思考 token 注回下一轮；lazy-agents 按需加载 AGENTS.md。
• $工作流工具：plan-mode（/plan 只读探索加步骤提取，Ctrl+Alt+P 切换）、handoff、session-recall（/recall 用 TOON 格式索引搜索过往会话）、shell-preprocessor 和注入子代理状态的 agent-watch。
• $集成类注册 provider 与搜索：dora 生命周期钩子、走 EXA_API_KEY 的 exa-search、opencode-usage（/usage）、command-code 和 poolside。
• $附带基于 Catppuccin Mocha 的 butttons 主题，以及 pi-costs（会话成本与 token 分析）、herdr-pi-subagents 等 pi 专属技能。

## 常见问题

## 参考链接

• README ↗

最后更新: 2026年8月31日