Skip to content
Code Insights
Documentation

Migrating from v2

Migrate from Code Insights v2 (Firebase/Bring-Your-Own-Firebase) to v3's local-first SQLite architecture. Step-by-step upgrade guide.

v3 is a complete architectural change. The dashboard, which was a hosted web app at code-insights.app, is now an embedded local server. Firebase and Supabase are gone. All data lives in a local SQLite database.

What changed

Aspectv2v3
Data storageYour Firebase FirestoreLocal SQLite at ~/.code-insights/data.db
DashboardHosted at code-insights.appEmbedded at localhost:7890
AuthSupabase (Google/GitHub OAuth)None required
Setup9 steps (Firebase project, Firestore, keys)3 steps (install, sync, dashboard)
PrivacyYour data in your FirebaseData never leaves your machine

Migration steps

  1. Install v3:

    npm install -g @code-insights/cli@latest

  2. Initialize:

    code-insights init

  3. Sync sessions:

    code-insights sync

    Sessions are re-discovered from your local AI coding tool files. The sync is not reading from Firebase — it re-parses the original session files.

  4. Open the dashboard:

    code-insights dashboard

Your Firebase data

Your Firebase Firestore data is untouched. v3 doesn't access Firebase at all. If you want to keep both, you can — v3 and v2 are completely independent.

If you want to delete your Firebase data, do so through the Firebase Console.

The code-insights.app dashboard

The hosted web dashboard at code-insights.app has been repurposed as a marketing and documentation site. It no longer serves the session dashboard. All dashboard functionality is now in the embedded local dashboard at localhost:7890.

Troubleshooting