AI AGENT WORK RECORDER · OPEN SOURCE

工作向前走。
航迹留下来。

你的 AI 代理不需要再填一份起飞计划。让它直接工作;flightwake 在关键时刻留下状态、决策和证据,让下一个会话安全接手。

npm 已发布 0.16.0新版 setup · Claude Code mod 0.2.0

01 / THE GAP

模型有上下文限制。项目没有。

一次会话的推理会结束,仓库里的工作不会。真正昂贵的是下一个代理又要猜:做到哪里?哪里还没验证?为什么选这条路?

STATE

现在在哪里

一眼看到当前状态、健康度和下一步入口。

RECORDS

做过什么

每次有意义的收尾,留下变更和验证证据。

DECISIONS + TRAPS

为什么,以及哪里容易踩坑

舍弃其他方案的理由,以及实际遇到的陷阱。

记录跟随工作,不引导工作。

少一份要维护的计划,多一条可追溯的航迹。

02 / ONE CONTINUOUS LOOP

你只需说“开始”。其余由事件触发。

01 / 冷启动

读状态,安全接手

新会话先读 STATE 和最近一条 record。没有证据,不把健康度猜成绿灯。

/fw-coldstart
02 / 工作中

做事,顺手留痕

做了排除其他路径的决策,记录一行原因;遇到意外的陷阱,立刻写进 TRAPS。

DECISIONS + TRAPS
03 / 收尾

把证据交给下一位

重要工作结束时记录测试、风险与下一步;STATE 保持简短、真实。

/fw-record
04 / 再出发

换模型也能接上

Claude Code、Codex、Gemini CLI 读取同一份仓库航迹,不依赖某个聊天窗口的记忆。

git + Markdown
START
CONTINUE ↗

03 / 0.16.0 / ACTUAL OUTPUT

打开 Claude Code,实际会看到什么?

0.16.0 将可选组件加入交互式安装,并为 Claude Code mod 0.2.0 加入费用和会话状态。下方是隔离测试仓库中的真实命令输出节选;终端外框由网站排版,临时路径已遮蔽。

FLIGHTWAKE · FIELD CAPTURE01 / 03
npx flightwake setup
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:
01 / SETUP

安装前看清楚

setup 分别列出底部状态栏和 mod,标明推荐选项,并在确认前预览写入路径。

FLIGHTWAKE · FIELD CAPTURE02 / 03
/fw-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.
02 / CLAUDE CODE

七个功能,一眼看到状态

在 Claude Code 执行 /fw-mod,查看各功能状态与原因;启用底部状态栏时,mod 顶部横条会避免重复显示。

FLIGHTWAKE · FIELD CAPTURE03 / 03
npx flightwake fleet --lang=en
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.ts
03 / FLEET

哪个会话在等你

Fleet 将 blocked 会话排在前面;这是正式 CLI 对测试会话数据的实际输出。

setup 由测试驱动器输入答案并运行真实流程;/fw-mod 在 Claude Code 交互会话中执行;Fleet 由正式 CLI 读取测试夹具。画面经过节选与排版,临时路径已遮蔽,没有线上用户数据。部分权限对话框与异常中断后的恢复场景仍待真实会话验证。

04 / FIELD NOTES / ORCA × FLIGHTWAKE

多个代理真正协作时,谁记得全貌?

这个项目本身就在使用 flightwake。Orca 让多个代理的讨论和审查留在可见的标签页;flightwake 把采纳的结论、测试和待验证事项写回仓库。

CASE STUDY · FLIGHTWAKE REPOSITORY 2026.10
01

并行分工与审查

多个代理并行检查 Fleet、安装流程和边界情况;负责人整合发现,并重新运行检查。

02

一位记录者,一份事实

审查代理不会各自修改 STATE;负责人把采纳的结论写入 record,下一轮从同一处接手。

03

有验证,也有待办

这轮记录了 46 个 smoke 检查和 465 个 mod 测试通过,也列明 Fleet 尚待真实会话验证的情况。

阅读这次真实工作记录 ↗ORCA × FLIGHTWAKE

* Orca 是可选的协作工具;flightwake 不依赖 Orca。Fleet 已随 0.16.0 发布,部分真实会话场景仍待验证。

另一处现场 / 匿名产品团队

两个仓库,四种角色,一条可追溯的工作线。

一个仓库承载产品决策,另一个承载工程实现。Orca 让代理在各自的工作标签页协作;flightwake 在两边留下现状、交接和验证边界。

01 / 产品负责人

定义与派工

产品代理整理目标和验收条件,批准有限范围的计划,再把实现任务交给工程角色。

02 / 技术负责人

检查风险

技术代理检视实现边界和方案,让编码前的假设接受检验。

03 / 工程实现

编码与自测

工程代理在产品仓库实现、运行本地测试和类型检查,并记录尚未冻结的改动。

04 / 独立审查

验证后才算完成

审查和安全角色在实现冻结后独立检查;通过之前,状态仍是进行中。

2026.10 现场快照:实现进行中,独立审查尚未完成;不宣称产品已验收或上线。

05 / WHAT YOU GET

足够轻,才能一直用。

01

纯 Markdown,跟随 git

不用另设数据库。STATE、records、决策与陷阱都在仓库里。

02

三种编码代理

Claude Code、Codex、Gemini CLI 各有原生 skill 和收尾 hook,读取同一份工作记录。

03

由事件触发的纪律

冷启动、决策、踩坑、收尾各有对应动作,不把日常工作变成表单。

04

看清楚再安装

交互式 setup 会列出语言、代理、可选组件与写入路径,再请你确认。

05

只读健康检查

doctor 检查安装结构;STATE 的 health 如实标注已验证与待验证状态。

06

按需添加协作能力

状态栏、Orca 指引、团队角色与 Claude Code mod 都是可选项。

06 / START HERE

在你的仓库中,回答几个问题即可安装。

需要 Git 和 Node.js 18 或更新版本。setup 会询问语言、使用的代理、可选组件与仓库类型,预览全部写入路径后再安装。

阅读完整安装文档 ↗
01 / 交互式安装
$ cd your-repo
$ npx flightwake setup
02 / 自动化 / 非交互
$ 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 会替我规划工作吗?

不会。它是工作记录框架:代理直接工作,在冷启动、决策、踩坑和收尾时保存足够让下一个会话接手的信息。

必须使用 Orca 或 Claude Code 吗?

不必。flightwake 支持 Claude Code、Codex 和 Gemini CLI;Orca 协作与 Claude Code mod 都是可选项。

数据存在哪里?需要云服务吗?

核心数据是仓库里的 Markdown,例如 .flightwake/STATE.md 与 records/。不需要 flightwake 云账号,也没有运行时包依赖。

现在可以安装 0.16.0 吗?

可以。npm 已发布 0.16.0,包含交互式安装升级与可选的 Claude Code mod 0.2.0。部分 Fleet 真实会话场景仍待验证。

已经安装的仓库如何升级?

运行 npx flightwake update。它会保留现有选项和 .flightwake 用户数据;不会自动安装新的可选组件。