Skip to content

README.md

Latest commit

 

History

History
86 lines (62 loc) · 2.39 KB

README.md

File metadata and controls

86 lines (62 loc) · 2.39 KB
Raw

tinytop

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

tinytop screenshot

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