FireCode

FireCode 是一个模块化 Pi Package，提供终端状态与工具渲染、会话预设、/fire-review 对抗审查、/fire-master 进程内子代理委派和 /fire-watch 观察员。指挥官与观察员的新会话状态由配置决定，裸命令只翻转当前会话；各模块由功能开关独立注册，关闭任一模块不会改变其余模块。

安装

pi install git:github.com/Suge8/[email protected]

也可在本地仓库中直接试用：

pi -e .

Pi Package 拥有与 Pi 相同的本机权限；安装前应审阅源码。

配置

运行配置不随包分发。将公开模板复制到 Pi Agent 目录后按需启用功能，再重启 Pi：

agent_dir="${PI_CODING_AGENT_DIR:-$HOME/.pi/agent}"
mkdir -p "$agent_dir/extensions/firecode"
curl -fsSL https://raw.githubusercontent.com/Suge8/firecode/v0.6.1/config.example.jsonc \
  -o "$agent_dir/extensions/firecode/config.jsonc"

公开模板提供维护者当前的完整推荐配置：除 Bark 外功能全开，Master 与 Watcher 在新会话自动激活。Watcher 会在每个主会话回合后调用模型，OpenAI priority 会按供应商规则加价；复制前应确认列出的模型均已认证并接受额外费用。审查与观察员的模型必须显式写入运行配置，否则对应功能拒绝启动。缺少运行配置时，FireCode 会关闭可选功能并在会话启动时警告；配置模板本身不会被运行时读取。

开发

需要 Bun 和一个 pi-mono checkout。开发版 pi 在 PATH 中时，测试会自动定位它；否则设置 PI_PACKAGES_DIR 为 pi-mono 的 packages/ 目录。

bun test

模块边界、状态机约束和领域术语见 AGENTS.md、各模块的 AGENTS.md 与 CONTEXT.md。