A keyboard-driven TUI for exploring Go pprof profiles. Faster than go tool pprof -http, no browser needed — works in any terminal, including over SSH.
Install
go install github.com/owenrumney/lazypprof/cmd/lazypprof@latest
Homebrew
brew tap owenrumney/tools brew install --cask lazypprof
Or grab a binary from Releases.
Usage
# Load a profile from disk lazypprof cpu.prof lazypprof heap.pb.gz # Diff two profiles (positive = regression, negative = improvement) lazypprof base.prof current.prof # Connect to a live service lazypprof http://localhost:6060 # CPU (default) lazypprof -type heap http://localhost:6060 # heap lazypprof -type allocs http://localhost:6060 # allocs lazypprof -type goroutine http://localhost:6060 # goroutines (with state filtering) lazypprof -type mutex http://localhost:6060 # mutex contention lazypprof -type block http://localhost:6060 # blocking operations # Custom poll interval lazypprof -interval 3s -type allocs http://localhost:6060 # Auto-detect: if nothing is specified, probes localhost:6060 lazypprof
Profile types: cpu (default), heap, allocs, goroutine, mutex, block
Demo
File profile
Live service
Views
Top — functions ranked by cumulative value. Standard pprof top view. In diff mode, rows are coloured red (regression) or green (improvement) with delta columns.
Tree — collapsible call tree. Expand/collapse nodes, navigate with keyboard. Filter matches are highlighted and paths auto-expanded.
Flame — terminal-rendered flame graph. Zoom in/out, navigate frames. Filter matches are highlighted; non-matching frames are dimmed.
Goroutines — goroutines grouped by state (running, IO wait, select, etc). Drill into a state to see unique stacks with counts.
Keys
| Key | Action |
|---|---|
tab |
Cycle views |
s |
Cycle sample type |
/ |
Filter by function name (regex) |
esc |
Clear filter |
[ |
Step back through history |
] |
Step forward through history |
p |
Pause/resume live updates |
m |
Switch profile type (live mode) |
? |
Help overlay |
q |
Quit |
Tree
| Key | Action |
|---|---|
j/k ↑/↓ |
Navigate |
l/→/enter |
Expand |
h/← |
Collapse / parent |
space |
Toggle |
* |
Expand subtree |
0 |
Collapse all |
Flame
| Key | Action |
|---|---|
h/j/k/l ←↓↑→ |
Navigate frames |
enter |
Zoom in |
backspace |
Zoom out |
0 |
Reset zoom |
Goroutines
| Key | Action |
|---|---|
j/k ↑/↓ |
Navigate groups |
g |
Cycle state filter |
enter |
Drill into state |
backspace |
Back to groups |
Building
go build ./cmd/lazypprof
Test Service
A built-in test service generates realistic workload with pprof endpoints:
go run ./cmd/testservice
# then: lazypprof http://localhost:6060