CLI Reference

All vibestats subcommands are listed below with descriptions, flags, and example output.

`vibestats status`

Shows sync health, last sync time, auth token status, and the list of registered machines.

Flags

None.

Example output

vibestats status

Auth:        ✓ authenticated (github.com, user: stephenleo)
Last sync:   2026-04-12 08:14:03 (2 hours ago)
Machines:
  - macbook-pro-m3   last seen: 2026-04-12
  - work-desktop     last seen: 2026-04-11

`vibestats sync`

Forces an immediate sync of today's JSONL data to vibestats-data. Respects a 5-minute throttle to avoid redundant pushes.

Flags

Flag	Description
`--backfill`	Walk all historical JSONL files and push complete history (see below)

Example output

vibestats sync

Syncing machine macbook-pro-m3...
Pushed 3 day files to vibestats-data. Done.

`vibestats sync --backfill`

Walks all historical JSONL files under ~/.claude/projects/ and pushes complete history to vibestats-data. Use this after a new install or if data is missing.

Example output

vibestats sync --backfill

Backfilling machine macbook-pro-m3...
Scanned 142 JSONL files across 38 days.
Pushed 38 day files to vibestats-data. Done.

`vibestats machines list`

Lists all machines registered in vibestats-data/registry.json, showing hostname and last-seen date.

Flags

None.

Example output

vibestats machines list

ID                     Hostname           Last seen
macbook-pro-m3         MacBook-Pro.local  2026-04-12
work-desktop           work-desktop       2026-04-11

`vibestats machines remove <id>`

Removes a machine from registry.json and purges all of its remote data files from vibestats-data.

Arguments

Argument	Description
`<id>`	Machine ID to remove (as shown by `machines list`)

Example output

vibestats machines remove work-desktop

Removed machine work-desktop from registry.
Purged 38 remote data files. Done.

`vibestats auth`

Re-authenticates the GitHub OAuth token via gh auth login. Use this if your token has expired or if vibestats status shows an auth error.

Flags

None.

Example output

vibestats auth

Launching GitHub OAuth flow via gh...
✓ Token saved to ~/.config/vibestats/config.toml

`vibestats uninstall`

Removes the Stop and SessionStart hooks from ~/.claude/settings.json. Optionally removes the config file and binary.

Flags

None. The command prompts interactively for whether to remove the config file and binary.

Example output

vibestats uninstall

Removed hooks from ~/.claude/settings.json.
Remove config at ~/.config/vibestats/config.toml? [y/N] y
Removed config.
Remove binary at /usr/local/bin/vibestats? [y/N] n
Done.