tinytop

Tiny terminal CPU monitor with Unicode graphics. Designed for small terminals over SSH.

Features

• CPU: Stacked area chart - user (green), system (red), iowait (yellow), steal (purple)
• Tokens: Claude Code token usage - input/prompt (brown), output/response (cyan), cache (gray)
• Vercel: Deployment event markers - building (yellow), ready (green), error (red)
• Plan 9-inspired color palette (muted acme colors)
• Peak annotations showing CPU % at significant spikes
• Variable time scales: 1s, 2s, 5s, 10s, 30s, 60s per column
• Unicode block characters for sub-character resolution
• Adapts to terminal size
• 1-second refresh rate (SSH-friendly)
• Single static binary, no dependencies

Build

# For current platform
go build -o tinytop

# For Linux (cross-compile from macOS)
GOOS=linux GOARCH=amd64 go build -o tinytop

Usage

./tinytop

Keys:

• q or Ctrl+C - quit
• + - zoom out (more time per column)
• - - zoom in (less time per column)

Vercel Deployment Tracking

Tracks Vercel deployments with colored markers. Auto-detects project from .vercel/project.json in current directory, or set explicitly:

export TINYTOP_VERCEL_PROJECT=yourproject

Requires Vercel CLI installed and authenticated (vercel login). Shows colored markers:

• Yellow: Building/Queued
• Green: Ready (success)
• Red: Error (failed)

Claude Code Token Tracking

To see Claude Code token usage, add to your shell profile:

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
export OTEL_METRIC_EXPORT_INTERVAL=10000  # 10 seconds

Then run tinytop (listens on port 4317) and use Claude Code in another terminal.

Requirements

• Linux or macOS
• UTF-8 terminal

Platform Notes

• Linux: Shows user, system, iowait, steal (reads /proc/stat)
• macOS: Shows user, system (reads via Mach API)

AI Notes

• main.go - UI and rendering
• cpu_linux.go - Linux /proc/stat parsing
• cpu_darwin.go - macOS Mach API
• otel.go - OTLP gRPC receiver for Claude Code metrics
• vercel.go - Vercel CLI poller for deployment status
• Uses Bubbletea for TUI, Lipgloss for styling
• Chart uses ▁▂▃▄▅▆▇█ blocks for 8-level vertical resolution