Vibe Guard CLI · Meter

Your live AI usage, right in your terminal

A lightweight, read-only meter for your terminal: your live token count, plan-limit fill %, and model — for whatever AI coding agent you're running, in any IDE. Just the numbers. Want it to also keep your agent on track across context limits? That's the full CLI with the Guardian.

See it work

One command prints your live usage; add --watch for a meter that refreshes as you work.

Simulated preview

Real, live output from the Vibe Guard Meter CLI.

One install, every IDE

You don't install the Guardian inside each editor. You install it once on your Mac, and it works alongside whatever agent is open — because it watches from the outside.

The simple version: it's a quiet helper running in the background. When your AI coding agent is about to run out of room and forget what it's doing, the Guardian nudges it to save its place and pick back up — so a long build doesn't fall apart.

Covers all your IDEs

Claude Code, Cursor, Antigravity, Windsurf, Codex — one install protects them all at the same time.

Just the numbers

Read-only. It shows usage and limits — it never writes, never injects, never sees your code or prompts.

Live or one-shot

Run it once for a quick reading, or --watch for a meter that updates as you work.

Private, on your machine

It reads your local context meter only — it never sees your code or your prompts.

Install it — step by step

A few quick steps in your terminal (every IDE has one built in). After that it runs in the background for all your editors.

Download & unzip

Get the .zip above and double-click it to unzip the vibeguard-cli folder.

Install it

In Terminal, run pipx install vibeguard-meter (or pip install . from the folder). Needs Python 3.8+.

Read your usage

Run vibeguard-meter for a one-shot reading of tokens + limit fill.

Watch it live

Run vibeguard-meter --watch for a meter that refreshes as you work.

The commands
pipx install vibeguard-meter # install once vibeguard-meter # one-shot usage reading vibeguard-meter --watch # live, refreshes every few seconds
Which IDEs? Claude Code, Cursor, Antigravity, Windsurf, and Codex — all from this one install.

Ready to see your usage?

Download the Meter CLI and run vibeguard-meter. Included with your Vibe Guard subscription. Want the Guardian too? Get the full CLI.