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編碼活動的強大工具。