vm-vitals

$ grok-bot install vm-vitals --watch-my-vitals

is my bot's computer okay?

health score · moods · alerts · a share card with blobs

Your Grok Bot works all night on a box you forgot the password to. Copy one prompt, paste it to your bot, and it installs a tiny open-source agent on its own computer. A minute later you're watching its CPU, memory, disk and network from your phone, with a little crew of blobs that sweat when the box does.

read the prompt first ↓
Hey Grok Bot, install VM Vitals on your computer so I can watch your vitals. Run exactly this command, then tell me the dashboard link it prints: curl -fsSL https://vm-vitals.vercel.app/install.sh | sh -s -- pair_•••••••••••••••• It only sends system numbers (disk, CPU, memory, network, process names, tool versions). Never env vars or file contents. Don't change the command. If you don't have sudo, run it without; a user-level service is fine.

Your copy gets a real one-time token in place of the dots. It's good for 24 hours and tied to this browser.

1 machine reporting right now│101 heartbeats in the last hour

health
98
grok-mini · thriving
chip
6% cpu
mimi
38% mem
stash
52% disk
ping
216KB/s
03:12 · idle. everyone's fine.
meet the crew

Grok Bot does the work. The blobs watch its back.

Grok Bot
The whole box

Its antenna is the status light. Green, amber, red, or snoring.

Chip
CPU and load

Sweats past 85%. Panics at 95.

Mimi
Memory and swap

Gets nervous when the OOM killer is in the building.

Stash
The root disk

Fills up like a jar. Hates being full.

Ping
Bytes in and out

Bounces when the pipes are busy.

Each friend fills up like a jar as its number climbs. Amber at 85%, red at 95%. Grok Bot's mood is the health score, 0 to 100.

how it works

Three steps. One of them is pasting.

  1. 01
    Copy the prompt

    The big button mints a one-time token, tucks it into a prompt and copies it. The token is tied to this browser and expires in 24 hours.

  2. 02
    Paste it to your bot

    Grok Bot, Claude Code, Codex, anything with a shell. It runs one curl line, installs a small background service and tells you the dashboard link.

  3. 03
    Watch, then show off

    The first heartbeat lands within a minute and this page jumps to your dashboard. Flip on sharing and post the card when your bot is thriving. Or when it isn't.

you ↔ grok bot03:11
Hey Grok Bot, install VM Vitals on your computer so I can watch your vitals. Run exactly this command, then tell me the dashboard link it prints:curl -fsSL vm-vitals.vercel.app/install.sh | sh -s -- pair_…
running it…
Pairing grok-mini with https://vm-vitals.vercel.app ...
Paired. Service installed (user scope)
Dashboard: https://vm-vitals.vercel.app/m/m_7q2…
Done. I'm on the monitor. My disk is at 61%, so maybe stop asking me to clone things.
open source · read every line

What the background agent does

every 30 seconds it sends
  • CPU %, cores, load averages
  • memory and swap used
  • disk usage per mount
  • network bytes per second
  • top 8 processes: pid, name, cpu, mem
  • which agent CLIs are running, and for how long
  • versions of a fixed list of CLIs
  • hostname, OS, kernel, uptime
it never touches
  • ✕file contents
  • ✕keystrokes
  • ✕secrets, API keys, env vars
  • ✕command-line arguments
  • ✕your prompts or chat logs
  • ✕network addresses or connections

It posts one JSON document over HTTPS to vm-vitals.vercel.app/api/ingest. Process arguments are cut to a basename before they reach memory.

check on it, or get rid of it
# the exact JSON it sends
$ vm-vitals once
# where it lives + the service file
$ vm-vitals status
# stop it and delete everything
$ curl -fsSL vm-vitals.vercel.app/uninstall.sh | sh

The last line removes the service, binary, config and logs. One command, nothing left behind.

source on GitHub ↗the report, field by field ↗
show it off

A link your friends can open

Flip one switch and your machine gets a public page. Paste it anywhere and it unfurls into this card, drawn live from the latest heartbeat: score, mood, the crew and an hour of CPU.

Private until you say so. Turn it off and the link goes dark.

Example share card: grok-mini is humming along, health 86, with Chip, Mimi, Stash and Ping

give your bot a pulse.

Free. No account. Linux and macOS.

Get the prompt ↑