Skip to content

v0.0.1

Choose a tag to compare

@github-actions github-actions released this 28 May 09:30
· 7 commits to main since this release

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 binary
  • lab: built-in demo workloads (alloc, churn, idle, spike)
  • attach: connect to a runtime/metrics HTTP endpoint (via pkg/reporter)
  • Snapshots + diff: save runs as JSON and compare two snapshots

Install

Go (recommended):

go install github.com/timur-developer/gcscope/cmd/gcscope@latest

Prebuilt binaries:

  • Download the archive for your OS/arch from Assets
  • Extract and run:
    • Windows: .\gcscope.exe ...
    • macOS/Linux: ./gcscope ...
  • Optionally move it into a directory in your PATH

Quickstart

gcscope lab churn

Docs

See README for usage, metrics/panels, configuration (flags + env), snapshots, and controls.