ccrecall 0.0.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Scott Spence
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,265 @@
+# ccrecall
+
+Sync Claude Code transcripts to SQLite for analytics.
+
+## Install
+
+### Binary (recommended)
+
+| File                                                                                                                  | Platform                  |
+| --------------------------------------------------------------------------------------------------------------------- | ------------------------- |
+| [`ccrecall-linux-x64`](https://github.com/spences10/ccrecall/releases/latest/download/ccrecall-linux-x64)             | Linux (Intel/AMD)         |
+| [`ccrecall-linux-arm64`](https://github.com/spences10/ccrecall/releases/latest/download/ccrecall-linux-arm64)         | Linux (ARM, Raspberry Pi) |
+| [`ccrecall-darwin-x64`](https://github.com/spences10/ccrecall/releases/latest/download/ccrecall-darwin-x64)           | macOS (Intel)             |
+| [`ccrecall-darwin-arm64`](https://github.com/spences10/ccrecall/releases/latest/download/ccrecall-darwin-arm64)       | macOS (Apple Silicon)     |
+| [`ccrecall-windows-x64.exe`](https://github.com/spences10/ccrecall/releases/latest/download/ccrecall-windows-x64.exe) | Windows                   |
+
+Or use curl:
+
+```bash
+# Linux (x64)
+curl -fsSL https://github.com/spences10/ccrecall/releases/latest/download/ccrecall-linux-x64 -o ~/.local/bin/ccrecall && chmod +x ~/.local/bin/ccrecall
+
+# Linux (arm64)
+curl -fsSL https://github.com/spences10/ccrecall/releases/latest/download/ccrecall-linux-arm64 -o ~/.local/bin/ccrecall && chmod +x ~/.local/bin/ccrecall
+
+# macOS (Apple Silicon)
+curl -fsSL https://github.com/spences10/ccrecall/releases/latest/download/ccrecall-darwin-arm64 -o /usr/local/bin/ccrecall && chmod +x /usr/local/bin/ccrecall
+
+# macOS (Intel)
+curl -fsSL https://github.com/spences10/ccrecall/releases/latest/download/ccrecall-darwin-x64 -o /usr/local/bin/ccrecall && chmod +x /usr/local/bin/ccrecall
+```
+
+### From source
+
+Requires [Bun](https://bun.sh) >= 1.0:
+
+```bash
+git clone https://github.com/spences10/ccrecall.git
+cd ccrecall
+bun install
+bun src/index.ts sync
+```
+
+## Usage
+
+```bash
+# Sync transcripts from ~/.claude/projects to SQLite
+ccrecall sync
+
+# Show stats
+ccrecall stats
+
+# Help
+ccrecall --help
+```
+
+### From source
+
+```bash
+bun src/index.ts sync
+bun src/index.ts stats
+```
+
+### Commands
+
+| Command | Description                                |
+| ------- | ------------------------------------------ |
+| `sync`  | Import transcripts and teams (incremental) |
+| `stats` | Show session/message/team/token counts     |
+
+### Options
+
+| Flag              | Description                                             |
+| ----------------- | ------------------------------------------------------- |
+| `-v, --verbose`   | Show files being processed                              |
+| `-d, --db <path>` | Custom database path (default: `~/.claude/ccrecall.db`) |
+
+## Database Schema
+
+```mermaid
+erDiagram
+    sessions ||--o{ messages : contains
+    sessions ||--o{ tool_calls : contains
+    sessions ||--o{ tool_results : contains
+    sessions ||--o| teams : "lead session"
+    messages ||--o{ tool_calls : has
+    messages ||--o{ tool_results : has
+    tool_calls ||--o{ tool_results : produces
+    teams ||--o{ team_members : has
+    teams ||--o{ team_tasks : has
+
+    sessions {
+        text id PK
+        text project_path
+        text git_branch
+        text cwd
+        int first_timestamp
+        int last_timestamp
+        text summary
+    }
+
+    messages {
+        text uuid PK
+        text session_id FK
+        text parent_uuid
+        text type
+        text model
+        text content_text
+        text content_json
+        text thinking
+        int timestamp
+        int input_tokens
+        int output_tokens
+        int cache_read_tokens
+        int cache_creation_tokens
+    }
+
+    tool_calls {
+        text id PK
+        text message_uuid FK
+        text session_id FK
+        text tool_name
+        text tool_input
+        int timestamp
+    }
+
+    tool_results {
+        int id PK
+        text tool_call_id FK
+        text message_uuid FK
+        text session_id FK
+        text content
+        int is_error
+        int timestamp
+    }
+
+    teams {
+        text id PK
+        text name
+        text description
+        text lead_session_id FK
+        int created_at
+    }
+
+    team_members {
+        text id PK
+        text team_id FK
+        text name
+        text agent_type
+        text model
+        text prompt
+        text color
+        text cwd
+        int joined_at
+    }
+
+    team_tasks {
+        text id PK
+        text team_id FK
+        text owner_name
+        text subject
+        text description
+        text status
+        int created_at
+        int completed_at
+    }
+
+    sync_state {
+        text file_path PK
+        int last_modified
+        int last_byte_offset
+    }
+```
+
+### Team/Swarm Support
+
+Syncs team data from `~/.claude/teams/` when Claude Code's swarm mode
+is enabled.
+
+**Why track teams?**
+
+- Debug runaway agents: compare `prompt` (original instructions) vs
+  actual behavior
+- Link swarm runs to sessions and PRs
+- Track task assignments and completion
+
+## Example Queries
+
+```sql
+-- Token usage by project
+SELECT project_path, SUM(input_tokens + output_tokens) as tokens
+FROM sessions s
+JOIN messages m ON m.session_id = s.id
+GROUP BY project_path
+ORDER BY tokens DESC;
+
+-- Daily message count
+SELECT DATE(timestamp/1000, 'unixepoch') as day, COUNT(*) as messages
+FROM messages
+GROUP BY day
+ORDER BY day DESC;
+
+-- Most used models
+SELECT model, COUNT(*) as count
+FROM messages
+WHERE model IS NOT NULL
+GROUP BY model
+ORDER BY count DESC;
+
+-- Tool usage breakdown
+SELECT tool_name, COUNT(*) as count
+FROM tool_calls
+GROUP BY tool_name
+ORDER BY count DESC;
+
+-- Files read in a session
+SELECT tc.tool_name, json_extract(tc.tool_input, '$.file_path') as file
+FROM tool_calls tc
+WHERE tc.tool_name = 'Read' AND tc.session_id = 'your-session-id';
+
+-- Code changes (edits) with before/after
+SELECT
+  json_extract(tc.tool_input, '$.file_path') as file,
+  json_extract(tc.tool_input, '$.old_string') as old,
+  json_extract(tc.tool_input, '$.new_string') as new
+FROM tool_calls tc
+WHERE tc.tool_name = 'Edit';
+
+-- Session cost estimate (Opus 4.5)
+SELECT
+  s.project_path,
+  SUM(m.input_tokens) / 1000000.0 * 15 +
+  SUM(m.output_tokens) / 1000000.0 * 75 +
+  SUM(m.cache_read_tokens) / 1000000.0 * 1.5 +
+  SUM(m.cache_creation_tokens) / 1000000.0 * 18.75 as cost_usd
+FROM sessions s
+JOIN messages m ON m.session_id = s.id
+WHERE m.model LIKE '%opus%'
+GROUP BY s.id
+ORDER BY cost_usd DESC;
+
+-- Teams with member count
+SELECT t.name, t.description, COUNT(tm.id) as members
+FROM teams t
+LEFT JOIN team_members tm ON tm.team_id = t.id
+GROUP BY t.id;
+
+-- Agent prompts for debugging (what were they told to do?)
+SELECT name, prompt FROM team_members WHERE team_id = 'your-team-id';
+
+-- Task status by team
+SELECT team_id, status, COUNT(*) as count
+FROM team_tasks
+GROUP BY team_id, status;
+
+-- Link Teammate tool calls to team configs
+SELECT tc.timestamp, t.name, t.description
+FROM tool_calls tc
+JOIN teams t ON json_extract(tc.tool_input, '$.team_name') = t.name
+WHERE tc.tool_name = 'Teammate';
+```
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,43 @@
+{
+	"name": "ccrecall",
+	"version": "0.0.4",
+	"description": "Sync Claude Code transcripts to SQLite and recall context from past sessions",
+	"type": "module",
+	"bin": {
+		"ccrecall": "./src/index.ts"
+	},
+	"scripts": {
+		"dev": "bun src/index.ts",
+		"start": "bun src/index.ts",
+		"build": "bun build --compile src/index.ts --outfile ccrecall",
+		"test": "bun test",
+		"format": "prettier --write .",
+		"format:check": "prettier --check .",
+		"lint": "bun run --bun tsc --noEmit",
+		"changeset": "changeset",
+		"version": "changeset version",
+		"release": "bun run build && changeset publish"
+	},
+	"devDependencies": {
+		"@changesets/cli": "^2.29.8",
+		"@types/bun": "latest",
+		"prettier": "^3.8.1",
+		"typescript": "^5.9.3"
+	},
+	"files": [
+		"src"
+	],
+	"keywords": [
+		"claude",
+		"claude-code",
+		"analytics",
+		"sqlite",
+		"memory",
+		"context",
+		"recall"
+	],
+	"license": "MIT",
+	"dependencies": {
+		"citty": "^0.2.0"
+	}
+}

package/src/cli.ts

@@ -0,0 +1,113 @@
+import { defineCommand } from 'citty';
+import { join } from 'path';
+
+const DEFAULT_DB_PATH = join(Bun.env.HOME!, '.claude', 'ccrecall.db');
+
+const sharedArgs = {
+	db: {
+		type: 'string' as const,
+		alias: 'd',
+		description: `Database path (default: ${DEFAULT_DB_PATH})`,
+	},
+};
+
+export const sync = defineCommand({
+	meta: {
+		name: 'sync',
+		description: 'Sync Claude Code transcripts to database',
+	},
+	args: {
+		...sharedArgs,
+		verbose: {
+			type: 'boolean',
+			alias: 'v',
+			description: 'Show detailed output',
+		},
+	},
+	async run({ args }) {
+		const { Database } = await import('./db.ts');
+		const { sync: syncTranscripts } = await import('./sync.ts');
+		const { sync_teams } = await import('./sync-teams.ts');
+
+		const db_path = args.db ?? DEFAULT_DB_PATH;
+		const db = new Database(db_path);
+
+		try {
+			console.log('Syncing transcripts...');
+			const result = await syncTranscripts(db, args.verbose);
+			console.log('Syncing teams...');
+			const team_result = await sync_teams(db, args.verbose);
+			console.log(`
+Done!
+  Files scanned:    ${result.files_scanned}
+  Files processed:  ${result.files_processed}
+  Messages added:   ${result.messages_added}
+  Sessions found:   ${result.sessions_added}
+  Tool calls:       ${result.tool_calls_added}
+  Tool results:     ${result.tool_results_added}
+  Teams synced:     ${team_result.teams_synced}
+  Team members:     ${team_result.members_synced}
+  Team tasks:       ${team_result.tasks_synced}
+`);
+		} finally {
+			db.close();
+		}
+	},
+});
+
+export const stats = defineCommand({
+	meta: {
+		name: 'stats',
+		description: 'Show database statistics',
+	},
+	args: {
+		...sharedArgs,
+	},
+	async run({ args }) {
+		const { Database } = await import('./db.ts');
+
+		const db_path = args.db ?? DEFAULT_DB_PATH;
+		const db = new Database(db_path);
+
+		try {
+			const s = db.get_stats();
+			console.log(`
+Database: ${db_path}
+  Sessions:     ${s.sessions}
+  Messages:     ${s.messages}
+  Tool calls:   ${s.tool_calls}
+  Tool results: ${s.tool_results}
+  Teams:        ${s.teams}
+  Team members: ${s.team_members}
+  Team tasks:   ${s.team_tasks}
+  Tokens:
+    Input:          ${s.tokens.input?.toLocaleString() ?? 0}
+    Output:         ${s.tokens.output?.toLocaleString() ?? 0}
+    Cache read:     ${s.tokens.cache_read?.toLocaleString() ?? 0}
+    Cache creation: ${s.tokens.cache_creation?.toLocaleString() ?? 0}
+`);
+		} finally {
+			db.close();
+		}
+	},
+});
+
+export const main = defineCommand({
+	meta: {
+		name: 'ccrecall',
+		version: '0.0.3',
+		description:
+			'Sync Claude Code transcripts to SQLite and recall context from past sessions',
+	},
+	args: {
+		db: {
+			type: 'string',
+			alias: 'd',
+			description: `Database path (default: ${DEFAULT_DB_PATH})`,
+		},
+	},
+	subCommands: {
+		sync,
+		stats,
+	},
+});