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

``bash
npm install -g vibetime
`

Quick Start

`bash


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:

`bash


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!

$3

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!

$3

`bash


Run this command

vibetime config set

It will ask for your API key

Paste the key you copied

Press Enter

`

$3

`bash


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:

$3

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

$3

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

Troubleshooting

$3

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

$3

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

$3

- 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