Get Started with roiAI

Analyze your Claude Code usage and AI spend across all your devices

Get comprehensive usage analytics with cross-device sync capabilities

1. Install the roiAI CLI

Choose your preferred installation method:

Using npm (recommended)

npm install -g roiai

Direct Download

Download the pre-built binary for your platform:

View on npm →

Verify Installation

roiai --version

2. Start Analyzing Your Usage

View Local Analytics

roiAI automatically analyzes your Claude Code usage locally. View your analytics anytime:

roiai cc sync

This displays your usage statistics directly in the terminal - no cloud sync required.

Cloud Sync - Unified Analytics Across Devices

Sync your Claude Code usage from all your devices (work laptop, home desktop, etc.) into one comprehensive dashboard:

🔄 Why sync across devices?

  • • Unified view: See total usage across all your machines in one place
  • • Comprehensive analytics: Understand patterns across different work environments
  • • Cost tracking: Get accurate total AI spend regardless of which device you use
  • • Project insights: Analyze how different projects consume AI resources across devices

Step 1: Create an account

Sign Up Free

Step 2: Login from CLI

roiai cc login

Step 3: Sync your data

roiai cc push

This reads your local Claude Code usage data and syncs it to the cloud.

📊 Comprehensive Usage Analytics

roiAI provides deep insights into your Claude Code usage with professional-grade analytics:

Cross-Device Intelligence

  • ✓ Automatic device detection and labeling
  • ✓ Merge usage data from multiple machines
  • ✓ Per-device usage breakdown
  • ✓ Identify which device uses most resources

Advanced Analytics

  • ✓ Real-time cost calculations
  • ✓ Historical trend analysis
  • ✓ Project-based resource allocation
  • ✓ Model performance comparisons

💡 Pro tip: Use cloud sync to consolidate data from your work laptop, home desktop, and any other devices into a single, comprehensive view of your AI usage and spending.

4. Detailed Analytics Features

Usage Metrics

  • • Token usage by model and device
  • • Cost breakdown across all machines
  • • Project-level resource allocation
  • • Cache hit rates and efficiency
  • • Per-session usage analysis
  • • API equivalent cost calculations

Comprehensive Insights

  • • Multi-device usage patterns
  • • Time-based trend analysis
  • • Model efficiency comparisons
  • • Cost optimization recommendations
  • • Peak usage identification
  • • Global usage rankings

Next Steps

1

Explore the Dashboard

After syncing, view your analytics at roiai.fyi/dashboard

2

Check the FAQ

Have questions? Visit our Frequently Asked Questions

3

Join the Community

Get help and share feedback on GitHub

🔒 Your usage data is stored locally by default. Cloud sync is completely optional.

Read our privacy policy to learn more.