spooling 0.2.8__tar.gz → 0.2.10__tar.gz

{spooling-0.2.8/spooling.egg-info → spooling-0.2.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spooling
-Version: 0.2.8
+Version: 0.2.10
 Summary: Local session tracker and semantic search for AI coding assistants
 Author: Parsed Analytics, Inc.
 License: MIT
@@ -38,7 +38,7 @@ Dynamic: license-file
 
 Local session tracker and semantic search for AI coding assistants.
 
-Track your AI coding sessions across **OpenAI Codex CLI**, **GitHub Copilot**, **Cursor**, **Windsurf**, **Kiro**, **Google Antigravity**, and **opencode**, all in one place. Get usage stats, cost estimates, per-provider breakdowns, semantic search, and a built-in AI chat agent to explore your history.
+Track your AI coding sessions across **Claude Code**, **OpenAI Codex CLI**, **GitHub Copilot**, **Cursor**, **Windsurf**, **Kiro**, **Google Antigravity**, and **opencode**, all in one place. Get usage stats, cost estimates, per-provider breakdowns, semantic search, and a built-in AI chat agent to explore your history.
 
 **Website:** [spooling.ai](https://spooling.ai)
 
@@ -142,6 +142,7 @@ spooling sync                      # Full sync with embeddings
 spooling sync --no-embed           # Skip embeddings (faster initial sync)
 spooling sync -p cursor            # Sync only Cursor sessions
 spooling sync -p codex             # Sync only Codex CLI sessions
+spooling sync -p claude-code       # Sync only Claude Code sessions
 ```
 
 ### `spooling stats`
@@ -639,6 +640,7 @@ All optional — defaults work out of the box.
 
 | Provider | Data Location | Format |
 |----------|--------------|--------|
+| **Claude Code** | `~/.claude/projects/` (or `$CLAUDE_CONFIG_DIR/projects`) | `<project>/<session-uuid>.jsonl` transcripts with per-message token usage, prompt-cache reads/writes, tool calls and git context |
 | **JSONL Sessions** | `~/.sessions/projects/` | UUID-named JSONL files with conversation history, tool calls, git context |
 | **OpenAI Codex CLI** | `~/.codex/sessions/` | `rollout-*.jsonl` files organized by date |
 | **GitHub Copilot** | `~/Library/Application Support/Code/User/workspaceStorage/` | Chat session JSON from VS Code |
@@ -650,5 +652,7 @@ All optional — defaults work out of the box.
 
 Run `spooling init` to see which providers are detected on your system.
 
+**Claude Code notes.** Sessions are detected automatically; there is nothing to connect. Cost is computed from each message's real token usage (including prompt-cache reads and writes) at the model's list price, so it reflects API-equivalent spend, not what a subscription plan charges. The project name is the session's working directory. To read transcripts from somewhere else, set `CLAUDE_CONFIG_DIR` or add `{"claude-code": "/path/to/projects"}` to `~/.config/spooling/paths.json`. Subagent transcripts (stored in separate files under `<session>/subagents/` by recent Claude Code versions) are not included yet.
+
 Nothing leaves your machine unless you opt in: Spooling Cloud (`spooling push`), a tunnel (`spooling tunnel`), or the Anthropic chat provider. `spooling pricing refresh` downloads public model prices but sends none of your data.
 

{spooling-0.2.8 → spooling-0.2.10}/README.md

@@ -2,7 +2,7 @@
 
 Local session tracker and semantic search for AI coding assistants.
 
-Track your AI coding sessions across **OpenAI Codex CLI**, **GitHub Copilot**, **Cursor**, **Windsurf**, **Kiro**, **Google Antigravity**, and **opencode**, all in one place. Get usage stats, cost estimates, per-provider breakdowns, semantic search, and a built-in AI chat agent to explore your history.
+Track your AI coding sessions across **Claude Code**, **OpenAI Codex CLI**, **GitHub Copilot**, **Cursor**, **Windsurf**, **Kiro**, **Google Antigravity**, and **opencode**, all in one place. Get usage stats, cost estimates, per-provider breakdowns, semantic search, and a built-in AI chat agent to explore your history.
 
 **Website:** [spooling.ai](https://spooling.ai)
 
@@ -106,6 +106,7 @@ spooling sync                      # Full sync with embeddings
 spooling sync --no-embed           # Skip embeddings (faster initial sync)
 spooling sync -p cursor            # Sync only Cursor sessions
 spooling sync -p codex             # Sync only Codex CLI sessions
+spooling sync -p claude-code       # Sync only Claude Code sessions
 ```
 
 ### `spooling stats`
@@ -603,6 +604,7 @@ All optional — defaults work out of the box.
 
 | Provider | Data Location | Format |
 |----------|--------------|--------|
+| **Claude Code** | `~/.claude/projects/` (or `$CLAUDE_CONFIG_DIR/projects`) | `<project>/<session-uuid>.jsonl` transcripts with per-message token usage, prompt-cache reads/writes, tool calls and git context |
 | **JSONL Sessions** | `~/.sessions/projects/` | UUID-named JSONL files with conversation history, tool calls, git context |
 | **OpenAI Codex CLI** | `~/.codex/sessions/` | `rollout-*.jsonl` files organized by date |
 | **GitHub Copilot** | `~/Library/Application Support/Code/User/workspaceStorage/` | Chat session JSON from VS Code |
@@ -614,5 +616,7 @@ All optional — defaults work out of the box.
 
 Run `spooling init` to see which providers are detected on your system.
 
+**Claude Code notes.** Sessions are detected automatically; there is nothing to connect. Cost is computed from each message's real token usage (including prompt-cache reads and writes) at the model's list price, so it reflects API-equivalent spend, not what a subscription plan charges. The project name is the session's working directory. To read transcripts from somewhere else, set `CLAUDE_CONFIG_DIR` or add `{"claude-code": "/path/to/projects"}` to `~/.config/spooling/paths.json`. Subagent transcripts (stored in separate files under `<session>/subagents/` by recent Claude Code versions) are not included yet.
+
 Nothing leaves your machine unless you opt in: Spooling Cloud (`spooling push`), a tunnel (`spooling tunnel`), or the Anthropic chat provider. `spooling pricing refresh` downloads public model prices but sends none of your data.
 

{spooling-0.2.8 → spooling-0.2.10}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "spooling"
-version = "0.2.8"
+version = "0.2.10"
 description = "Local session tracker and semantic search for AI coding assistants"
 readme = "README.md"
 authors = [{ name = "Parsed Analytics, Inc." }]

{spooling-0.2.8 → spooling-0.2.10}/spooling/cli.py

@@ -64,7 +64,7 @@ def init():
 
 @cli.command()
 @click.option("--no-embed", is_flag=True, help="Skip embedding (faster sync)")
-@click.option("--provider", "-p", default=None, help="Only sync a specific provider (jsonl-session, codex, cursor, copilot, windsurf)")
+@click.option("--provider", "-p", default=None, help="Only sync a specific provider (claude-code, jsonl-session, codex, cursor, copilot, windsurf)")
 def sync(no_embed, provider):
     """Sync AI coding sessions to the database."""
     from spooling.ingest import sync as do_sync

{spooling-0.2.8 → spooling-0.2.10}/spooling/cloud.py

@@ -4,13 +4,17 @@ import json
 import os
 import re
 import signal
+import socket
+import ssl
 import time
 from datetime import datetime, timedelta, timezone
 from pathlib import Path
+from urllib.parse import urlparse
 
 import click
 import httpx
 from rich.console import Console
+from rich.markup import escape
 
 from spooling.db import get_connection
 from spooling.redact import redact_messages, redact_traces
@@ -70,6 +74,143 @@ def _api_base() -> str:
     return cfg.get("api_url") or os.environ.get("SPOOLING_CLOUD_URL") or DEFAULT_API
 
 
+# --- Friendly network errors -------------------------------------------------
+#
+# Raw exceptions like "[Errno 8] nodename nor servname provided, or not known"
+# tell a user nothing. Everything that talks to the cloud funnels its errors
+# through _explain_error / _explain_http so they get a plain-English cause and
+# the next step.
+
+_SELF_HOST_HINT = (
+    "Using a self-hosted or staging server? Point the CLI at it with\n"
+    "    spooling cloud login --key sk_... --api-url https://your-host\n"
+    "  or set SPOOLING_CLOUD_URL."
+)
+
+
+def _host_port(base: str) -> tuple[str, int]:
+    try:
+        u = urlparse(base)
+        host = u.hostname or base
+        port = u.port or (80 if u.scheme == "http" else 443)
+    except ValueError:  # e.g. port out of range in a hand-typed URL
+        return base, 443
+    return host, port
+
+
+def _exc_chain(e: BaseException):
+    seen = set()
+    while e is not None and id(e) not in seen:
+        seen.add(id(e))
+        yield e
+        e = e.__cause__ or e.__context__
+
+
+_DNS_MARKERS = (
+    "nodename nor servname",          # macOS
+    "name or service not known",      # Linux (glibc)
+    "temporary failure in name resolution",
+    "no address associated with hostname",
+    "getaddrinfo failed",             # Windows
+    "no such host",
+)
+
+
+def _is_dns_error(e: BaseException) -> bool:
+    for x in _exc_chain(e):
+        if isinstance(x, socket.gaierror):
+            return True
+        if any(m in str(x).lower() for m in _DNS_MARKERS):
+            return True
+    return False
+
+
+def _explain_error(e: BaseException, base: str) -> str:
+    """Return a plain-English explanation (rich markup) for a failed request.
+
+    Never raises: it runs inside error handlers, where a second exception would
+    hide the original problem.
+    """
+    try:
+        return _explain_error_impl(e, base)
+    except Exception:  # noqa: BLE001
+        return escape(str(e) or type(e).__name__)
+
+
+def _explain_error_impl(e: BaseException, base: str) -> str:
+    host, port = _host_port(base)
+    chain = list(_exc_chain(e))
+    if _is_dns_error(e):
+        return (
+            f"Can't reach Spooling Cloud at {escape(base)}\n"
+            f"  The hostname '{escape(host)}' doesn't resolve (DNS lookup failed).\n"
+            f"  Either you're offline, or that server doesn't exist (yet).\n"
+            f"  - Offline or on a VPN? Check your connection and try again.\n"
+            f"  - {_SELF_HOST_HINT}"
+        )
+    if any(isinstance(x, ConnectionRefusedError) for x in chain):
+        return (
+            f"Connection refused by {escape(host)}:{port}\n"
+            f"  The host is reachable but nothing is listening. Is the sync server running?\n"
+            f"  - {_SELF_HOST_HINT}"
+        )
+    if isinstance(e, httpx.TimeoutException) or any(isinstance(x, (TimeoutError, socket.timeout)) for x in chain):
+        return (
+            f"Timed out talking to {escape(base)}\n"
+            f"  The server may be starting up or overloaded. Try again in a moment."
+        )
+    if any(isinstance(x, ssl.SSLError) for x in chain):
+        return (
+            f"TLS/SSL error connecting to {escape(host)}\n"
+            f"  {escape(str(e))}\n"
+            f"  Check the server's certificate, and that the URL scheme (http/https) is right."
+        )
+    if isinstance(e, httpx.ConnectError):
+        return f"Can't connect to {escape(base)}: {escape(str(e) or type(e).__name__)}"
+    return escape(str(e) or type(e).__name__)
+
+
+def _explain_http(e: "httpx.HTTPStatusError") -> str:
+    code = e.response.status_code
+    body = escape(e.response.text[:200])
+    if code == 401:
+        return (
+            f"HTTP 401: the server rejected your API key.\n"
+            f"  Create a new key in the admin app (Settings > API keys), then run\n"
+            f"    spooling cloud login --key sk_...\n"
+            f"  {body}"
+        )
+    if code == 403:
+        return f"HTTP 403: this API key isn't allowed to do that (missing scope or no workspace).\n  {body}"
+    if code == 429:
+        retry = e.response.headers.get("retry-after")
+        return f"HTTP 429: rate limited{f', retry in {retry}s' if retry else ''}. Slow down or try again shortly."
+    if code >= 500:
+        return f"HTTP {code}: the server hit an error. This is not a problem with your data; try again shortly.\n  {body}"
+    return f"HTTP {code}: {body}"
+
+
+def _fail(message: str) -> "None":
+    """Print an error and exit non-zero so scripts and cron can detect it."""
+    console.print(f"[red]{message}[/red]")
+    raise click.exceptions.Exit(1)
+
+
+def _preflight(base: str) -> None:
+    """Fail fast, before any sync/redaction work, if the server can't be resolved.
+
+    Only checks DNS (no request is sent, so it works with any server version).
+    Connection-level problems are still reported by the request itself.
+    """
+    host, port = _host_port(base)
+    try:
+        socket.getaddrinfo(host, port, type=socket.SOCK_STREAM)
+    except OSError as e:
+        console.print(f"[red]{_explain_error(e, base)}[/red]")
+        console.print("[dim]Nothing was sent. Your local sessions are untouched.[/dim]")
+        raise click.exceptions.Exit(1)
+
+
 @click.group()
 def cloud():
     """Spooling Cloud: push local sessions to api.spooling.ai."""
@@ -93,8 +234,10 @@ def cloud_login(key: str, api_url: str | None):
         stats = r.json()
         console.print(f"[green]Logged in to {base}[/green]")
         console.print(f"  sessions in cloud: [bold]{stats.get('sessions', 0)}[/bold]")
+    except httpx.HTTPStatusError as e:
+        console.print(f"[red]Saved key, but the server rejected the check:\n  {_explain_http(e)}[/red]")
     except Exception as e:
-        console.print(f"[red]Saved key, but /v1/stats check failed: {e}[/red]")
+        console.print(f"[red]Saved key, but couldn't verify it.\n  {_explain_error(e, base)}[/red]")
 
 
 @cloud.command("status")
@@ -114,8 +257,10 @@ def cloud_status():
         console.print(f"  messages: [bold]{s.get('messages', 0)}[/bold]")
         console.print(f"  providers: [bold]{s.get('providers', 0)}[/bold]")
         console.print(f"  cost: [bold]${s.get('cost', 0):.2f}[/bold]")
+    except httpx.HTTPStatusError as e:
+        _fail(f"{_explain_http(e)}")
     except Exception as e:
-        console.print(f"[red]Error: {e}[/red]")
+        _fail(f"{_explain_error(e, base)}")
 
 
 @cloud.command("logout")
@@ -395,14 +540,9 @@ def _push_trace_batches(
                 else:
                     log(f"  pushed {acc} trace(s), {spans} span(s)")
             except httpx.HTTPStatusError as e:
-                return (
-                    accepted,
-                    rejected,
-                    spans_total,
-                    f"HTTP {e.response.status_code}: {e.response.text[:200]}",
-                )
+                return accepted, rejected, spans_total, _explain_http(e)
             except Exception as e:
-                return accepted, rejected, spans_total, str(e)
+                return accepted, rejected, spans_total, _explain_error(e, base)
     return accepted, rejected, spans_total, None
 
 
@@ -448,9 +588,9 @@ def _push_batches(
                 else:
                     log(f"  pushed {accepted} sessions")
             except httpx.HTTPStatusError as e:
-                return total, rejected, f"HTTP {e.response.status_code}: {e.response.text[:200]}"
+                return total, rejected, _explain_http(e)
             except Exception as e:
-                return total, rejected, str(e)
+                return total, rejected, _explain_error(e, base)
     return total, rejected, None
 
 
@@ -559,6 +699,8 @@ def push(limit: int, batch: int, project: str | None, cwd_substr: str | None, ti
         return
     headers = _auth_headers()
     base = _api_base()
+    if not dry_run:
+        _preflight(base)  # fail fast, before syncing and redacting, if the server can't be reached
     if do_sync:
         _sync_local()
     sessions = _collect_sessions(
@@ -607,8 +749,7 @@ def push(limit: int, batch: int, project: str | None, cwd_substr: str | None, ti
         return
     total, rejected, err = _push_batches(sessions, batch, base, headers, console.print, copy=copy)
     if err:
-        console.print(f"[red]{err}[/red]")
-        return
+        _fail(err)
     if rejected:
         console.print(
             f"[green]Done.[/green] {total} sessions synced to {base} "
@@ -649,8 +790,7 @@ def push(limit: int, batch: int, project: str | None, cwd_substr: str | None, ti
             traces, trace_batch_size, base, headers, console.print,
         )
         if t_err:
-            console.print(f"[yellow]Trace push failed: {t_err}[/yellow]")
-            return
+            _fail(f"Sessions were pushed, but the trace/span upload failed:\n  {t_err}")
         msg = f"[green]Done.[/green] {t_acc} trace(s) and {t_spans} span(s) synced"
         if t_rej:
             msg += f" ([yellow]{t_rej} trace(s) rejected[/yellow])"
@@ -715,7 +855,7 @@ def cloud_watch(interval: int, limit: int, batch: int, lookback: int, no_redact:
                     console.print(f"  [dim]Redacted {redaction_count} secret(s) before push[/dim]")
             total, rejected, err = _push_batches(sessions, batch, base, headers, console.print)
             if err:
-                console.print(f"[red]{err}[/red] (will retry next cycle)")
+                console.print(f"[red]{err.splitlines()[0]}[/red] (will retry next cycle)")
             else:
                 # Advance watermark to the cycle start; the lookback window catches
                 # sessions whose started_at slid backwards or whose messages were
@@ -790,6 +930,7 @@ def cloud_delete(project: str | None, cwd_substr: str | None, session_id: str |
 
     headers = _auth_headers()
     base = _api_base()
+    _preflight(base)
     params = {"dry_run": "true" if dry_run else "false"}
     if project:
         params["project"] = project
@@ -810,10 +951,10 @@ def cloud_delete(project: str | None, cwd_substr: str | None, session_id: str |
         r.raise_for_status()
         data = r.json()
     except httpx.HTTPStatusError as e:
-        console.print(f"[red]HTTP {e.response.status_code}: {e.response.text[:200]}[/red]")
+        console.print(f"[red]{_explain_http(e)}[/red]")
         return
     except Exception as e:
-        console.print(f"[red]{e}[/red]")
+        console.print(f"[red]{_explain_error(e, base)}[/red]")
         return
 
     matched = data.get("matched", 0)
@@ -928,9 +1069,9 @@ def _pull_sessions(
             r = client.get(f"{base}/v1/sessions", headers=headers, params=params)
             r.raise_for_status()
         except httpx.HTTPStatusError as e:
-            return 0, 0, f"HTTP {e.response.status_code}: {e.response.text[:200]}"
+            return 0, 0, _explain_http(e)
         except Exception as e:
-            return 0, 0, str(e)
+            return 0, 0, _explain_error(e, base)
 
         data = r.json()
         cloud_sessions = data.get("sessions", [])
@@ -979,6 +1120,7 @@ def pull(limit: int, batch: int, dry_run: bool):
     """
     headers = _auth_headers()
     base = _api_base()
+    _preflight(base)
 
     cfg = _load_config()
     last = cfg.get("last_pull_at")
@@ -996,10 +1138,10 @@ def pull(limit: int, batch: int, dry_run: bool):
         r = httpx.get(f"{base}/v1/sessions", headers=headers, params=params, timeout=30)
         r.raise_for_status()
     except httpx.HTTPStatusError as e:
-        console.print(f"[red]HTTP {e.response.status_code}: {e.response.text[:200]}[/red]")
+        console.print(f"[red]{_explain_http(e)}[/red]")
         return
     except Exception as e:
-        console.print(f"[red]{e}[/red]")
+        console.print(f"[red]{_explain_error(e, base)}[/red]")
         return
 
     data = r.json()
@@ -1070,6 +1212,7 @@ def sync(limit: int, batch: int, project: str | None, cwd_substr: str | None, ti
     """
     headers = _auth_headers()
     base = _api_base()
+    _preflight(base)
 
     # Phase 1: Push local → cloud
     console.print("[bold]Phase 1: Push local → cloud[/bold]")
@@ -1115,10 +1258,10 @@ def sync(limit: int, batch: int, project: str | None, cwd_substr: str | None, ti
         r = httpx.get(f"{base}/v1/sessions", headers=headers, params=params, timeout=30)
         r.raise_for_status()
     except httpx.HTTPStatusError as e:
-        console.print(f"  [red]HTTP {e.response.status_code}: {e.response.text[:200]}[/red]")
+        console.print(f"  [red]{_explain_http(e)}[/red]")
         return
     except Exception as e:
-        console.print(f"  [red]{e}[/red]")
+        console.print(f"  [red]{_explain_error(e, base)}[/red]")
         return
 
     data = r.json()

{spooling-0.2.8 → spooling-0.2.10}/spooling/mcp_server.py

@@ -161,7 +161,7 @@ def list_traces(
 
     Args:
         limit: Max rows to return (default 25, capped at 200).
-        provider: Filter to one provider id (jsonl-session, codex, cursor, copilot, windsurf, kiro, antigravity, gemini, opencode).
+        provider: Filter to one provider id (claude-code, jsonl-session, codex, cursor, copilot, windsurf, kiro, antigravity, gemini, opencode).
         project: Filter to sessions whose project name matches exactly.
     """
     limit = max(1, min(limit, 200))

{spooling-0.2.8 → spooling-0.2.10}/spooling/parser.py

@@ -304,8 +304,19 @@ def _tool_result_text(block: dict) -> tuple[str, bool | None]:
     return "", is_error
 
 
-def parse_session_file(file_path: Path) -> ParsedSession | None:
-    """Parse a single session JSONL file into messages + trace."""
+def parse_session_file(
+    file_path: Path,
+    provider_id: str = "jsonl-session",
+    project_from_cwd: bool = False,
+) -> ParsedSession | None:
+    """Parse a single session JSONL file into messages + trace.
+
+    ``provider_id`` is stamped on both the session and its trace (the generic
+    ``jsonl-session`` reader and the ``claude-code`` provider share this parser).
+    With ``project_from_cwd`` the project is the working directory's basename,
+    matching Codex/Gemini/opencode, instead of the on-disk folder name (which for
+    Claude Code is the whole path with slashes replaced by dashes).
+    """
     session_id = file_path.stem
     project = file_path.parent.name
 
@@ -344,9 +355,14 @@ def parse_session_file(file_path: Path) -> ParsedSession | None:
         agent_version = agent_version or r.get("version")
         if not model:
             m = (r.get("message") or {}).get("model")
-            if m:
+            # "<synthetic>" marks locally generated placeholder messages
+            # (interrupts, API errors), not a real model.
+            if m and m != "<synthetic>":
                 model = m
 
+    if project_from_cwd and cwd:
+        project = Path(cwd.rstrip("/")).name or project
+
     # --- Build ParsedMessage list (legacy path, with tool details) -------
     messages: list[ParsedMessage] = []
     pending_tool_details: list[ToolCallDetail] = []
@@ -422,6 +438,7 @@ def parse_session_file(file_path: Path) -> ParsedSession | None:
         git_branch=git_branch,
         model=model,
         title=title,
+        provider_id=provider_id,
     )
 
     return ParsedSession(
@@ -435,6 +452,7 @@ def parse_session_file(file_path: Path) -> ParsedSession | None:
         agent_version=agent_version,
         model=model,
         title=title,
+        provider_id=provider_id,
         trace=trace,
     )
 
@@ -467,6 +485,7 @@ def _build_trace(
     git_branch: str | None,
     model: str | None,
     title: str | None,
+    provider_id: str = "jsonl-session",
 ) -> Trace:
     """Build a Trace with span tree from session records.
 
@@ -479,7 +498,7 @@ def _build_trace(
                 └─ tool ...
     """
     tb = TraceBuilder(
-        provider_id="jsonl-session",
+        provider_id=provider_id,
         session_id=session_id,
         project=project,
         cwd=cwd,

{spooling-0.2.8 → spooling-0.2.10}/spooling/pricing.py

@@ -48,6 +48,7 @@ _GEMINI_ZERO_MINOR = re.compile(r"^(gemini-\d+)-0(-)")
 # "auto"), substitute the provider's documented default before pricing.
 # Source: each provider's docs, picked as the most-common-actual-model.
 PROVIDER_DEFAULT_MODEL: dict[str, str] = {
+    "claude-code":   "claude-sonnet-4-5",
     "copilot":       "gpt-4o",
     "cursor":        "gpt-4o",
     "windsurf":      "gpt-4o",

{spooling-0.2.8 → spooling-0.2.10}/spooling/providers/__init__.py

@@ -2,6 +2,7 @@
 
 from spooling.providers.base import Provider, RemoteProvider, PROVIDER_REGISTRY
 from spooling.providers.session_file import SessionFileProvider
+from spooling.providers.claude_code import ClaudeCodeProvider
 from spooling.providers.codex import CodexProvider
 from spooling.providers.cursor import CursorProvider
 from spooling.providers.copilot import CopilotProvider
@@ -19,6 +20,7 @@ __all__ = [
     "RemoteProvider",
     "PROVIDER_REGISTRY",
     "SessionFileProvider",
+    "ClaudeCodeProvider",
     "CodexProvider",
     "CursorProvider",
     "CopilotProvider",

spooling-0.2.10/spooling/providers/claude_code.py

@@ -0,0 +1,65 @@
+"""Claude Code provider: reads session transcripts from ``~/.claude/projects``.
+
+Claude Code writes one JSONL transcript per session at
+``<config dir>/projects/<encoded-cwd>/<session-uuid>.jsonl``, where the encoded
+cwd is the working directory with ``/`` replaced by ``-``. Each line is a
+``user`` / ``assistant`` record (plus bookkeeping records the parser ignores)
+carrying per-message token ``usage`` including prompt-cache reads and writes,
+which is what makes cost tracking accurate.
+
+The config directory is ``$CLAUDE_CONFIG_DIR`` when set, otherwise ``~/.claude``
+(falling back to ``~/.config/claude`` where newer installs put it). A different
+location can be pinned in ``~/.config/spooling/paths.json`` under the key
+``"claude-code"``.
+
+Not yet included: subagent transcripts, which recent Claude Code versions write
+to separate files under ``<session-uuid>/subagents/``. Their spend is not part of
+the parent session's totals.
+"""
+
+import os
+import re
+from pathlib import Path
+
+from spooling.parser import ParsedSession, parse_session_file
+from spooling.providers.base import Provider
+
+_UUID_RE = re.compile(r"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$")
+
+
+def _claude_config_dirs() -> list[Path]:
+    env = os.environ.get("CLAUDE_CONFIG_DIR", "").strip()
+    if env:
+        return [Path(env).expanduser()]
+    return [Path.home() / ".claude", Path.home() / ".config" / "claude"]
+
+
+class ClaudeCodeProvider(Provider):
+    type_id = "claude-code"
+    name = "Claude Code"
+
+    def default_data_path(self) -> Path:
+        candidates = [d / "projects" for d in _claude_config_dirs()]
+        for c in candidates:
+            if c.exists():
+                return c
+        return candidates[0]
+
+    def discover_session_files(self, data_path: Path | None = None) -> list[Path]:
+        base = data_path or self.resolved_data_path()
+        if not base.exists():
+            return []
+        files: list[Path] = []
+        for project_dir in base.iterdir():
+            if not project_dir.is_dir():
+                continue
+            # Top level only and UUID-named: skips subagent transcripts and
+            # non-session JSONL such as plugin skill-injection logs.
+            for f in project_dir.glob("*.jsonl"):
+                if _UUID_RE.match(f.stem):
+                    files.append(f)
+        return sorted(files, key=lambda f: f.stat().st_mtime, reverse=True)
+
+    def parse_session_file(self, file_path: Path) -> list[ParsedSession]:
+        session = parse_session_file(file_path, provider_id=self.type_id, project_from_cwd=True)
+        return [session] if session else []

{spooling-0.2.8 → spooling-0.2.10}/spooling/server.py

@@ -108,6 +108,13 @@ async def api_search(
 # --- Providers / Connections ---
 
 PROVIDER_TEMPLATES = {
+    "claude-code": {
+        "name": "Claude Code",
+        "icon": "claude",
+        "default_path": "~/.claude/projects",
+        "description": "Anthropic's Claude Code CLI. One JSONL transcript per session, with per-message token and prompt-cache usage.",
+        "status_hint": "Auto-detected from ~/.claude/projects/",
+    },
     "jsonl-session": {
         "name": "Session Files",
         "icon": "file",

{spooling-0.2.8 → spooling-0.2.10/spooling.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spooling
-Version: 0.2.8
+Version: 0.2.10
 Summary: Local session tracker and semantic search for AI coding assistants
 Author: Parsed Analytics, Inc.
 License: MIT
@@ -38,7 +38,7 @@ Dynamic: license-file
 
 Local session tracker and semantic search for AI coding assistants.
 
-Track your AI coding sessions across **OpenAI Codex CLI**, **GitHub Copilot**, **Cursor**, **Windsurf**, **Kiro**, **Google Antigravity**, and **opencode**, all in one place. Get usage stats, cost estimates, per-provider breakdowns, semantic search, and a built-in AI chat agent to explore your history.
+Track your AI coding sessions across **Claude Code**, **OpenAI Codex CLI**, **GitHub Copilot**, **Cursor**, **Windsurf**, **Kiro**, **Google Antigravity**, and **opencode**, all in one place. Get usage stats, cost estimates, per-provider breakdowns, semantic search, and a built-in AI chat agent to explore your history.
 
 **Website:** [spooling.ai](https://spooling.ai)
 
@@ -142,6 +142,7 @@ spooling sync                      # Full sync with embeddings
 spooling sync --no-embed           # Skip embeddings (faster initial sync)
 spooling sync -p cursor            # Sync only Cursor sessions
 spooling sync -p codex             # Sync only Codex CLI sessions
+spooling sync -p claude-code       # Sync only Claude Code sessions
 ```
 
 ### `spooling stats`
@@ -639,6 +640,7 @@ All optional — defaults work out of the box.
 
 | Provider | Data Location | Format |
 |----------|--------------|--------|
+| **Claude Code** | `~/.claude/projects/` (or `$CLAUDE_CONFIG_DIR/projects`) | `<project>/<session-uuid>.jsonl` transcripts with per-message token usage, prompt-cache reads/writes, tool calls and git context |
 | **JSONL Sessions** | `~/.sessions/projects/` | UUID-named JSONL files with conversation history, tool calls, git context |
 | **OpenAI Codex CLI** | `~/.codex/sessions/` | `rollout-*.jsonl` files organized by date |
 | **GitHub Copilot** | `~/Library/Application Support/Code/User/workspaceStorage/` | Chat session JSON from VS Code |
@@ -650,5 +652,7 @@ All optional — defaults work out of the box.
 
 Run `spooling init` to see which providers are detected on your system.
 
+**Claude Code notes.** Sessions are detected automatically; there is nothing to connect. Cost is computed from each message's real token usage (including prompt-cache reads and writes) at the model's list price, so it reflects API-equivalent spend, not what a subscription plan charges. The project name is the session's working directory. To read transcripts from somewhere else, set `CLAUDE_CONFIG_DIR` or add `{"claude-code": "/path/to/projects"}` to `~/.config/spooling/paths.json`. Subagent transcripts (stored in separate files under `<session>/subagents/` by recent Claude Code versions) are not included yet.
+
 Nothing leaves your machine unless you opt in: Spooling Cloud (`spooling push`), a tunnel (`spooling tunnel`), or the Anthropic chat provider. `spooling pricing refresh` downloads public model prices but sends none of your data.
 

{spooling-0.2.8 → spooling-0.2.10}/spooling.egg-info/SOURCES.txt

@@ -51,6 +51,7 @@ spooling/connectors/rest/shopify_connectors.py
 spooling/providers/__init__.py
 spooling/providers/antigravity.py
 spooling/providers/base.py
+spooling/providers/claude_code.py
 spooling/providers/codex.py
 spooling/providers/copilot.py
 spooling/providers/cortex_code.py
@@ -62,6 +63,8 @@ spooling/providers/kiro.py
 spooling/providers/opencode.py
 spooling/providers/session_file.py
 spooling/providers/windsurf.py
+tests/test_claude_code_provider.py
+tests/test_cloud_errors.py
 tests/test_mcp_auth_middleware.py
 tests/test_session_ids.py
 tests/test_storage_optimizations.py