Ghostlog:實時終端界面,監控AI編程代理的Git提交
Ghostlog 是一款實時終端界面工具,專門用於監控AI編程代理的Git提交。它能將快速連續提交分組為“爆發”,顯示代理速度,並支持導出會話清單和CI門控模式。
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編碼活動的強大工具。