Repository navigation
v0.0.1
gcscope — Go Garbage Collector Visualizer
gcscope is a terminal UI (TUI) for visualizing Go GC behavior in real time: GC cycles, STW pauses, heap live/goal dynamics, and GC pacer signals.
Highlights
- Interactive TUI with in-app Help (
?/h/f1) and hotkeys run: observe GC behavior of your compiled Go binarylab: built-in demo workloads (alloc,churn,idle,spike)attach: connect to aruntime/metricsHTTP endpoint (viapkg/reporter)- Snapshots +
diff: save runs as JSON and compare two snapshots
Install
Go (recommended):
go install github.com/timur-developer/gcscope/cmd/gcscope@latestPrebuilt binaries:
- Download the archive for your OS/arch from Assets
- Extract and run:
- Windows:
.\gcscope.exe ... - macOS/Linux:
./gcscope ...
- Windows:
- Optionally move it into a directory in your
PATH
Quickstart
gcscope lab churnDocs
See README for usage, metrics/panels, configuration (flags + env), snapshots, and controls.