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)1 command (install, then run code-insights)
PrivacyYour data in your FirebaseData never leaves your machine

Migration steps

  1. Install v3:

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

  2. Run Code Insights:

    code-insights

    This syncs all your sessions and opens the dashboard automatically. Sessions are re-discovered from your local AI coding tool files — v3 does not read from Firebase.

    code-insights init is optional. The first run auto-detects your tools and sets up the database without it. Run code-insights init only if you want to customize settings like which tools to include.

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