Skip to content

About

Local-first time ledger for AI coding agents (Claude Code, Codex, OpenCode, Pi, Antigravity). Splits pure work vs review wait — zero telemetry.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

AgentTime logo

AgentTime

给 AI Coding Agent 记一本时间账。

Test npm License: MIT Node

简体中文 · English


60 秒看懂 AgentTime

时间花了,要花得明白。这一分钟里,AgentTime 怎么给 AI Coding Agent 记一本时间账:

agenttime-promo.mp4

AgentTime 是一个本地优先的 Agent 时间账本:把 Codex、Claude Code、Pi、Oh-My-Pi、DeepSeek Harness、Antigravity、OpenCode 等编码 Agent 的会话记录导入本机,按守恒口径切分出纯工作、等待人审阅、中途停了、待命四段耗时——每段都能从一手事件追溯,加总恒等于轮次墙钟——并把总账一路下钻到单个会话、单轮交互、单次工具调用的输入与输出。

你的 Agent 每天到底替你干了多少活、多少时间在等你点头、多少时间在空转?打开页面就能看到。

AgentTime 总览:时间流向与全景时间轴

为什么需要它

  • 我一天的 Agent 里,真正干活的时间有多少?
  • 一场会话里,多少花在模型想和写、多少在执行命令、多少在等我确认、多少是中途停了?
  • 哪些会话最耗时?不同 Agent、不同模型的耗时分布差别有多大?

常见的时间统计把「开始到结束」整段记成工作时长——人在阅读、思考、等待审批的时间全被算成了 AI 在干活。AgentTime 用事件流里的一手证据把这段账拆开。

守恒耗时模型

态 含义 计量依据
纯工作 work_ms 模型想和写 + 本地工具执行 事件流一手机时(响应跨度、工具配对跨度)累加
等待人审阅 review_wait_ms 人工审批/确认卡点 仅当来源落盘了审批事件才计入;否则如实标「未知」,不编造
中途停了 idle_gap_ms 轮内无任何源事件的空白(网络阻塞、设备休眠、忙上一条等) 轮内 ≥ 阈值无事件区间并集,扣除工具与审阅;源记录不写原因,只给时长不编造归因
待命(轮间间隔) standby_ms 上一轮答完到下一轮提交的间隔 轮次边界相减,是你的时间,AI 零消耗

守恒恒等式:纯工作 + 等待人审阅 + 中途停了 = 轮次墙钟(发出 → 答复完毕),一分不多、一分不少。停摆阈值按适配器分档:Antigravity/Pi/Oh-My-Pi/DeepSeek Harness/OpenCode ≥2 分钟;Claude Code/Codex ≥30 分钟(交互式轮次的分钟级缝隙几乎都是真实生成,长挂起才判停摆)。

排队输入(上一轮未答复完毕时发出下一条,消息排队等待)单独记录为 queue_wait_ms;最后一条答复完毕后的「收尾空档」由前端按当前时刻实时计算——两者都不混入任何其他维度。

界面按展示层短词呈现这四态——AI 工作 / 等待确认 / 中途停了 / 轮间间隔;每个数字背后的术语与字段名,可在页内「这些时间怎么算?」弹窗查到完整三层映射。

配套下钻:轮次六 KPI(总时长 / AI 工作 / 自动完成度 / 超 15s 慢操作 / 排队输入 / 收尾空档)、单轮耗时构成总账(含每段守恒分解与工具逐次调用的输入/输出/起止)、慢操作 TOP 榜、按模型与思考级别的分项、逐轮 Token 用量。总览页另配「每天 AI 干活多久」趋势(按日/按周切换,长范围自动按周聚合)、「每个会话干了多久」时间轴、本时段结论卡与 Markdown 报告导出——全部本地生成、零上传。缺失证据一律如实标注,绝不推算充数——这是 AgentTime 的第一设计原则。

快速开始

npx @ccclucky/agent-time

想先体验界面?零配置一键加载全合成演示数据:

npx @ccclucky/agent-time --demo

启动后会自动打开 http://127.0.0.1:8765(仅绑定本机,--no-open 可关闭),支持中/英双语切换与一键接入本机已检测到的 Agent 目录;点击「生成分享图」可本地渲染脱敏战绩 PNG 卡片。服务运行期间会自动同步:源记录有变化时自动重新导入并刷新页面。也可以全局安装或直接拉取终端摘要:

npm install -g @ccclucky/agent-time
agent-time                  # 或无连字符别名 agenttime
agent-time summary --days 7 # 终端快速查看近 7 天时间账单(支持 --json)

要求 Node.js ≥ 22.15(内建 SQLite 与 zstd,无需编译原生模块)。CLI 还支持 --port、--db、--demo、--no-open 与 import --agent <adapter> <路径> 单独导入,见 agent-time --help。主页概览见 ccclucky.github.io/agent-time。

支持的 Harness

全部只读导入,格式随上游演进持续适配(设计决策见 docs/adr):

Harness 耗时口径 Token 下钻 Turn Inspector 抽屉 备注
Codex ✔ 完成锚点校准 · 长挂起停摆 ≥30 分钟 ✔ 累计快照差分 ✔ 思考链官方加密(ZDR),如实标注
Claude Code ✔ 消息记录跨度 · 长挂起停摆 ≥30 分钟 — ✔ 主会话流
Pi ✔ 一手机时累加 · 停摆 ≥2 分钟 — ✔ 分支拓扑只取活跃路径
DeepSeek Harness ✔ · 停摆 ≥2 分钟 ✔ 逐请求 ✔ 多帧 zstd 事件流
Antigravity ✔ 守恒五态 · 停摆 ≥2 分钟 · ask_question 计入审阅 ✔ 逐请求输入/输出 ✔ 后台任务按完成回执计入;工具逐次含输入/输出与起止
OpenCode ✔ · 停摆 ≥2 分钟 ✔ 逐请求 ✔ SQLite 会话库,一库多会话
Oh-My-Pi ✔ history.db 锚点回退 · 停摆 ≥2 分钟 ✔ 逐请求 ✔ 旧版文件秒级轮次锚点,如实披露

接入能力随上游格式演进持续更新;每个 harness 的轮次边界、完成锚点与降级口径都以 ADR 形式落在 docs/adr。

隐私:本地优先,无遥测

  • 服务只绑定 127.0.0.1,没有任何遥测、上报或账号体系;
  • 本机只落一份统计元数据库(SQLite),不保存工具参数、Prompt 源文与凭据;
  • Turn Inspector 的提问与思考文本在你打开抽屉时按需从本机源文件读取,不落库、不上传;
  • AgentTime 从不读取凭据文件,也从不扫描数据目录之外的任何位置。

它长什么样

会话详情:五维分布(可点击下钻)、六个 KPI、慢操作 TOP 榜与耗时归因。

会话详情

Turn Inspector 抽屉:单轮的提问原文、模型思考链、工具调用栈与逐项耗时,全部按需从源文件提取。

Turn Inspector 抽屉

聚合面板:TOP 会话、操作分布、按接入工具 / 项目 / 工具多维汇总。

聚合面板

接入配置:七个 harness 一页纳管,勾选即接入,支持自定义目录。

接入配置

工作原理

本地会话源(各 harness 数据目录 / SQLite 库,只读)
        │  事件流解析(每 harness 一个适配器)
        ▼
归一化 Event 流(start/complete/abort · model · tool_use/tool_result …)
        │  守恒切分(calculateEventTiming / calculatePiTiming)
        ▼
本地 SQLite 统计库(元数据) ──▶ 本地 Web(127.0.0.1:8765,零依赖原生前端)

同一文件重复导入幂等;源文件变化时保留旧快照并如实报错;分支副本等已知重复源按设计排除并单列说明。

开发

git clone https://github.com/ccclucky/agent-time && cd agent-time
npm ci
npm test          # 全量测试(node:test,无外部测试框架)
npm run check     # 类型检查
npm run dev       # 从源码启动

需要演示数据?npx tsx scripts/make-demo-data.mts /tmp/agenttime-demo 生成一套全合成的多 harness 数据集(脚本同入口打印 serve 命令),本 README 的截图即来自它。

欢迎贡献——接入新 harness、完善口径披露、前端打磨都适合下手,见 CONTRIBUTING.md。

FAQ

会拖慢我的 Agent 吗? 不会。导入是只读解析,无钩子无注入,Agent 进程完全无感。

为什么有的会话「等待确认」显示「—」? 该来源没有落盘审批事件,AgentTime 不把缺失证据当作「零等待」。这是刻意为之的诚实口径。

数据会离开我的电脑吗? 不会。无遥测、无上报、无账号,全部计算与存储都在本机。

支持团队聚合视图吗? 本版本只做本机个人账本。多机聚合在路线图上,但永远不会以牺牲本地隐私为代价。

社区

认可并支持 LINUX DO 社区。

License

MIT

About

Local-first time ledger for AI coding agents (Claude Code, Codex, OpenCode, Pi, Antigravity). Splits pure work vs review wait — zero telemetry.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages