vibetime

Track your Claude AI usage and costs. Sync to cloud dashboard.

Built on ccusage by @ryoppippi ❤️

What is vibetime?

vibetime = ccusage + cloud sync

• 📊 All ccusage commands work perfectly (no setup needed)
• ☁️ Sync your data to cloud dashboard (needs API key)
• 🌐 View your stats online at vibetime.ekusiadadus.workers.dev

Install

npm install -g vibetime

Quick Start

# See your Claude usage (works immediately!)
vibetime daily
vibetime monthly
vibetime session
vibetime blocks

ccusage Commands (No Setup Needed)

All ccusage commands work out of the box:

# Daily usage
vibetime daily
vibetime daily -j                 # Output as JSON
vibetime daily -b                 # Show cost per model

# Monthly usage
vibetime monthly
vibetime monthly -j               # Output as JSON

# Session usage (5-hour blocks)
vibetime session
vibetime blocks                   # Same as session
vibetime blocks --live            # Live monitoring

Cloud Sync (Optional)

Want to see your usage online? Sync to our free dashboard!

Step 1: Get Your FREE API Key

1. Go to: https://vibetime.ekusiadadus.workers.dev

2. Click "Sign Up" (top right corner)

   • Use your email
   • Or sign in with Google/GitHub

3. After login, click your name (top right)

   • Select "API Keys"
   • Click "Create New API Key"
   • Give it a name like "My CLI"
   • Click "Create"

4. Copy your API key

   • It looks like: vt_abc123xyz...
   • ⚠️ Save it! You can't see it again!

Step 2: Set Up Your API Key

# Run this command
vibetime config set

# It will ask for your API key
# Paste the key you copied
# Press Enter

Step 3: Sync Your Data

# Upload all your Claude usage
vibetime sync

# That's it! View online at:
# https://vibetime.ekusiadadus.workers.dev

Only 2 Extra Commands

vibetime adds only 2 commands to ccusage:

1. Config Command

vibetime config          # See your settings
vibetime config set      # Add/change API key
vibetime config reset    # Remove API key

2. Sync Command

vibetime sync            # Upload your data
vibetime sync --dry-run  # See what would upload

Troubleshooting

"No data found"

• Use Claude AI first (claude.ai)
• Data appears after you chat with Claude

"API key required"

• Get free key at: https://vibetime.ekusiadadus.workers.dev
• Run: vibetime config set

Sync not working?

• Check key: vibetime config
• Try: vibetime test

That's All!

• Local usage: All ccusage commands work perfectly
• Cloud sync: Just 2 simple commands (config and sync)
• Dashboard: https://vibetime.ekusiadadus.workers.dev

Credits

• Built on ccusage by @ryoppippi
• Created by @ekusiadadus

License

MIT

Made with ❤️ for Claude AI users