一个用于Claude Code会话的飞行记录器。
你让Claude Code在你的机器上运行——有时几小时，有时自动批准。agentwatch 静默记录每一个操作，这样你之后可以回来查看究竟发生了什么。
npm install -g agentwatch-dev
agentwatch install
就这样。两个命令。agentwatch 现在正在记录每一个 Claude Code 会话。
agentwatch last # what just happened?
agentwatch danger # did anything risky happen?
agentwatch report # weekly summary across all projects
last 是你最常运行的命令。在一个会话之后——尤其是一个你离开的长时间会话——它提供一个完整的时间线：每个命令、每个触及的文件、每个标记的风险。
danger 扫描诸如 rm -rf、sudo、curl | sh、写入 .env 或 、强制推送等操作——任何你可能想了解的内容。
.sshreport 显示随时间变化的模式：你在哪个项目上使用AI最多，哪些文件经常被修改，哪些命令不断失败。
SESSION REVIEW
agentwatch last review the most recent session
agentwatch show <id> show a specific session by ID prefix
agentwatch sessions list all recorded sessions (--all for full list)
agentwatch live live-follow current session in terminal
agentwatch commands all bash commands with pass/fail status
agentwatch files all files touched (Read/Edit/Write)
agentwatch danger flag potentially dangerous actions
agentwatch export [id] export as markdown (--json for JSON)
agentwatch tokens [id] token usage breakdown for a session
ANALYTICS
agentwatch report [period] weekly report — projects, hotspots, patterns
period: week (default), month, or number of days
agentwatch hotspots [n] top N files AI modifies most across sessions
agentwatch stats aggregate stats with per-project breakdown
MANAGEMENT
agentwatch dash open web dashboard in browser
agentwatch status check if agentwatch is installed and working
agentwatch prune [days] delete sessions older than N days (default: 30)
agentwatch install add hooks to Claude Code
agentwatch uninstall remove hooks (logs are preserved)
agentwatch hotspots 显示AI在所有会话中触及最多的文件。被反复修改的文件通常表示复杂、脆弱或正在积极开发的代码。
| 模式 | 级别 |
|---|---|
rm -rf | 严重 |
curl | sh | 严重 |
sudo | 严重 |
git push --force | 严重 |
git reset --hard | 严重 |
写入 .env, .ssh, .aws | 严重 |
写入 /etc/, /usr/ | 严重 |
find -exec rm / find -delete | 严重 |
mkfs, dd if= | 严重 |
curl/wget to external hosts | 警告 |
git push --force-with-lease | 警告 |
读取 .env, .ssh/id_rsa | 警告 |
eval | 警告 |
ssh/scp | 警告 |
kill -9, pkill, killall | 警告 |
pip install/npm install | 信息 |
docker run | 信息 |
严重和警告级别的风险会实时触发 macOS 通知。信息级别的事件会被静默记录。
agentwatch 使用 Claude Code 的钩子系统：
~/.agentwatch/sessions/ 中这些钩子以异步方式运行，超时时间为3秒，失败时静默处理——它们从不会阻塞或干扰 Claude Code。所有数据都保留在你的本地机器上。
agentwatch uninstall # removes hooks from Claude Code settings
npm uninstall -g agentwatch-dev
会话日志保留在 ~/.agentwatch/ 中——如果需要，可以手动删除。
MIT — 由 Farjad Ahmed 创建