cc-query 0.2.0 → 0.2.1

package/README.md

@@ -0,0 +1,55 @@
+# cc-query
+
+SQL REPL for querying Claude Code session data using DuckDB.
+
+## Installation
+
+```bash
+npm install -g cc-query
+```
+
+Requires Node.js 24+.
+
+## Usage
+
+```bash
+# Query all projects
+cc-query
+
+# Query a specific project
+cc-query ~/code/my-project
+
+# Filter by session ID prefix
+cc-query -s abc123 .
+
+# Pipe queries (like psql)
+echo "SELECT count(*) FROM messages;" | cc-query .
+```
+
+## Available Views
+
+- `messages` - All messages with parsed fields
+- `user_messages` - User messages only
+- `assistant_messages` - Assistant responses only
+- `tool_calls` - Tool invocations from assistant messages
+- `raw_messages` - Unparsed JSONL data
+
+## REPL Commands
+
+- `.help` - Show tables and example queries
+- `.schema` - Show table schema
+- `.quit` - Exit
+
+## Skill (experimental)
+
+This [skill](https://gist.github.com/dannycoates/b4436fb77c9cfd2763028eee42d1d320) gives claude the ability and slash command `/reflect` to work with claude session history.
+
+For example you can ask questions like:
+- Across all projects what bash commands return the most errors?
+- Let's analyze the last session and identify how we might improve the claude.md file
+- Gimme a summary of what we worked on this past week
+- Let's go though our whole session history and identify repeated patterns that we could extract into skills
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-query",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "SQL REPL for querying Claude Code session data",
   "type": "module",
   "exports": {

package/src/query-session.js

@@ -91,13 +91,13 @@ function formatResults(result) {
 export class QuerySession {
   /** @type {import("@duckdb/node-api").DuckDBConnection | undefined} */
   #connection;
-  /** @type {string} */
+  /** @type {string | string[]} */
   #filePattern;
   /** @type {QuerySessionInfo} */
   #info;
 
   /**
-   * @param {string} filePattern - Glob pattern for JSONL files
+   * @param {string | string[]} filePattern - Glob pattern(s) for JSONL files
    * @param {QuerySessionInfo} info - Session counts
    */
   constructor(filePattern, info) {
@@ -105,6 +105,19 @@ export class QuerySession {
     this.#info = info;
   }
 
+  /**
+   * Format file pattern for use in DuckDB SQL
+   * @returns {string} SQL expression for the file pattern
+   */
+  #formatFilePatternForSql() {
+    if (Array.isArray(this.#filePattern)) {
+      // DuckDB accepts a list of patterns: ['pattern1', 'pattern2']
+      const patterns = this.#filePattern.map((p) => `'${p}'`).join(", ");
+      return `[${patterns}]`;
+    }
+    return `'${this.#filePattern}'`;
+  }
+
   /**
    * Create a QuerySession from a project path
    * @param {string | null} projectDir - Claude projects dir, or null for all
@@ -290,7 +303,7 @@ export class QuerySession {
       regexp_extract(filename, '/projects/([^/]+)/', 1) as project,
       ordinality as rownum
     FROM read_ndjson(
-      '${this.#filePattern}',
+      ${this.#formatFilePatternForSql()},
       filename=true,
       ignore_errors=true,
       columns={${columnsDef}}
@@ -342,7 +355,7 @@ export class QuerySession {
     SELECT
       (json->>'uuid')::UUID as uuid,
       json as raw
-    FROM read_ndjson_objects('${this.#filePattern}', ignore_errors=true)
+    FROM read_ndjson_objects(${this.#formatFilePatternForSql()}, ignore_errors=true)
     WHERE json->>'uuid' IS NOT NULL AND length(json->>'uuid') > 0;
 
     -- Tool uses: All tool calls with unnested content blocks

package/src/session-loader.js

@@ -42,7 +42,7 @@ function countSessionsAndAgents(files, sessionFilter = "") {
  * Get session info and file pattern for querying
  * @param {string | null} claudeProjectsDir - Path to ~/.claude/projects/{slug}, or null for all projects
  * @param {string} [sessionFilter] - Optional session ID prefix
- * @returns {Promise<{ sessionCount: number, agentCount: number, projectCount: number, filePattern: string }>}
+ * @returns {Promise<{ sessionCount: number, agentCount: number, projectCount: number, filePattern: string | string[] }>}
  */
 export async function getSessionFiles(claudeProjectsDir, sessionFilter = "") {
   // If no specific project, use all projects
@@ -72,8 +72,13 @@ export async function getSessionFiles(claudeProjectsDir, sessionFilter = "") {
     }
 
     // Use glob pattern for all projects (** for recursive matching)
+    // When session filter is provided, include both the filtered session AND its subagents
+    // Subagents are stored in {session_id}/subagents/*.jsonl
     const filePattern = sessionFilter
-      ? join(base, "*", `**/${sessionFilter}*.jsonl`)
+      ? [
+          join(base, "*", `${sessionFilter}*.jsonl`),
+          join(base, "*", `${sessionFilter}*/subagents/*.jsonl`),
+        ]
       : join(base, "*", "**/*.jsonl");
 
     return {
@@ -93,9 +98,14 @@ export async function getSessionFiles(claudeProjectsDir, sessionFilter = "") {
     return { sessionCount: 0, agentCount: 0, projectCount: 1, filePattern: "" };
   }
 
-  // Use glob pattern with ** for recursive matching
+  // Use glob pattern for matching
+  // When session filter is provided, include both the filtered session AND its subagents
+  // Subagents are stored in {session_id}/subagents/*.jsonl
   const filePattern = sessionFilter
-    ? join(claudeProjectsDir, `**/${sessionFilter}*.jsonl`)
+    ? [
+        join(claudeProjectsDir, `${sessionFilter}*.jsonl`),
+        join(claudeProjectsDir, `${sessionFilter}*/subagents/*.jsonl`),
+      ]
     : join(claudeProjectsDir, "**/*.jsonl");
 
   return {