Ghostlog：实时终端界面，监控AI编程代理的Git提交

Ghostlog 是一款实时终端界面（TUI）工具，专门用于监控AI编程代理的Git提交。它能够实时捕获AI代码代理所做的每一次提交，并将它们清晰地展示在终端界面中。

安装方法

Ghostlog 提供多种安装方式：

• 一键安装（macOS/Linux）：运行 curl -sL https://raw.githubusercontent.com/salarkhannn/ghostlog/main/install.sh | bash 即可下载并安装最新预编译二进制文件。
• Windows（PowerShell）：从Releases页面下载 Windows_x86_64.tar.gz，解压后得到 ghostlog.exe，并将其添加到系统PATH中。
• 通过Go安装：如果已安装Go 1.23+，可以运行 go install github.com/salarkhannn/ghostlog@latest 进行全局安装。也可以从源码编译：

``` git clone https://github.com/salarkhannn/ghostlog cd ghostlog go build -o ghostlog . ```

• 依赖要求：需要Go 1.23+、git 命令可用，无需CGO或外部运行时。

使用方法

启动Ghostlog非常简单：ghostlog -repo /path/to/project。建议在启动AI代理之前先运行Ghostlog，它会立即打开TUI并开始监控。例如，在终端1中运行 ghostlog -repo ~/my-project，然后在终端2中使用Aider等工具。

子命令

• 导出会话清单：使用 ghostlog export -session /path/to/project -out manifest.jsonl 导出包含元数据和复杂度差异的JSONL清单。
• CI门控模式：在CI流水线中无头运行，阻止复杂或未经测试的AI代码：ghostlog check -session /path/to/project -fail-on complexity,coverage -max-complexity-delta 10 -min-coverage-touch 0.8。

快捷键

| 键 | 动作 | | --- | --- | | Tab | 切换焦点在爆发列表和差异视口之间 | | j / ↓ | 向下滚动选中面板 | | k / ↑ | 向上滚动选中面板 | | p / n / [ / ] | 全局切换爆发（上一个/下一个） | | Ctrl+D / PgDn | 向下滚动差异 | | Ctrl+U / PgUp | 向上滚动差异 | | a | 切换自动滚动（跟随最新爆发） | | c | 复制选中爆发的提交哈希到剪贴板 | | v | 切换文件闪存树图视图 | | s | 打开会话管理器 | | q / Ctrl+C | 退出 |

核心概念

• 爆发：在5秒内到达的一组提交。AI代理通常在一次任务中快速提交5-20次，将它们分组为爆发使得会话一目了然。
• 代理速度：滚动60秒窗口内的每分钟提交数。峰值表示代理正在积极编写代码。
• 过滤：无声忽略空提交（无文件更改）。

兼容性

Ghostlog可与任何使用Git提交的AI代理配合使用，包括Aider、Claude Code、Cursor、Devin、OpenHands或自定义脚本。

Ghostlog完全开源，支持跨平台，是监控AI编码活动的强大工具。