# Vibe Usage

> Track and sync AI coding tool token usage to vibecafe.ai dashboard.

- Skill: `vibe-cafe/vibe-usage` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add vibe-cafe/vibe-usage`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vibe-cafe/vibe-usage/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: vibe-cafe (https://skillmd.com/u/vibe-cafe)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vibe-cafe/vibe-usage

---


# Vibe Usage

Track your AI coding tool token usage and sync to [vibecafe.ai](https://vibecafe.ai/usage).

## Setup

First-time setup (interactive — opens the browser for login, then syncs and turns on background sync):

```bash
npx @vibe-cafe/vibe-usage
```

Headless machines: pre-issue a key at https://vibecafe.ai/usage/setup and run `npx @vibe-cafe/vibe-usage init --manual-key <vbu_...> --no-daemon`.

## Commands

When the user asks to sync usage, check costs, or track tokens, run:

```bash
npx @vibe-cafe/vibe-usage sync
```

Other available commands:

| Command | Description |
|---------|-------------|
| `npx @vibe-cafe/vibe-usage sync` | Sync latest usage data |
| `npx @vibe-cafe/vibe-usage status` | Show config and detected tools |
| `npx @vibe-cafe/vibe-usage daemon status` | Check the background sync service (installed by first run) |
| `npx @vibe-cafe/vibe-usage reset` | Delete all data and re-upload |
| `npx @vibe-cafe/vibe-usage reset --local` | Delete this host's data and re-upload |

## When to Use

- User says "sync my usage", "upload usage", "track tokens"
- User asks "how much have I spent?", "what's my cost?"
- User wants to check if sync is working: run `status`
- User asks whether background sync is on: run `daemon status` (the first run installs it; `daemon install` re-enables it after `--no-daemon` or `daemon uninstall`)

## Notes

- Requires initial setup (run `npx @vibe-cafe/vibe-usage` first — browser login, no key to copy)
- Config is stored at `~/.vibe-usage/config.json`
- Supports: Claude Code, Codex, Grok, and others