paseo-vitals

A small Paseo sidebar dashboard for answering one question: how is this development VM doing?

Live usage on a Linux Paseo host. Private host addresses are redacted.

It shows:

• host CPU, load, uptime, RAM detail, swap, and root-disk usage;
• Paseo daemon/plugin RSS separately from agent process trees;
• per-agent RSS, CPU, process count, provider, and status;
• Docker container CPU, cgroup memory, state, PIDs, network I/O, and block I/O;
• the host's largest processes by RSS.

The plugin reads Linux /proc directly and invokes docker stats at most once per cached refresh. It reads only the PASEO_AGENT_ID environment entry needed to attribute a process tree; command lines and other process environment values are never returned to the client.

Install

Install from npm using the latest Paseo release:

paseo plugin install paseo-vitals

Use

Open Host vitals from Paseo's sidebar. The dashboard refreshes every five seconds while mounted. Docker failure is non-fatal, and process-level detail degrades gracefully on non-Linux hosts.

Development

npm ci
npm run verify
paseo plugin install paseo-vitals

License

MIT © 2026 Tom Gringauz.

Other plugins

• Defer — Schedule messages for later delivery.
• Graphite — Graphite stacks and PR status.
• Smart Session — Context compaction and usage insights.
• Session Guard — Pause at session limits and continue after reset.
• Transfer — Copy or move workspaces between hosts.
• Transcript Search — Search conversations across connected hosts.
• Send to Paseo — Send GitHub and Graphite PRs to Paseo from Chrome.
• Dispatch — Route tasks to existing workspaces (development preview).