Quick Start

This guide assumes you’ve already installed the CLI and set up Firebase. If not, do those first.

1. Configure the CLI

Point the CLI at your Firebase project using the two JSON files from the Firebase setup:

code-insights init \
  --from-json ~/Downloads/serviceAccountKey.json \
  --web-config ~/Downloads/firebase-web-config.js

The CLI reads both files and configures everything automatically. No manual copy-pasting needed.

Tip

You can also run code-insights init without flags for an interactive setup wizard that prompts for each value.

2. Sync Your Sessions

code-insights sync

This parses all Claude Code JSONL files in ~/.claude/projects/ and uploads them to your Firestore. The first sync may take a moment depending on how many sessions you have.

Note

If you have months of Claude Code history, the initial sync may exceed Firebase’s free tier write limits. Consider temporarily upgrading to the Blaze plan (pay-as-you-go) for the initial sync. The cost is negligible. Subsequent syncs are incremental and stay well within the free tier.

3. Open the Dashboard

code-insights connect

This generates a URL to code-insights.app with your Firebase config encoded in the link. Open it in your browser, sign in with Google or GitHub, and you’ll see your synced sessions.

4. Set Up Auto-Sync (Optional)

code-insights install-hook

This installs a Claude Code hook that automatically runs code-insights sync -q whenever a session ends. Your dashboard stays up to date without manual syncs.

What’s Next

• Syncing Sessions — Learn about incremental sync, filtering, and force re-sync
• Web Dashboard — Explore what the dashboard offers
• CLI Commands — Full reference for every command and flag