STATE
现在在哪里
一眼看到当前状态、健康度和下一步入口。
AI AGENT WORK RECORDER · OPEN SOURCE
你的 AI 代理不需要再填一份起飞计划。让它直接工作;flightwake 在关键时刻留下状态、决策和证据,让下一个会话安全接手。
01 / THE GAP
一次会话的推理会结束,仓库里的工作不会。真正昂贵的是下一个代理又要猜:做到哪里?哪里还没验证?为什么选这条路?
STATE
一眼看到当前状态、健康度和下一步入口。
RECORDS
每次有意义的收尾,留下变更和验证证据。
DECISIONS + TRAPS
舍弃其他方案的理由,以及实际遇到的陷阱。
记录跟随工作,不引导工作。
少一份要维护的计划,多一条可追溯的航迹。02 / ONE CONTINUOUS LOOP
新会话先读 STATE 和最近一条 record。没有证据,不把健康度猜成绿灯。
/fw-coldstart做了排除其他路径的决策,记录一行原因;遇到意外的陷阱,立刻写进 TRAPS。
DECISIONS + TRAPS重要工作结束时记录测试、风险与下一步;STATE 保持简短、真实。
/fw-recordClaude Code、Codex、Gemini CLI 读取同一份仓库航迹,不依赖某个聊天窗口的记忆。
git + Markdown03 / 0.16.0 / ACTUAL OUTPUT
0.16.0 将可选组件加入交互式安装,并为 Claude Code mod 0.2.0 加入费用和会话状态。下方是隔离测试仓库中的真实命令输出节选;终端外框由网站排版,临时路径已遮蔽。
The core (records, the four skills, the wrap-up hook) is always installed. Optional add-ons — * = recommended:
[*] 1) Bottom gauge in Claude Code (health / STATE lag / context usage)
[*] 2) Claude Code mod — inside Claude Code: a status row above the prompt, STATE loaded when a session starts, a log of this session's changes and test runs (/fw-log), a hint when you touch something a known trap mentions, and an optional role guard.
Needs Claude Code 2.1.287 or later. It loads in a Claude Code session started from the repo root, after you accept the folder trust prompt — a session that is already open needs a restart.
[ ] 3) Team roles (installs only the fw-roles skill; your agent recommends roles later, nothing applied yet)
Enter = the * ones · or type the numbers you want (e.g. 1 2) · 0 = none:setup 分别列出底部状态栏和 mod,标明推荐选项,并在确认前预览写入路径。
flightwake-mod v0.2.0
STATE at session start (stateInject): on — STATE is not initialized yet, so only a "run /fw-coldstart" note is injected
band above the prompt (band): on — hiding the fields the bottom gauge already shows; only the one-time 80% context toast remains
session flight log (recorder): on — this session: 0 file(s) by tools, 0 via shell (inferred), 0 test run(s), 0 commit(s) — /fw-log prints them
trap tripwire (tripwire): idle — no active TRAPS entry has paths or commands
role guard (roleGuard): off — opt-in
tokens and cost (spend): on — this session: tokens unknown · API-equivalent ≈ $0.00 — /fw-cost prints the breakdown
session fleet (fleet): on — this session is reported as idle in [isolated test sessions] (heartbeat 30 s; never prompt or command text)
Read-only: /fw-mod changes nothing.在 Claude Code 执行 /fw-mod,查看各功能状态与原因;启用底部状态栏时,mod 顶部横条会避免重复显示。
flightwake fleet — 2 live · ⛔ 1 blocked — [isolated test sessions] (last 7 days)
⛔ blocked demo-review demo-re… 21s permission · Bash
● working demo-build demo-bu… 14s Read src/app.tsFleet 将 blocked 会话排在前面;这是正式 CLI 对测试会话数据的实际输出。
setup 由测试驱动器输入答案并运行真实流程;/fw-mod 在 Claude Code 交互会话中执行;Fleet 由正式 CLI 读取测试夹具。画面经过节选与排版,临时路径已遮蔽,没有线上用户数据。部分权限对话框与异常中断后的恢复场景仍待真实会话验证。
04 / FIELD NOTES / ORCA × FLIGHTWAKE
这个项目本身就在使用 flightwake。Orca 让多个代理的讨论和审查留在可见的标签页;flightwake 把采纳的结论、测试和待验证事项写回仓库。
ORCA / 协作现场
多个代理并行检查 Fleet、安装流程和边界情况;负责人整合发现,并重新运行检查。
FLIGHTWAKE / 共同记忆
审查代理不会各自修改 STATE;负责人把采纳的结论写入 record,下一轮从同一处接手。
真实结果 / 2026.10
这轮记录了 46 个 smoke 检查和 465 个 mod 测试通过,也列明 Fleet 尚待真实会话验证的情况。
* Orca 是可选的协作工具;flightwake 不依赖 Orca。Fleet 已随 0.16.0 发布,部分真实会话场景仍待验证。
另一处现场 / 匿名产品团队
一个仓库承载产品决策,另一个承载工程实现。Orca 让代理在各自的工作标签页协作;flightwake 在两边留下现状、交接和验证边界。
产品代理整理目标和验收条件,批准有限范围的计划,再把实现任务交给工程角色。
技术代理检视实现边界和方案,让编码前的假设接受检验。
工程代理在产品仓库实现、运行本地测试和类型检查,并记录尚未冻结的改动。
审查和安全角色在实现冻结后独立检查;通过之前,状态仍是进行中。
2026.10 现场快照:实现进行中,独立审查尚未完成;不宣称产品已验收或上线。
05 / WHAT YOU GET
不用另设数据库。STATE、records、决策与陷阱都在仓库里。
Claude Code、Codex、Gemini CLI 各有原生 skill 和收尾 hook,读取同一份工作记录。
冷启动、决策、踩坑、收尾各有对应动作,不把日常工作变成表单。
交互式 setup 会列出语言、代理、可选组件与写入路径,再请你确认。
doctor 检查安装结构;STATE 的 health 如实标注已验证与待验证状态。
状态栏、Orca 指引、团队角色与 Claude Code mod 都是可选项。
06 / START HERE
需要 Git 和 Node.js 18 或更新版本。setup 会询问语言、使用的代理、可选组件与仓库类型,预览全部写入路径后再安装。
阅读完整安装文档 ↗$ cd your-repo
$ npx flightwake setup$ npx flightwake init --lang=zh-CN --agents=claude,codex,gemini安装后,在仓库中开启一个代理会话,运行对应的 coldstart skill;此后让事件驱动记录。
已经安装?运行 npx flightwake update;若要添加 Claude Code mod,使用 npx flightwake update --mod。
07 / FAQ
不会。它是工作记录框架:代理直接工作,在冷启动、决策、踩坑和收尾时保存足够让下一个会话接手的信息。
不必。flightwake 支持 Claude Code、Codex 和 Gemini CLI;Orca 协作与 Claude Code mod 都是可选项。
核心数据是仓库里的 Markdown,例如 .flightwake/STATE.md 与 records/。不需要 flightwake 云账号,也没有运行时包依赖。
可以。npm 已发布 0.16.0,包含交互式安装升级与可选的 Claude Code mod 0.2.0。部分 Fleet 真实会话场景仍待验证。
运行 npx flightwake update。它会保留现有选项和 .flightwake 用户数据;不会自动安装新的可选组件。