mcpField
V
vibe-usage

vibe-usage

github.com/vibe-cafeAgent workflows14463 installsUpdated 5d ago
Repository

About vibe-usage

vibe-usage is a command-line tool for tracking AI coding tool token usage and syncing it to vibecafe.ai. It is for developers who want usage or sync status information, with commands for syncing, checking status, and managing background sync.

Key features

  1. 01Sync the latest usage data
  2. 02View detected tools and upload status
  3. 03Check the background sync service
  4. 04Reset and upload data again

Use cases

  1. 01Sync token usage from coding tools
  2. 02Review data uploaded for each tool
  3. 03Check whether background sync is running

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/vibe-cafe/vibe-usage --skill vibe-usage

After installing, type/vibe-usagein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

README.md
package-lock.json
.gitignore
AGENTS.md
package.json
.github/workflows/
test.yml
bin/
vibe-usage.js
docs/
hermes-daily-usage-rfc.md
WINDOWS_ACCEPTANCE.md
scripts/
release.sh
src/
cindy-roots.js
api.js
cline-roots.js
claude-roots.js
codearts-roots.js
client-meta.js
config.js
codex-roots.js
craft-roots.js
cola-roots.js
daemon-service.js
daemon.js
index.js
hermes-roots.js
extra-roots.js
kiki-migration.js
opencode-roots.js
kimi-roots.js
kiki-roots.js
output.js

Details

From the project README

Vibe Usage

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

Setup

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

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:

npx @vibe-cafe/vibe-usage sync

Other available commands:

CommandDescription
npx @vibe-cafe/vibe-usage syncSync latest usage data
npx @vibe-cafe/vibe-usage statusShow config, detected tools, and how much each tool has uploaded
npx @vibe-cafe/vibe-usage daemon statusCheck the background sync service (installed by first run)
npx @vibe-cafe/vibe-usage resetDelete all data and re-upload
npx @vibe-cafe/vibe-usage reset --localDelete 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

Comments

Markdown supported