pi-firecode 1.0.0 → 1.0.1

package/README.md

@@ -1,60 +1,74 @@
-# FireCode
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Suge8/firecode/main/design/brand/logo-dark.svg">
+    <img alt="firecode" src="https://raw.githubusercontent.com/Suge8/firecode/main/design/brand/logo-light.svg" height="72">
+  </picture>
+</p>
 
-FireCode 是一个 Pi 扩展包：把会话状态嵌进输入框边框、把每轮过程折叠成一行摘要，并提供对抗审查、多子代理指挥与观察员。各功能独立开关，关掉任一个不影响其余。
+<h3 align="center">Install one extension. Uninstall the rest.</h3>
 
-```text
-─ ⣾⣿⣷ 处理中 1m3s · ⠹ 审查 第2轮 1/3 · 1 阻断 ──────────── 观察员 指挥官 ─
- 输入区
-─ 优化插件状态栏和工具展示 ───────────── gpt-6-astra/medium Fast · 42.3%/200k ─
-```
+<p align="center">Parallel sub-agents, multi-model code review and a cleaner terminal for <a href="https://pi.dev">Pi</a>. One install, works out of the box.</p>
 
-## 安装
+<p align="center">
+  <a href="https://www.npmjs.com/package/pi-firecode"><img alt="npm" src="https://img.shields.io/npm/v/pi-firecode?color=FF7A0F"></a>
+  <a href="https://github.com/Suge8/firecode/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/Suge8/firecode/actions/workflows/ci.yml/badge.svg"></a>
+  <a href="LICENSE"><img alt="MIT" src="https://img.shields.io/badge/license-MIT-blue"></a>
+  · <a href="README.zh-CN.md">中文</a>
+</p>
 
-```bash
-pi install npm:pi-firecode
-```
+<p align="center"><img alt="The commander dispatching three sub-agents in parallel" src="https://raw.githubusercontent.com/Suge8/firecode/main/design/promo/hero.gif" width="860"></p>
 
-需要 Pi 1.1.0 及以上，升级用 `pi update`。扩展拥有与 Pi 相同的本机权限，安装前请审阅源码。
+## Why FireCode
 
-## 配置
+- **Works out of the box.** The default config is the recommended one, in your language.
+- **Sub-agents under control.** Run them in parallel, pick a model per role, switch automatically on failure, step in any time.
+- **Hands-off review and delivery.** You don't babysit it. What reaches you has already passed review.
+- **An ultra-light core.** Built the Pi way: minimal, so your context stays lean.
+- **Low visual load.** Focus on the results that matter. Everything in between folds away until you open it.
 
-配置不随包生效。把推荐模板复制到 Pi Agent 目录，再重启 Pi：
+## Fully automatic review and delivery
 
-```bash
-agent_dir="${PI_CODING_AGENT_DIR:-$HOME/.pi/agent}"
-mkdir -p "$agent_dir/extensions/firecode"
-curl -fsSL https://unpkg.com/pi-firecode/config.example.jsonc -o "$agent_dir/extensions/firecode/config.jsonc"
-```
+Just tell the commander what you want. On important or hard tasks it starts an adversarial review on its own: any number of models you choose look for problems, every problem goes back to be fixed, and the fix is reviewed again until it passes. What reaches you is code that meets the bar and does what you asked. If it keeps getting stuck, an advisor model decides what to do next. You can also run `/fire-review` yourself at any time.
 
-- 模板里的模型一律写成 `"provider/model/thinking"`，换成你已登录的模型。
-- 审查、指挥官、观察员会真实调用配置里的模型；某一节配错时该功能拒绝启动并提示，不会改用默认模型。
-- 会额外花钱的：观察员每回合调用一次模型（模板里默认不自动开启）；OpenAI 加速档按供应商规则加价。
-- 没有配置文件时，可选功能全部关闭，并在会话启动时提示。
+<p align="center"><img alt="Round 1 fails, the agent fixes it, round 2 passes" src="https://raw.githubusercontent.com/Suge8/firecode/main/design/promo/review-loop.gif" width="760"></p>
 
-## 功能
+Other reviewers hand you a list of problems. FireCode hands you code that's fixed and re-reviewed:
 
-| 功能 | 入口 | 做什么 |
+| | Reviewers | What you get |
 | --- | --- | --- |
-| 输入框状态 | 自动 | 上边框显示进行状态、计时与审查进度，下边框显示会话标题、模型、思考档与上下文占用 |
-| 过程折叠 | 自动；点摘要或 `Ctrl+O` 展开 | 每次输入折成一轮：一行摘要（耗时、均速）、最近 3 条中间回复的首句、最终回复全文 |
-| 预设 | `/preset`、预设里配的快捷键 | 一键切换模型、思考档、工具集与附加指令 |
-| 对抗审查 | `/fire-review` | 多个模型并行审查改动；没过自动修复再审，连续失败请顾问模型裁决 |
-| 指挥官 | `/fire-master`（新会话默认开启） | 按角色表把工作派给子代理并行执行；输入框上方列出子代理，点一行看它的全过程并可直接补话 |
-| 观察员 | `/fire-watch` | 每回合结束后用便宜模型评估新增内容，跑偏或过度工程时插话 |
-| 用量 | `/quota`、`/tokens` | 查 Claude、Codex 订阅剩余额度；统计本地会话的 token 与成本 |
-| 会话名 | `/rename`、`Ctrl+R` | 改当前会话名 |
-| OpenAI 请求层 | `Ctrl+F` 切加速档 | 回答详略、加速档、可选的 OpenAI 原生上下文压缩 |
-| Claude 订阅适配 | 自动 | 请求带 Claude Code 归因；令牌换发导致的 401 自动重试一次 |
+| **FireCode** | Any number of models, reviewing adversarially | **Fixed code that passed re-review** |
+| Qwen Code `/review` | Up to 16 agents, one model | A findings list; `--fix` patches once, no re-review |
+| Open Code Review (Alibaba) | One model, file by file | A findings list to fix yourself |
+| PR-Agent / Qodo | Specialist agents, one model | Comments and suggestions |
+| multi-model-review (Pi) | Several model families | One combined verdict |
+
+## Clear sub-agent status
+
+Every sub-agent sits above the input box. Click one to read its whole run and talk to it directly.
 
-在配置的 `features` 里写 `false` 即可关闭对应功能，比如 `"features": { "watcher": false }`。
+<p align="center"><img alt="A sub-agent's full run with a follow-up typed into its own input box" src="https://raw.githubusercontent.com/Suge8/firecode/main/design/promo/shot-worker-view.png" width="720"></p>
 
-## 开发
+## An ultra-light core
 
-需要 [Bun](https://bun.sh/) 和一份 pi-mono 源码：开发版 `pi` 在 `PATH` 中时测试会自动定位它，否则把 `PI_PACKAGES_DIR` 设为 pi-mono 的 `packages/` 目录。
+Built the Pi way: sub-agents add just two small tools, and review and the watcher add none. Here is what sub-agent tools cost on every request (tool definitions sent to the model, measured October 2026):
+
+| | Sub-agent tools | Characters |
+| --- | --- | --- |
+| **FireCode** | 2 | **926** |
+| omp | 2 | 3,140 |
+| Codex CLI | 5–6 | 4,766–9,378 |
+| pi-subagents | 2–3 | 4,703–23,182 |
+
+## Also in the box
+
+`/fire-watch` a cheap model that speaks up only when work drifts · `/preset` switch model, thinking and tools in one go · `/quota` and `/tokens` usage at a glance · `Ctrl+R` rename the session · `Ctrl+Shift+S` OpenAI Fast mode · Works with Claude subscription login
+
+## Install
 
 ```bash
-bun test   # 测试
-pi -e .    # 在本地仓库直接试用
+pi install npm:pi-firecode
 ```
 
-模块边界、状态机约束与术语见 `AGENTS.md`、各模块的 `AGENTS.md` 与 `WORDS.md`。
+Restart Pi (1.1.0+) and it's ready; the config is created on first launch. Turn anything off with `"features": { "<name>": false }` in `~/.pi/agent/extensions/firecode/config.jsonc`.
+
+[Contributing](.github/CONTRIBUTING.md) · MIT © Suge8

package/README.zh-CN.md

@@ -0,0 +1,74 @@
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Suge8/firecode/main/design/brand/logo-dark.svg">
+    <img alt="firecode" src="https://raw.githubusercontent.com/Suge8/firecode/main/design/brand/logo-light.svg" height="72">
+  </picture>
+</p>
+
+<h3 align="center">装这一个，其余扩展都可以卸了。</h3>
+
+<p align="center">给 <a href="https://pi.dev">Pi</a> 加上并行子代理、多模型代码审查和更干净的终端界面。装一个就够，开箱即用。</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/pi-firecode"><img alt="npm" src="https://img.shields.io/npm/v/pi-firecode?color=FF7A0F"></a>
+  <a href="https://github.com/Suge8/firecode/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/Suge8/firecode/actions/workflows/ci.yml/badge.svg"></a>
+  <a href="LICENSE"><img alt="MIT" src="https://img.shields.io/badge/license-MIT-blue"></a>
+  · <a href="README.md">English</a>
+</p>
+
+<p align="center"><img alt="指挥官并行派出三个子代理" src="https://raw.githubusercontent.com/Suge8/firecode/main/design/promo/hero.zh.gif" width="860"></p>
+
+## 为什么用 FireCode
+
+- **开箱即用。** 默认配置就是推荐配置，支持多语言。
+- **子代理可控。** 并行跑，每个角色独立选模型，出故障自动切换，随时点开干预。
+- **审查交付全自动。** 不用盯着，交到你手里的就是审查通过的结果。
+- **核心极轻。** 完美契合 Pi 原生的极简思路，上下文保持极度轻量。
+- **视觉负担低。** 你只需要在乎真正重要的结果，中间过程全部折叠，想看再展开。
+
+## 全自动审查交付
+
+你只管告诉指挥官要做什么。遇到重要、难的任务，它会自动发起对抗审查：你配置的任意多个模型一起挑问题，挑出来就打回修复，修完再审，直到通过才交给你，交出来的是质量过关、满足需求的代码。反复卡住时，顾问模型会出来拿主意。想手动审，也可以随时执行 `/fire-review`。
+
+<p align="center"><img alt="第 1 轮没过，代理修复后第 2 轮通过" src="https://raw.githubusercontent.com/Suge8/firecode/main/design/promo/review-loop.zh.gif" width="760"></p>
+
+别的审查工具交给你一份问题清单，FireCode 交给你修好并复审通过的代码：
+
+| | 审查者 | 交到你手里的是 |
+| --- | --- | --- |
+| **FireCode** | 任意多个模型对抗审查 | **修好、复审通过的代码** |
+| Qwen Code `/review` | 最多 16 个代理，同一个模型 | 问题清单；`--fix` 修一次，不复审 |
+| Open Code Review（阿里） | 同一个模型，逐文件审 | 问题清单，要你自己修 |
+| PR-Agent / Qodo | 分工代理，同一个模型 | 评论和修改建议 |
+| multi-model-review（Pi） | 多家模型 | 一份汇总结论 |
+
+## 清晰的子代理状态
+
+每个子代理都列在输入框上方，点一下就能看它的完整过程，并直接跟它说话。
+
+<p align="center"><img alt="子代理的完整过程，在它自己的输入框里补一句话" src="https://raw.githubusercontent.com/Suge8/firecode/main/design/promo/shot-worker-view.zh.png" width="720"></p>
+
+## 核心极轻
+
+完美契合 Pi 原生的极简思路：子代理只加两个小工具，审查和观察员一个都不加。下表是子代理工具在每次请求里占的上下文（发给模型的工具定义字符数，2026 年 10 月实测）：
+
+| | 子代理工具数 | 字符数 |
+| --- | --- | --- |
+| **FireCode** | 2 | **926** |
+| omp | 2 | 3,140 |
+| Codex CLI | 5–6 | 4,766–9,378 |
+| pi-subagents | 2–3 | 4,703–23,182 |
+
+## 还有这些
+
+`/fire-watch` 便宜模型帮你盯着，跑偏才开口 · `/preset` 一键切换模型、思考档和工具 · `/quota`、`/tokens` 看用量 · `Ctrl+R` 改会话名 · `Ctrl+Shift+S` 开关 OpenAI 加速档 · 适配 Claude 订阅登录
+
+## 安装
+
+```bash
+pi install npm:pi-firecode
+```
+
+重启 Pi（1.1.0 及以上）就能用，配置文件首次启动时自动生成。不想要哪个功能，在 `~/.pi/agent/extensions/firecode/config.jsonc` 里写 `"features": { "<名字>": false }` 关掉。
+
+[参与开发](.github/CONTRIBUTING.md) · MIT © Suge8

package/config.example.jsonc

@@ -1,13 +1,14 @@
 {
-	// 公开推荐配置：功能全开。复制后重启 Pi。
-	// Watcher 新会话不自动激活，需要时 /fire-watch 翻转当前会话。
-	// 凡是指定模型的位置都写同一个模型原子："provider/model/thinking"，思考档取最后一段。
+	// Recommended config: every feature on. It is written here on first launch; swap in the models you are logged in to, then restart Pi.
+	// The watcher does not activate itself in a new session; run /fire-watch to toggle it for the current session.
+	// Everywhere a model is named, use the same model atom: "provider/model/thinking" (the last segment is the thinking level).
+	// Language of the UI and of the text shown to models: follows the system locale by default (zh* → Chinese, otherwise English); uncomment the next line to pin it, "zh" | "en".
+	// "language": "en",
 	"features": {
 		"header": true,
 		"statusbar": true,
 		"tools": true,
 		"presets": true,
-		"rename": true,
 		"stats": true,
 		"claudeSub": true,
 		"openaiNative": true,
@@ -17,11 +18,10 @@
 	},
 
 	"keys": {
-		"rename": "ctrl+r",
-		"fast": "ctrl+f"
+		"fast": "ctrl+shift+s"
 	},
 
-	// nativeCompaction 使用 OpenAI 原生上下文压缩；priority 加钱换更快出字，默认关。
+	// nativeCompaction uses OpenAI's native context compaction; priority pays more for faster output and is off by default.
 	"openai": {
 		"nativeCompaction": true,
 		"providers": {
@@ -29,34 +29,34 @@
 		}
 	},
 
-	// 新会话默认激活指挥官。
+	// New sessions activate the Master by default. Role names are yours to choose; the Master picks a role by its "use".
 	"master": {
 		"autoActivate": true,
 		"workerExcludeExtensions": [],
 		"roles": {
-			"调研员": {
+			"researcher": {
 				"model": "anthropic/claude-haiku-5-5/low",
-				"use": "只读不改：联网搜索、查文档与版本、读日志、按线索定位代码与核对资料",
+				"use": "Read-only: web search, docs and version lookups, reading logs, locating code from leads, checking references",
 				"fallback": ["openai-codex/gpt-6-luna/medium"]
 			},
-			"工程师": {
+			"engineer": {
 				"model": "anthropic/claude-sonnet-5-5/high",
-				"use": "要改代码：实现、调试；需要深读代码找缺陷的审计也派它（只读）",
+				"use": "Changes code: implementation, debugging; also for audits that need deep code reading to find defects (read-only)",
 				"fallback": ["openai-codex/gpt-6.1-sol/high"]
 			},
-			"批量工": {
+			"batch": {
 				"model": "anthropic/claude-haiku-5-5/medium",
-				"use": "规格明确、靠测试或类型检查就能验收的批量改动：按模式迁移、改名、补样板；量大时按文件划界并行多派",
+				"use": "Well-specified bulk changes that tests or type checks can verify: pattern migrations, renames, boilerplate; for large volumes split by file and run several in parallel",
 				"fallback": ["openai-codex/gpt-6.1-sol/medium"]
 			},
-			"设计师": {
+			"designer": {
 				"model": "anthropic/claude-opus-5-5/medium",
-				"use": "视觉、前端",
+				"use": "Visual and frontend work",
 				"fallback": ["openai-codex/gpt-6.1-sol/high"]
 			},
-			"哨兵": {
+			"sentinel": {
 				"model": "anthropic/claude-haiku-5-5/low",
-				"use": "CI、部署、长测试等待",
+				"use": "Waiting on CI, deployments and long tests",
 				"fallback": ["anthropic/claude-sonnet-5-5/low"]
 			}
 		}
@@ -71,18 +71,17 @@
 		"ds": { "model": "deepseek/deepseek-flash/high", "key": "alt+6" }
 	},
 
-	// 审查只在用户或指挥官发起时调用模型。
+	// Review only calls models when the user or the Master starts it.
 	"review": {
 		"advisor": "anthropic/claude-fable-5-1/high",
 		"reviewers": ["anthropic/claude-opus-5-5/low", "openai-codex/gpt-6.1-sol/low"],
 		"maxRounds": 5,
 		"advisorAfterFailures": 2,
 		"timeoutMinutes": 40,
-		"tools": ["read", "grep", "find", "ls", "bash"],
-		"language": "zh"
+		"tools": ["read", "grep", "find", "ls", "bash"]
 	},
 
-	// 激活后每个主会话回合评估新增内容，会产生额外模型调用；需要开口时当场插话。
+	// Once active, it evaluates what each main-session turn added, which costs extra model calls; it speaks up on the spot when needed.
 	"watcher": {
 		"enabled": false,
 		"model": "openai-codex/gpt-6.1-sol/medium",

package/dist/config.example.jsonc

@@ -0,0 +1,90 @@
+{
+	// Recommended config: every feature on. It is written here on first launch; swap in the models you are logged in to, then restart Pi.
+	// The watcher does not activate itself in a new session; run /fire-watch to toggle it for the current session.
+	// Everywhere a model is named, use the same model atom: "provider/model/thinking" (the last segment is the thinking level).
+	// Language of the UI and of the text shown to models: follows the system locale by default (zh* → Chinese, otherwise English); uncomment the next line to pin it, "zh" | "en".
+	// "language": "en",
+	"features": {
+		"header": true,
+		"statusbar": true,
+		"tools": true,
+		"presets": true,
+		"stats": true,
+		"claudeSub": true,
+		"openaiNative": true,
+		"review": true,
+		"master": true,
+		"watcher": true
+	},
+
+	"keys": {
+		"fast": "ctrl+shift+s"
+	},
+
+	// nativeCompaction uses OpenAI's native context compaction; priority pays more for faster output and is off by default.
+	"openai": {
+		"nativeCompaction": true,
+		"providers": {
+			"openai-codex": { "textVerbosity": "low", "priority": false }
+		}
+	},
+
+	// New sessions activate the Master by default. Role names are yours to choose; the Master picks a role by its "use".
+	"master": {
+		"autoActivate": true,
+		"workerExcludeExtensions": [],
+		"roles": {
+			"researcher": {
+				"model": "anthropic/claude-haiku-5-5/low",
+				"use": "Read-only: web search, docs and version lookups, reading logs, locating code from leads, checking references",
+				"fallback": ["openai-codex/gpt-6-luna/medium"]
+			},
+			"engineer": {
+				"model": "anthropic/claude-sonnet-5-5/high",
+				"use": "Changes code: implementation, debugging; also for audits that need deep code reading to find defects (read-only)",
+				"fallback": ["openai-codex/gpt-6.1-sol/high"]
+			},
+			"batch": {
+				"model": "anthropic/claude-haiku-5-5/medium",
+				"use": "Well-specified bulk changes that tests or type checks can verify: pattern migrations, renames, boilerplate; for large volumes split by file and run several in parallel",
+				"fallback": ["openai-codex/gpt-6.1-sol/medium"]
+			},
+			"designer": {
+				"model": "anthropic/claude-opus-5-5/medium",
+				"use": "Visual and frontend work",
+				"fallback": ["openai-codex/gpt-6.1-sol/high"]
+			},
+			"sentinel": {
+				"model": "anthropic/claude-haiku-5-5/low",
+				"use": "Waiting on CI, deployments and long tests",
+				"fallback": ["anthropic/claude-sonnet-5-5/low"]
+			}
+		}
+	},
+
+	"presets": {
+		"sonnet": { "model": "anthropic/claude-sonnet-5-5/high", "key": "alt+1" },
+		"opus": { "model": "anthropic/claude-opus-5-5/high", "key": "alt+2" },
+		"fable": { "model": "anthropic/claude-fable-5-1/medium", "key": "alt+3" },
+		"astra": { "model": "openai-codex/gpt-6-astra/medium", "key": "alt+4" },
+		"sol": { "model": "openai-codex/gpt-6.1-sol/medium", "key": "alt+5" },
+		"ds": { "model": "deepseek/deepseek-flash/high", "key": "alt+6" }
+	},
+
+	// Review only calls models when the user or the Master starts it.
+	"review": {
+		"advisor": "anthropic/claude-fable-5-1/high",
+		"reviewers": ["anthropic/claude-opus-5-5/low", "openai-codex/gpt-6.1-sol/low"],
+		"maxRounds": 5,
+		"advisorAfterFailures": 2,
+		"timeoutMinutes": 40,
+		"tools": ["read", "grep", "find", "ls", "bash"]
+	},
+
+	// Once active, it evaluates what each main-session turn added, which costs extra model calls; it speaks up on the spot when needed.
+	"watcher": {
+		"enabled": false,
+		"model": "openai-codex/gpt-6.1-sol/medium",
+		"context": "minimal"
+	}
+}