
Vibetime 追踪 AI 编程会话,结束即打印代码改动摘要
来源标题:Show HN: Vibetime – see what you ship when coding with AI agents
Vibetime 是一款 CLI 工具,可包裹 Claude Code、Codex、Gemini、Aster、Opencode 等 AI 编程工具,在每次会话结束时打印本次的提交数、代码增删行数和文件数摘要。Cursor Desktop 和 ZCode 通过 session hooks 追踪。该工具无需配置、无需后台进程、默认无需账号,可通过 npm install -g vibetime-cli 安装。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
Vibetime 封装了 Claude Code、Codex、Gemini、Aster 和 Opencode,每次你完成工作后都会打印一份会话总结。Cursor Desktop 和 ZCode 通过 session hooks 进行追踪。无需配置、无需守护进程、默认无需账号。
npm install -g vibetime-cli
安装
vibe source ~/.zshrc # 或 ~/.bashrc / ~/.config/fish/config.fish
直接运行 vibe 不带任何参数即可完成全部设置:在终端中封装 claude、codex、gemini、aster 和 opencode 的 shell hooks,以及为 Claude Code、Codex、Cursor 和 ZCode 应用安装桌面 session hooks(见桌面应用部分)。这些工具的使用方式完全不变——Vibetime 在你编码时追踪你的 git 状态,并在你完成工作时打印结束卡片。
Fish、Bash 和 Zsh 会被自动检测,并将匹配的语法写入对应 shell 的 rc 文件。vibe init 会显式执行同样的操作,重复运行始终是安全的。
每次你关闭 Claude Code、Codex、Gemini、Aster、Opencode、Cursor 或 ZCode 会话时:
╭─────────────────────────────────────────────╮ │ ◆ vibe · api · 2h 14m │ ├─────────────────────────────────────────────┤ │ │ │ 3 commits · +847 −231 · 12 files │ │ │ │ ████████░░ shipped ✦ │ │ │ ╰─────────────────────────────────────────────╯
每个已交付的会话都会计入排行榜。
会话根据 git 中实际发生的情况进行评分:
时长如何计算——Vibetime 每 30 秒轮询一次你的 git 状态。如果连续 30 分钟没有检测到文件变更、提交或暂存活动,空闲时间会从会话时长中排除。笔记本休眠和后台空闲会被自动处理。非 git 项目使用实际耗时。
谁的提交被计入——登录后,只计入你自己的提交。在会话中途拉取或合并团队的工作到你的分支,不再将他们的提交算作你的。Vibetime 通过该仓库 git config 中 user.email 的邮箱加上你的 GitHub noreply 地址进行匹配,因此从网页 UI 做出的提交仍然会被计入,无需任何配置。未登录时,范围内的所有提交都会被计入,与之前一致。
每个提交只计一次。多个会话可能看到同一个提交:同一仓库并行 worktree 中的多个 agent、同一分支上的两个编辑器窗口、编辑器旁边的终端,或者你将自己工作拉取到的第二台机器。该提交会归属到其中一个会话,通常是做出该提交的检出目录中工作的那个会话,因此并行工作会被完整计入,且不会重复计入。合并、变基或修改某个会话已被计入的工作不会再次计入,对已是最新的分支进行 squash 合并同样不会。对已发生移动的 main 进行 squash 是唯一无法识别的情况。
Claude Code、Codex、Cursor 和 ZCode 桌面应用从不运行被封装的终端命令,因此 shell 封装无法感知它们。Vibetime 通过 session hooks 来追踪它们——vibe init 会自动设置这些 hooks。如果你在桌面支持存在之前运行过 vibe init,请重新运行它或使用:
vibe hooks install
无论哪种方式,它都会在 /.claude/settings.json、/.codex/hooks.json、~/.cursor/hooks.json 和 ~/.zcode/cli/config.json 中为全部四个应用注册 session hooks,包括你尚未安装的应用:hooks 在应用存在之前只是惰性配置,所以如果你几个月后切换应用,你已经处于被追踪状态,无需重新运行任何东西。Vibetime 未创建的 hooks 永远不会被触碰。从那时起,每个桌面会话都会被记录,并出现在 vibe status、vibe log、vibe share 和排行榜中,与终端会话完全一样。
时长的测量方式与终端相同:活跃编码时间,超过 30 分钟的空闲间隔会被排除。
跨多个仓库工作?你可以在任何位置启动会话。如果该目录本身不是仓库,vibetime 会拾取直接位于其中的仓库并测量所有这些仓库,因此一个涉及 api/ 和 web/ 的会话会在两者上都被评分。不在其内或其下没有仓库的目录不会被追踪——因为没有什么可测量的。
如果你同时使用终端封装和桌面 hooks,终端会话只计一次,不会重复——当 shell 封装已经在追踪时,hooks 会退出。
为什么 hooks 使用绝对路径——桌面应用从 Dock 启动时不会继承你的 shell PATH,因此裸的 vibe 无法解析。vibe hooks install 会固定 Node 和 CLI 的绝对路径,这样无论桌面如何启动,追踪都能正常工作。
如果你切换了 Node 版本(例如 nvm 升级)并移除了旧版本,请运行 vibe status:它会将 hooks 指向你当前的 Node,并指出任何仍未受追踪的应用及其原因,例如某个设置文件不再是有效的 JSON。
vibe hooks uninstall
排行榜(可选加入)
在线访问 vibetime.club/leaderboard。公开网页视图,浏览无需 CLI。
vibe login 使用 github 登录 vibe leaderboard 从终端查看排行榜 vibe logout 退出登录并停止提交
排行榜按 ships 排名:每次会话落地一个包含有意义变更的提交(超过 50 行或超过 3 个文件)。方块显示你交付了哪些天。网页视图上的标签页可在本周(周一至周日,UTC)、本月和全部时间之间切换。
登录使用 GitHub device flow:无需浏览器回调,只需一个短代码粘贴到 github.com。在你运行 vibe login 之前,不会发出任何网络请求。
登录后,结束卡片照常渲染,会话在后台提交。如果你离线,提交会在下一个会话结束时重试,因此你交付的任何内容最终都会出现。
关于何时上榜。登录并不会让你出现在排行榜上,你的第一次 ship 才会:一个至少持续一分钟且落地了包含有意义变更的提交的会话。终端会话在 Vibetime 检测到该提交后立即提交,通常是在提交后一分钟内,因此你还在工作时就会出现在榜上。桌面会话在会话结束时提交。页面本身还会在此基础上缓存一分钟。
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。