Skip to content

salarkhannn/ghostlog

Repository files navigation

Ghostlog Logo

ghostlog

A live Terminal UI that watches a Git repository and captures every commit an AI coding agent makes — in real-time.

ghostlog-demo.mp4

Installation

One-Command Install (macOS / Linux)

Instantly download and install the latest precompiled binary:

curl -sL https://raw.githubusercontent.com/salarkhannn/ghostlog/main/install.sh | bash

Windows (PowerShell)

Download the latest Windows_x86_64.tar.gz from the Releases tab, extract ghostlog.exe, and place it in your system PATH.

Install via Go

If you have Go 1.23+ installed, you can build and install it globally:

go install github.com/salarkhannn/ghostlog@latest

Or build from source:

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

Requirements: Go 1.23+, git in $PATH. No CGO. No external runtime.

Usage

ghostlog -repo /path/to/project

Start ghostlog before launching your AI agent. The TUI opens immediately and starts watching for commits in a separate terminal.

# Terminal 1
ghostlog -repo ~/my-project

# Terminal 2 (or use Cursor, Claude Code, Aider, etc.)
cd ~/my-project && aider

Subcommands

Export Session Manifest Export a JSONL manifest of the burst log with metadata and complexity deltas:

ghostlog export -session /path/to/project -out manifest.jsonl

CI Gate Mode Run ghostlog in a headless mode in CI pipelines to block complex or untested AI code:

ghostlog check -session /path/to/project -fail-on complexity,coverage -max-complexity-delta 10 -min-coverage-touch 0.8

Keybindings

Key Action
Tab Switch focus between Burst List and Diff Viewport
j / Scroll selected pane down
k / Scroll selected pane up
p / n / [ / ] Cycle through bursts globally (previous/next)
Ctrl+D / PgDn Scroll diff down
Ctrl+U / PgUp Scroll diff up
a Toggle auto-scroll (follows newest burst)
c Copy commit hashes of selected burst to clipboard
v Toggle file-flash treemap view
s Open the Session Manager
q / Ctrl+C Quit

Concepts

Burst — A group of commits that arrive within 5 seconds of each other. AI agents often make 5–20 rapid commits in a single task; grouping them into bursts makes the session readable at a glance.

Agent Speed — Rolling 60-second window of commits/min. Spikes indicate the agent is actively writing code.

Filtering — Empty commits (no file changes) are silently ignored.

Works with

Any agent that commits to git: Aider, Claude Code, Cursor, Devin, OpenHands, custom scripts.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages