基于 Pi Extension API 构建的功能拓展集合，从 oh-my-pi、Claude Code、OpenCode 等优秀 coding agent 中提取核心功能特性，以独立 piex package 形式分发。
- 充分拓展，而非 fork：omp 选择 fork + 全量内置；PieX 只做官方扩展，100% 基于 pi Extension API，不碰内核，随 pi 升级而升级。
- 按需拓展，自由切换：扩展相互独立、即装即卸；克制可控，只为用到的能力付出 token。
- 知其所以然：取百家之长，借鉴主流 agent 的优秀设计，搞懂底层原理再以扩展引入；每个功能自己选择、自己理解、自己掌控。
- 评测优先：影响 agent 行为的扩展都有评测标准与数据支撑（见 评测方案）；无法度量效果，就不引入。
完整论述见 设计理念。
包名见下方 Package 总览（npm 包为 @piex-dev/<name>）。
curl -fsSL https://piex.dev/install.sh | bash # 全局安装
curl -fsSL https://piex.dev/install.sh | bash -s -- -l # 项目级安装仓库内开发可直接执行本地脚本：
bash docs/install.sh --dev # 从本地 packages/ 安装
bash docs/install.sh --dev -l # 项目级 + 本地路径pi install npm:@piex-dev/hashline在 piex 仓库根目录执行；其它包将 hashline 换成对应目录即可。
cd /path/to/piex
cd packages/hashline && npm install && cd ../.. # 仅 hashline 需先 npm install
pi install packages/hashline # 全局 settings
pi install -l packages/hashline # 项目 .pi/settings.jsonpi -e ./packages/hashline/extensions/hashline.ts主题包无 extensions/*.ts，请用 npm 或本地 pi install，见 theme-dark-terminal。
| Package | 工具 | 来源 | 行数 |
|---|---|---|---|
| hashline | 覆盖 edit（hashline 语法） |
oh-my-pi | 318 |
| dap | debug（14 个 adapter） |
oh-my-pi | 2154 |
| lsp | lsp（~50 server 默认；写后 ERROR；rename/code_actions） |
oh-my-pi + OpenCode | ~1850 |
| plan | /plan, /todos |
pi 示例 | 348 |
| review | /review, review 工具 |
oh-my-pi | 330 |
| init | /init（生成/改进 AGENTS.md） |
OpenCode | — |
| xai-oauth | /login xAI Grok OAuth 订阅登录（含实时模型发现） |
oh-my-pi / pi-grok | 949 |
| theme-dark-terminal | 暗终端高对比度主题 | opencode-themes | — |
| btw | /btw 临时提问（不污染上下文） |
oh-my-pi | 110 |
| context | /context 上下文用量报告 |
oh-my-pi | 160 |
各 package 详细文档见对应目录下的 README.md。
| 文档 | 说明 |
|---|---|
| 设计理念 | 背景动机、核心设计理念与架构模式 |
| 架构概览 | 项目结构、工具注册、API 映射 |
| 实施路线 | 已完成 & 待规划 |
| 评测方案 | 评测集选择、Docker 架构、指标设计、实施路径 |
| 测试指南 | package 快速测试与功能验证命令 |
| 参考资料 | pi 文档、来源项目索引 |
# 安装依赖（hashline 需要）
cd packages/hashline && npm install
# 查看已安装的 packages
pi list
# 移除 package（全局安装用绝对路径，项目级安装用 -l）
pi remove /abspath-to-piex/packages/hashline
pi remove -l ./packages/hashlineMIT