Ghostlog: Live terminal UI to monitor AI coding agent Git commits

Notifications You must be signed in to change notification settings

Fork 0

Star 0

BranchesTags

Open more actions menu

Folders and files

NameName

Last commit message

Last commit date

Latest commit

History

66 Commits

66 Commits

.github/workflows

.github/workflows

internal

internal

.gitignore

.gitignore

.goreleaser.yaml

.goreleaser.yaml

README.md

README.md

check.go

check.go

debug_tiers.log

debug_tiers.log

export.go

export.go

go.mod

go.mod

go.sum

go.sum

install.sh

install.sh

logo.png

logo.png

main.go

main.go

Repository files navigation

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

Readme

Uh oh!

There was an error while loading. Please reload this page.

Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks

Report repository

Releases 2

v1.0.1

Latest

Jul 5, 2026

+ 1 release

Packages 0

Uh oh!

There was an error while loading. Please reload this page.

Contributors

Uh oh!

There was an error while loading. Please reload this page.

Languages

Go 92.7%

Shell 7.3%