@code-insights/cli 2.1.0 → 3.0.1

package/CHANGELOG.md

@@ -2,6 +2,45 @@
 
 All notable changes to `@code-insights/cli` will be documented in this file.
 
+## [3.0.0] - 2026-02-28
+
+See [MIGRATION.md](../MIGRATION.md) for the full upgrade guide from v2.
+
+### Breaking Changes
+
+- **Firebase removed** — No Firestore sync, no Firebase credentials, no service account required. All data is stored locally in SQLite at `~/.code-insights/data.db`.
+- **`connect` command removed** — Generated Firebase connection URLs. No longer needed.
+- **`init` config format changed** — v2 config had Firebase credentials fields. v3 config has only sync settings and optional LLM config. Re-run `code-insights init` after upgrading.
+- **Data source changed to SQLite** — v2 wrote to Firestore. v3 writes to local SQLite. Existing Firestore data is not migrated. Re-sync with `code-insights sync --force`.
+- **Hosted dashboard removed** — The dashboard at code-insights.app is no longer maintained.
+
+### Added
+
+- **`dashboard` command** — Starts a local Hono server and opens the built-in React SPA at `localhost:7890`. Replaces the hosted dashboard.
+- **Embedded Vite + React SPA** — Full browser dashboard for session browsing, analytics, and insights. No external URL required.
+- **Server-side LLM analysis** — API keys are stored and used server-side. No key exposure to the browser.
+- **Multi-tool support** — Session providers for Cursor, Codex CLI, and Copilot CLI (in addition to Claude Code).
+- **`config llm` command** — Interactive and non-interactive LLM provider configuration (Anthropic, OpenAI, Gemini, Ollama).
+- **`--source <tool>` flag on `sync`** — Sync only from a specific tool.
+- **`--verbose` flag on `sync`** — Show diagnostic warnings from providers.
+- **`--regenerate-titles` flag on `sync`** — Regenerate session titles from content.
+- **`--no-sync` flag on `stats`** — Skip auto-sync before displaying analytics.
+
+### Changed
+
+- **`init`** — No longer requires Firebase credentials. Sets up local SQLite database and config only.
+- **`open`** — Now opens `localhost:7890` (local dashboard server) instead of code-insights.app.
+- **`reset`** — Clears local SQLite database and sync state instead of Firestore data.
+- **`sync`** — Writes to local SQLite instead of Firestore.
+- **`status`** — Reports SQLite session counts and local sync state.
+
+## [2.1.0] - 2026-02-27
+
+### Added
+- **CopilotProvider** — VS Code Copilot Chat session support (`sourceTool: 'copilot'`)
+- **`status` command multi-tool summary** — displays session counts broken down by source tool (Claude Code, Cursor, Codex CLI, Copilot)
+- **`reset` now clears `stats` collection** — ensures the `stats/usage` document is wiped on full reset
+
 ## [2.0.0] - 2026-02-26
 
 ### Added

package/README.md

@@ -1,262 +1,252 @@
 # Code Insights CLI
 
-Command-line tool that parses AI coding session history and provides terminal analytics. Optionally syncs to your own Firebase Firestore for the web dashboard.
+Analyze AI coding sessions from the terminal. Parses session history from Claude Code, Cursor, Codex CLI, and Copilot CLI — stores everything in a local SQLite database — and serves a built-in browser dashboard.
 
-Full documentation: [docs.code-insights.app](https://docs.code-insights.app)
+**Local-first. No accounts. No cloud. No data leaves your machine.**
 
-## Prerequisites
-
-- **Node.js** 18 or later
-- **For local-only stats:** No additional setup required
-- **For Firebase sync + web dashboard:** A Firebase project with Firestore enabled (see [Quick Start](https://docs.code-insights.app/getting-started/quick-start/))
-
-## Installation
+## Install
 
 ```bash
 npm install -g @code-insights/cli
 ```
 
-Verify it works:
+Verify:
 
 ```bash
 code-insights --version
 ```
 
-## Commands
-
-### `code-insights init`
-
-Configure Code Insights with your data source preference and optional Firebase credentials.
+## Quick Start
 
 ```bash
-# Quick setup — import directly from files (recommended)
-code-insights init \
-  --from-json ~/Downloads/serviceAccountKey.json \
-  --web-config ~/Downloads/firebase-web-config.js
-
-# Interactive setup — prompts for data source + credentials
+# 1. Initialize (creates ~/.code-insights/ config and database)
 code-insights init
-```
-
-**Flags:**
-- `--from-json <path>` — Path to the Firebase service account key (auto-sets data source to Firebase)
-- `--web-config <path>` — Path to the Firebase web SDK config (JSON or JS snippet)
 
-During interactive setup, the CLI first asks for your preferred data source:
-- **Local** (recommended) — Stats read from local session files. No Firebase required.
-- **Firebase** — Stats read from Firestore. Requires Firebase credentials.
-
-Configuration is stored in `~/.code-insights/config.json`. Web config is stored separately in `~/.code-insights/web-config.json`.
+# 2. Sync sessions from all detected AI tools
+code-insights sync
 
-### `code-insights stats`
+# 3. Open the built-in dashboard
+code-insights dashboard
+```
 
-Terminal analytics for your AI coding sessions. Works without Firebase.
+The dashboard opens at `http://localhost:7890` and shows your sessions, analytics, and LLM-powered insights.
 
-```bash
-# Dashboard overview (default: last 7 days)
-code-insights stats
+## Supported Tools
 
-# Cost breakdown by project and model
-code-insights stats cost
+| Tool | Data Location |
+|------|---------------|
+| **Claude Code** | `~/.claude/projects/**/*.jsonl` |
+| **Cursor** | Workspace storage SQLite (macOS, Linux, Windows) |
+| **Codex CLI** | `~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl` |
+| **Copilot CLI** | `~/.copilot/session-state/{id}/events.jsonl` |
 
-# Per-project detail cards with sparklines
-code-insights stats projects
+Sessions from all tools are discovered automatically during sync.
 
-# Today's sessions with time, cost, model details
-code-insights stats today
+## Dashboard
 
-# Model usage distribution and cost chart
-code-insights stats models
+```bash
+code-insights dashboard
 ```
 
-**Shared flags:**
+Opens the built-in React dashboard at `http://localhost:7890`. The dashboard provides:
 
-| Flag | Short | Description |
-|------|-------|-------------|
-| `--local` | | Force local data source (no Firebase) |
-| `--remote` | | Force Firestore data source |
-| `--period <range>` | | Time range: `7d`, `30d`, `90d`, or `all` (default: `7d`) |
-| `--project <name>` | `-p` | Scope to a specific project (fuzzy matching) |
-| `--source <tool>` | `-s` | Filter by source tool (e.g., `claude-code`, `cursor`) |
-| `--no-sync` | | Skip auto-sync before displaying stats |
+- **Session Browser** — search, filter, and view full session details
+- **Analytics** — usage patterns, cost trends, activity charts
+- **LLM Insights** — AI-generated summaries, decisions, learnings, and techniques
+- **Settings** — configure your LLM provider for analysis
 
-### `code-insights config`
+> **Screenshot:** _Coming soon_
 
-View and manage CLI configuration.
+### Custom Port
 
 ```bash
-# Show current configuration
-code-insights config
-
-# Set data source preference
-code-insights config set-source local     # Local-only mode
-code-insights config set-source firebase  # Firebase mode
+code-insights dashboard --port 8080
 ```
 
-### `code-insights connect`
+## CLI Commands
 
-Generate a URL to connect the web dashboard to your Firebase.
+### Setup & Configuration
 
 ```bash
-code-insights connect
-```
+# Interactive setup — prompts for Claude dir, excluded projects, etc.
+code-insights init
 
-The URL includes your Firebase web config base64-encoded as a query parameter. Open it in a browser to connect the dashboard to your Firestore — no manual configuration needed.
+# Show current configuration
+code-insights config
 
-### `code-insights open`
+# Configure LLM provider for session analysis (interactive)
+code-insights config llm
 
-Open the web dashboard in your browser.
+# Configure LLM provider with flags (non-interactive)
+code-insights config llm --provider anthropic --model claude-sonnet-4-20250514 --api-key sk-ant-...
 
-```bash
-# Open the dashboard
-code-insights open
+# Show current LLM configuration
+code-insights config llm --show
 
-# Open filtered to the current project
-code-insights open --project
+# Set a config value (e.g., disable telemetry)
+code-insights config set telemetry false
 ```
 
-If Firebase web config is set up, the URL includes your config for automatic connection.
-
-### `code-insights sync`
-
-Sync sessions from all supported tools to Firestore.
+### Sync
 
 ```bash
-# Sync new/modified sessions
+# Sync new and modified sessions (incremental)
 code-insights sync
 
 # Force re-sync all sessions
 code-insights sync --force
 
-# Preview what would be synced
+# Preview what would be synced (no changes made)
 code-insights sync --dry-run
 
-# Sync specific project only
-code-insights sync --project "my-project"
-
 # Sync only from a specific tool
 code-insights sync --source cursor
+code-insights sync --source claude-code
+code-insights sync --source codex-cli
+code-insights sync --source copilot-cli
+
+# Sync only sessions from a specific project
+code-insights sync --project "my-project"
 
-# Quiet mode (for hooks)
-code-insights sync --quiet
+# Quiet mode (useful for hooks)
+code-insights sync -q
+
+# Show diagnostic warnings from providers
+code-insights sync --verbose
 
 # Regenerate titles for all sessions
 code-insights sync --regenerate-titles
-
-# Sync even when data source is set to local
-code-insights sync --force-remote
 ```
 
-> **Note:** When data source is set to `local`, sync shows a warning and exits. Use `--force-remote` to override, or switch with `config set-source firebase`.
+### Terminal Analytics
 
-### `code-insights status`
+```bash
+# Overview: sessions, cost, activity (last 7 days)
+code-insights stats
 
-Show sync status, statistics, and data source preference.
+# Cost breakdown by project and model
+code-insights stats cost
 
-```bash
-code-insights status
+# Per-project detail cards
+code-insights stats projects
+
+# Today's sessions with time, cost, and model details
+code-insights stats today
+
+# Model usage distribution and cost chart
+code-insights stats models
 ```
 
-Displays:
-- Data source preference (local or Firebase)
-- Configuration status
-- Total sessions synced
-- Projects tracked
-- Last sync time
+**Shared flags for all `stats` subcommands:**
 
-### `code-insights reset`
+| Flag | Description |
+|------|-------------|
+| `--period 7d\|30d\|90d\|all` | Time range (default: `7d`) |
+| `--project <name>` | Scope to a specific project (fuzzy matching) |
+| `--source <tool>` | Filter by source tool |
+| `--no-sync` | Skip auto-sync before displaying stats |
 
-Delete all data from Firestore and reset local sync state.
+### Status & Maintenance
 
 ```bash
-# Interactive (asks for confirmation)
-code-insights reset
+# Show sync statistics (sessions, projects, last sync)
+code-insights status
+
+# Open the local dashboard in your browser (server must already be running)
+code-insights open
 
-# Skip confirmation
+# Delete all local data and reset sync state
 code-insights reset --confirm
 ```
 
-> **Note:** In local mode, this clears the local stats cache only. Firestore data is not affected.
-
-### `code-insights install-hook`
-
-Install a Claude Code hook for automatic sync after each session.
+### Auto-Sync Hook
 
 ```bash
+# Install a Claude Code hook — auto-syncs when sessions end
 code-insights install-hook
+
+# Remove the hook
+code-insights uninstall-hook
 ```
 
-> **Note:** In local mode, the hook is not installed (sync requires Firebase).
+### Telemetry
 
-### `code-insights uninstall-hook`
+Anonymous usage telemetry is opt-out. No PII is collected.
 
-Remove the automatic sync hook.
+```bash
+code-insights telemetry status   # Check current status
+code-insights telemetry disable  # Disable telemetry
+code-insights telemetry enable   # Re-enable telemetry
+```
+
+Alternatively, set the environment variable:
 
 ```bash
-code-insights uninstall-hook
+CODE_INSIGHTS_TELEMETRY_DISABLED=1 code-insights sync
 ```
 
-### `code-insights telemetry`
+## LLM Configuration
 
-Manage anonymous usage telemetry. Telemetry is opt-out and helps improve the CLI.
+Session analysis (summaries, decisions, learnings) requires an LLM provider. Configure it via CLI or the dashboard Settings page.
 
 ```bash
-# Check telemetry status
-code-insights telemetry status
+code-insights config llm
+```
 
-# Disable telemetry
-code-insights telemetry disable
+**Supported providers:**
 
-# Re-enable telemetry
-code-insights telemetry enable
-```
+| Provider | Models | Requires API Key |
+|----------|--------|-----------------|
+| Anthropic | claude-opus-4-6, claude-sonnet-4-6, etc. | Yes |
+| OpenAI | gpt-4o, gpt-4o-mini, etc. | Yes |
+| Google Gemini | gemini-2.0-flash, gemini-2.0-pro, etc. | Yes |
+| Ollama | llama3.2, qwen2.5-coder, etc. | No (local) |
 
-No personally identifiable information is collected. See the [telemetry documentation](https://github.com/melagiri/code-insights) for details.
+API keys are stored in `~/.code-insights/config.json` (mode 0o600, readable only by you).
 
-## How It Works
+## Development
 
-### Session Parsing
+This is a pnpm workspace monorepo with three packages: `cli`, `dashboard`, and `server`.
+
+```bash
+# Clone
+git clone https://github.com/melagiri/code-insights.git
+cd code-insights
 
-The CLI reads JSONL files from `~/.claude/projects/` which contain:
-- User and assistant messages
-- Tool calls (Edit, Write, Bash, etc.)
-- Timestamps and metadata
+# Install all dependencies
+pnpm install
 
-Each session is parsed to extract:
-- Project name and path
-- Start/end times and duration
-- Message counts
-- Tool call statistics
-- Git branch (if available)
-- Claude version
-- Token usage, estimated costs, and model information (when available)
+# Build all packages
+pnpm build
 
-### Incremental Sync
+# Link CLI for local testing
+cd cli && npm link
+code-insights --version
 
-Sync state is tracked in `~/.code-insights/sync-state.json`:
-- File modification times are recorded
-- Only new or modified files are processed
-- Use `--force` to bypass and re-sync everything
+# Watch mode (CLI only)
+cd cli && pnpm dev
+```
 
-### Multi-Device Support
+### Workspace Structure
 
-Project IDs are generated from git remote URLs when available:
-- Same repo on different machines → same project ID
-- Non-git projects fall back to path-based hash
-- Each session records device metadata (hostname, platform)
+```
+code-insights/
+├── cli/        # This package — Node.js CLI, SQLite, providers
+├── dashboard/  # Vite + React SPA
+└── server/     # Hono API server (serves dashboard + REST API)
+```
 
-### Title Generation
+### Contributing
 
-Sessions are automatically titled based on:
-1. Claude's own title (if present in session)
-2. First user message (cleaned up)
-3. Session character detection (deep focus, bug hunt, etc.)
-4. Fallback to timestamp
+See [CONTRIBUTING.md](https://github.com/melagiri/code-insights/blob/master/CONTRIBUTING.md) for code style, PR guidelines, and how to add a new source tool provider.
 
-## Contributing
+## Privacy
 
-See [CONTRIBUTING.md](https://github.com/melagiri/code-insights/blob/master/CONTRIBUTING.md) for development setup, code style, and PR guidelines.
+- All session data is stored in `~/.code-insights/data.db` (SQLite) on your machine
+- No cloud accounts required
+- No data is transmitted anywhere (unless you explicitly use an LLM provider with a remote API key)
+- Anonymous telemetry collects only aggregate usage counts — no session content, no file paths
 
 ## License
 
-MIT License — see [LICENSE](https://github.com/melagiri/code-insights/blob/master/LICENSE) for details.
+MIT — see [LICENSE](https://github.com/melagiri/code-insights/blob/master/LICENSE) for details.