@bwrong/codepulse

CodePulse 编码时间采集 CLI：向 WakaTime 上报终端 / CLI 编码心跳，附带 zsh 插件。与官方 WakaTime 编辑器插件同源同后端、同项目命名，CodePulse 面板零改动即可展示终端编码时间。

安装

仅支持 npm 全局安装：

npm i -g @bwrong/codepulse
codepulse init-zsh   # 在 ~/.zshrc 中启用 zsh 插件（会先征求确认）

init-zsh 会向 ~/.zshrc 写入动态加载形式（source "$(npm root -g)/@bwrong/codepulse/shell/codepulse.zsh"），每次开 shell 自动解析真实路径，升级包后无需改动 .zshrc。

请勿通过 vite-plus 等工具代理安装：其包目录含 UUID 且随版本升级变化，codepulse 命令也不在 PATH 中，zsh 插件无法加载与发心跳。若确实需要指定包根，可设置 CODEPULSE_ROOT=<包根>（包根是含 shell/codepulse.zsh 的目录）。

用法

# 手动发送一条心跳
codepulse heartbeat --project my-project --entity "npm run dev" --write

# 只打印请求，不发送
codepulse heartbeat --project test --dry-run

zsh 插件安装后：每次敲命令即发心跳，codex / claude code 等长驻 CLI 工具在运行期间每 60s 周期心跳，编码时间可完整统计。

文档

详见 docs/shell-tracking.md。