vibetime/README.md

Track your Claude AI usage and costs. Built on ccusage. See rankings, sync data, and monitor your AI spending. Works with all Claude models.

# vibetime

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

[![npm version](https://img.shields.io/npm/v/vibetime.svg)](https://www.npmjs.com/package/vibetime)
[![license](https://img.shields.io/npm/l/vibetime.svg)](https://github.com/ekusiadadus/vibetime/blob/main/LICENSE)
[![downloads](https://img.shields.io/npm/dm/vibetime.svg)](https://www.npmjs.com/package/vibetime)

> Built on [ccusage](https://github.com/ryoppippi/ccusage) by [@ryoppippi](https://github.com/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](https://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!

### 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

```bash
# 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

```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:

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

### 2. Sync Command
```bash
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](https://github.com/ryoppippi/ccusage) by [@ryoppippi](https://github.com/ryoppippi)
- Created by [@ekusiadadus](https://github.com/ekusiadadus)

## License

MIT

---

**Made with ❤️ for Claude AI users**