用途：作为 Pi（@earendil-works/pi-coding-agent，由 Earendil Inc. 维护，MIT 许可）的权威参考，镜像官方文档 https://pi.dev/docs/latest，并可回答 Pi 相关问题、构建自定义扩展，而无需重复抓取文档。Pi 是极简终端编码工具：内核轻量，通过 TypeScript 自定义扩展。
主要能力：涵盖安装、认证与启动，CLI 标志与斜杠命令；提供方、API 密钥、自定义模型（models.json）与代理配置；settings.json、键位、主题、会话与压缩；项目信任安全模型与容器/沙箱运行；扩展、技能、提示模板、包、自定义提供方、TUI；版本历史；通过 SDK、RPC 模式或 JSON 事件流编程驱动；Windows/Termux/tmux 与源码构建；设计理念（极简内核、4 个工具、默认 YOLO，MCP 自 2026-09-29 起内置）；monorepo 内部架构（Chord 类型化宿主运行时、持久化 harness、agent core、telemetry）。
使用方式：按需加载 references/ 下的文件（如 cli-and-usage.md、providers-and-models.md、settings-and-compaction.md、extending-pi.md、mcp.md、codemode.md、tui-components.md、security-and-containerization.md、session-format.md、programmatic.md、platform-setup.md、development.md、philosophy-and-design.md、chord.md、durable.md、agent-harness.md、durable-spec.md、changelog.md）。常用命令保持原样：curl -fsSL https://pi.dev/install.sh | sh；npm install -g --ignore-scripts @earendil-works/pi-coding-agent；pi update；pi list；pi install npm:pi-subagents、npm:pi-lens、npm:pi-web-access；pi -p、@README.md 附加文件、pi --mode json、pi --mode rpc 等。
适用场景与限制：适合查询、定制和内部机制理解。硬性规则：扩展以完整系统权限运行，应视为可信代码；项目信任仅是输入加载守卫，非沙箱，Pi 无内置沙箱；MCP 自 2026-09-29 内置，项目文件仅在信任后读取；auth.json 保存密钥，权限 0600，需保密。chord.md、durable.md、agent-harness.md、durable-spec.md 描述内部实现，非稳定契约；Pi Durable 为实验性，每个版本有破坏性变更，2026-10-01 博客示例已在 1.2.0 删除。技能名称 1–64 字符、小写，描述 ≤1024 字符且须说明加载时机。无法从资料确认的收费、价格、效果等信息暂未提供。