CodeRadar CLI

Track projects, monitor Claude Code usage, analyze costs — from your terminal.

Quick Start

# Sync local data to cloud dashboard
npx coderadar sync --token <your-token>

# Generate local HTML dashboard (offline mode)
npx coderadar generate

Installation

# Run directly with npx (recommended)
npx coderadar

# Or install globally
npm install -g coderadar

Commands

coderadar sync

Sync local project data to the cloud dashboard.

coderadar sync --token <your-token>

Options:

• --token <token> - Your cloud dashboard authentication token
• --url <url> - Custom cloud URL (defaults to https://coderadar-guillaumebeylounehs-projects.vercel.app)

coderadar generate

Generate a static HTML dashboard from local data (offline mode).

coderadar generate

The dashboard is saved to ~/.coderadar/dashboard.html and automatically opens in your browser.

coderadar init

Interactive setup wizard to configure your CodeRadar installation.

coderadar init

coderadar config

Manage configuration settings.

# Set cloud token
coderadar config set cloudToken <token>

# Set cloud URL
coderadar config set cloudUrl <url>

# View current configuration
coderadar config list

Cloud Dashboard

Access your cloud dashboard at: https://coderadar-guillaumebeylounehs-projects.vercel.app

The cloud dashboard provides:

• Real-time project monitoring across devices
• AI-powered summaries and insights (Pro tier)
• Team collaboration features (Team tier)
• Multi-currency budget tracking (Pro tier)
• PDF exports and Slack/Discord webhooks (Team tier)

How It Works

CodeRadar CLI scans your local development environment to collect:

1. Project Data

   • Git statistics (commits, branches, contributors)
   • Project health scores
   • Technology stack detection
   • Last activity timestamps

2. Claude Code Sessions

   • Session history and duration
   • Model usage (Opus 4.6, Sonnet 4.5, etc.)
   • Token consumption
   • Conversation contexts

3. API Costs

   • Token-based cost calculations
   • Budget tracking and alerts
   • Spending trends over time

All data is synced to the cloud dashboard for cross-device access, team sharing, and advanced analytics.

Requirements

• Node.js >= 18.0.0
• Git (for project scanning)
• Claude Code (for session tracking)

Privacy

CodeRadar CLI respects your privacy:

• All data stays local by default
• Cloud sync is opt-in (requires explicit --token)
• No telemetry or analytics unless synced
• Open source and auditable

License

MIT License - Copyright (c) 2026 Guillaume Beylouneh

Links

• GitHub Repository
• Cloud Dashboard
• Issue Tracker

Author

Guillaume Beylouneh