hideTop

A modern terminal-based system monitor written in Go, inspired by top, htop, and gotop.

Built with Bubble Tea and Lip Gloss.

Features

• CPU — total + per-core utilisation bars with core count, colour-coded by load, sparkline history
• GPU — total + per-engine utilisation, core count, frequency, thermal pressure indicator, and heuristic energy impact score. Auto-detected at runtime; hidden on unsupported hardware. Supports Apple Silicon (ioreg), NVIDIA (nvidia-smi), and AMD (sysfs)
• Memory — used / total / available GiB with bar; conditional swap bar when swap is active; sparkline history
• Load Average — 1 / 5 / 15 minute
• Temperature — up to 6 sensors in a 2-column grid, auto-detects CPU/GPU temps, colour-coded by threshold (green < 60°C, yellow 60–80°C, red > 80°C). Disable with --no-temp
• Network — total in/out throughput (bytes/s), per-interface breakdown (up to 4 active interfaces)
• Disk — total read/write throughput (bytes/s), root filesystem usage
• Ports & connections — listening ports (proto, port, process) shown in the Network panel; press n for a full-screen view of all listening ports plus active connections (local/remote/state/process). Collected on a throttled cadence via lsof/sysfs, no sudo. Disable with --no-ports
• Battery — percentage and charging status in the header bar (macOS via pmset, Linux via sysfs)
• Processes — sortable by CPU, memory, or PID with visual sort indicators (▲/▼); columns for PID, state (R/S/Z/T), user, name, threads, CPU%, MEM%; PID-based row selection; incremental search by name, PID, or username; tree view; system process filter; process detail panel (Enter); kill / force kill with confirmation
• Themes — 5 built-in themes: dark (default), light, dracula, nord, monokai
• Responsive layout — two-column layout at ≥ 110 cols, single-column stacked on narrower terminals
• Mouse support — scroll wheel to navigate the process list, click a row to select; click a PID/CPU%/MEM% column header to sort by it; scrolling over the Temperature or Network panel scrolls that panel to reveal hidden sensors/interfaces
• Export — snapshot to JSON with e
• Configurable — CLI flags and $XDG_CONFIG_HOME/hideTop/config.json, or ~/.config/hideTop/config.json when XDG_CONFIG_HOME is unset. The debug log goes to $XDG_STATE_HOME/hideTop/ or ~/.local/state/hideTop/.

Keyboard shortcuts

Key	Action
↑ / k	Move up
↓ / j	Move down
PgUp / Ctrl+B	Jump one page up
PgDn / Ctrl+F	Jump one page down
Home / g	Jump to first
End / G	Jump to last
Wheel	Scroll the process list; over Temp/Net panels scrolls those
Click	Select a process row
/	Start incremental search (name, PID or user)
Esc	Cancel search
Enter	Open process detail
Esc / q	Close the overlay
c	Sort by CPU% (descending)
m	Sort by MEM% (descending)
p	Sort by PID (ascending)
Click header	Click a PID/CPU%/MEM% column header to sort
t	Toggle tree view
s	Toggle the system process filter
x	Terminate the selected process (SIGTERM)
K	Force kill the selected process (SIGKILL)
e	Export a snapshot to JSON
n	Open the network / ports view
1 – 6	Show/hide the CPU, GPU, memory, temperature, network and disk panels
Space	Pause / resume auto-refresh
z	Reset the Temp/Network panel scroll
+ / =	Increase the refresh interval (+250ms)
- / _	Decrease the refresh interval (-250ms)
?	Toggle this help overlay
q	Quit
Ctrl+C	Quit from anywhere

Installation

brew install youhide/tap/hidetop

Recent Homebrew versions require you to trust third-party taps before the first install. If you see Refusing to load formula ... from untrusted tap, run brew trust youhide/tap once and re-run the install.

Quick start

go build -o hideTop ./cmd/hidetop
./hideTop                     # default 1s refresh
./hideTop --interval 500ms    # faster refresh
./hideTop --theme dracula     # use dracula theme
./hideTop --no-gpu --no-temp  # disable GPU and temperature panels
./hideTop --version           # print version and exit
# local build with git tag in --version:
go build -ldflags "-X main.Version=$(git describe --tags --always --dirty)" -o hideTop ./cmd/hidetop

Configuration

CLI flags take precedence over the config file.

Flag	Default	Description
--interval	1s	Metrics refresh interval (min 100ms)
--theme	auto	Colour theme (dark, light, dracula, nord, monokai); defaults to the terminal background
--no-gpu	false	Disable GPU metrics
--no-temp	false	Disable temperature metrics
--no-ports	false	Disable listening ports / connections collection
--export-dir	home	Directory for JSON snapshot exports (e); ~ is expanded
--debug	false	Write debug logs to a file (path printed on exit)
--version / -v	—	Print version and exit

Config file

$XDG_CONFIG_HOME/hideTop/config.json, or ~/.config/hideTop/config.json when XDG_CONFIG_HOME is unset. The debug log goes to $XDG_STATE_HOME/hideTop/ or ~/.local/state/hideTop/.

{
  "interval": "1s",
  "theme": "dracula",
  "no_gpu": false,
  "no_temp": false,
  "no_ports": false,
  "debug": false,
  "export_dir": "~/Desktop",
  "filter_users": ["root", "_windowserver", "nobody"],
  "proc_limit": 50,
  "hidden_panels": ["temp", "net"]
}

The filter_users array controls which usernames are hidden when the system process filter (s) is active. Defaults to ["root", "_windowserver", "nobody"] if not set.

proc_limit caps how many processes are sampled (default 50). hidden_panels lists metric panels to start hidden — the number keys 1–6 toggle them and write the result back here on quit. Hiding panels gives their rows to the process list, which is worth doing on a short terminal.

Architecture

Layer	Package	Responsibility
Entry	cmd/hidetop	Parse config, wire up Bubble Tea, enable mouse & alt screen
App	internal/app	Bubble Tea Model / Update / View, owns the event loop
Metrics	internal/metrics	CPU, memory, load, processes, temperature, network, disk, battery via gopsutil; concurrent collection with graceful degradation
GPU	internal/metrics/gpu	Pluggable backends: Apple Silicon (ioreg), NVIDIA (nvidia-smi), AMD (sysfs). No sudo required
UI	internal/ui	Pure functions: data in → styled string out. Themes, sparklines, process table, detail overlay
Config	internal/config	CLI flags + $XDG_CONFIG_HOME/hideTop/config.json, or ~/.config/hideTop/config.json when
XDG_CONFIG_HOME is unset. The debug log goes to $XDG_STATE_HOME/hideTop/ or
~/.local/state/hideTop/.

Key design decisions:

• No global mutable state — all state lives in the Bubble Tea Model.
• Async collection — metrics are gathered in a tea.Cmd goroutine, so the UI never blocks.
• Concurrent collectors — CPU, memory, load, network, disk, battery, temperature, and processes run in parallel via sync.WaitGroup; GPU runs sequentially after (needs CPU total for energy calculation).
• Graceful degradation — if a collector fails or times out, the previous snapshot is used and a stale indicator appears in the header.
• Pure rendering — UI functions take data + width and return strings. No side effects, easy to test.
• Runtime detection — GPU support is detected via runtime.GOOS + runtime.GOARCH and cached with sync.Once. No build tags needed; the binary works on any platform.
• No sudo — all data sources (ioreg, pmset, nvidia-smi, sysfs, gopsutil) work without elevated privileges.
• PID-based selection — process selection tracks by PID, surviving refresh cycles, re-sorts, and search filters. Falls back to same visual position when a process disappears.
• Responsive layout — panels pair in two columns when the terminal is ≥ 110 columns wide, with matched heights.

Requirements

• Go 1.26+
• macOS or Linux (GPU panel: Apple Silicon, NVIDIA with nvidia-smi, or AMD with sysfs)