@clauderecallhq/cli 0.65.1 → 0.65.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clauderecallhq/cli",
-  "version": "0.65.1",
+  "version": "0.65.3",
   "description": "Never lose a Claude Code session again. Local, fast, searchable memory over every session you've ever run.",
   "type": "module",
   "homepage": "https://clauderecall.com",
@@ -66,7 +66,7 @@
   ],
   "author": "Claude Recall HQ <hello@clauderecall.com>",
   "license": "SEE LICENSE IN LICENSE",
-  "readme": "README.md",
+  "readme": "<div align=\"center\">\n\n<img src=\"https://clauderecall.com/wordmark-light.svg\" alt=\"Claude Recall\" width=\"400\">\n\n<br />\n<br />\n\n**Stop re-explaining your project to Claude every morning.**\n\nClaude Recall indexes every Claude Code session you've ever run, surfaces what matters,<br />and pipes the right context back in with one command.\n\n<br />\n\n<img src=\"https://clauderecall.com/hero/brand-morph.gif\" alt=\"Claude Recall, memory tree morphing into the wordmark\" width=\"700\">\n\n<br />\n<br />\n\n[![npm](https://img.shields.io/npm/v/@clauderecallhq/cli?style=flat-square&color=f97316&labelColor=f97316&label=npm)](https://www.npmjs.com/package/@clauderecallhq/cli)\n[![Downloads](https://img.shields.io/npm/dm/@clauderecallhq/cli?style=flat-square&color=f97316&labelColor=f97316&label=downloads)](https://www.npmjs.com/package/@clauderecallhq/cli)\n[![License](https://img.shields.io/badge/license-proprietary-f97316?style=flat-square)](#license)\n\n<br />\n\n<sub>100% local. No cloud. No account. No telemetry. Your conversations never leave your machine.</sub>\n\n</div>\n\n<br />\n\n---\n\n<br />\n\n## The Problem\n\nClaude Code is incredible until the conversation ends. Then you hit three walls:\n\n<table>\n<tr>\n<td width=\"33%\" valign=\"top\">\n\n### Context Amnesia\n\nEvery new `claude` invocation starts from zero. You re-explain the architecture, re-paste the key files, re-describe the bug you already fixed yesterday.\n\nYou built that context pyramid once. Now you're building it again.\n\n</td>\n<td width=\"33%\" valign=\"top\">\n\n### Cost Blindness\n\nClaude Code tells you nothing about spend after a session ends. Which session burned through tokens? Which project is quietly eating half your Anthropic bill?\n\nYou're guessing.\n\n</td>\n<td width=\"33%\" valign=\"top\">\n\n### Session Sprawl\n\nClaude Code scatters conversations into `~/.claude/projects/**/*.jsonl`. No titles. No search. No way to find the session where you finally got the auth flow right.\n\nDozens of projects. Hundreds of sessions. Zero discoverability.\n\n</td>\n</tr>\n</table>\n\n<br />\n\n## The Fix\n\n```bash\nnpm install -g @clauderecallhq/cli\nrecall start\nrecall open\n```\n\nThat's it. Recall indexes every past and future Claude Code session into a searchable local database, gives you a beautiful web UI to explore them, and lets you pipe any session back into a new conversation:\n\n```bash\n# The moat: past session -> new conversation\nrecall context abc12345 | claude\n```\n\nClaude picks up where you left off instead of asking you to explain it again.\n\n<br />\n\n<div align=\"center\">\n\n<img src=\"https://cdn.clauderecall.com/marketing/product-ui.png?v=hd3\" alt=\"Claude Recall web UI — every Claude Code session you have ever run, with full transcripts, tool calls, threading, and search\" width=\"900\">\n\n<sub>Every Claude Code session you have ever run. Searchable. Threaded. Re-injectable.</sub>\n\n</div>\n\n<br />\n\n---\n\n<br />\n\n## Features\n\n### Context Re-injection (the moat)\n\nPipe any past session straight into a new Claude Code conversation as condensed markdown. Claude picks up where you left off instead of asking you to re-explain it. **Nothing else in this category has it.**\n\n```bash\nrecall context <id> | claude\nrecall context <id> --prelude \"continue this\" | claude\nrecall context <id> --since 2h | claude\n```\n\n### Threads\n\nGroup related sessions into a DAG you can see, rename, and walk. Drag-to-reparent in the graph view. Right-click rename. Bulk-generate coherent titles across an entire thread with one click.\n\n```bash\nrecall thread list\nrecall thread create \"auth-refactor\"\nrecall thread add <thread> <session>\n```\n\n### Full-Text Search\n\nFTS5 BM25 ranking across every message, every session, in milliseconds. Highlighted snippets, inline `#tag` filters, project + date scoping.\n\n```bash\nrecall search \"zod schema\"\nrecall search \"auth #auth-fix\" -p Pest-Control\n```\n\n### On-Device Vector Search (Pro)\n\nLocal **768-dimension embeddings** via `bge-base-en-v1.5` ONNX. Three-lane RRF fusion (BM25 + summary + vectors) finds sessions by *meaning*, not keywords. Your code never leaves your laptop.\n\nThe embedder model (~110MB) auto-downloads on `npm install`. Skip with `RECALL_SKIP_MODEL_DOWNLOAD=1`.\n\n**Anonymous install ping (opt-in, off by default).** On first run we ask once whether you want to send a single anonymous message per month so we can count real installs vs bots. No PII, no fingerprint, no cross-month linkage. Full payload at [clauderecall.com/telemetry](https://clauderecall.com/telemetry). Toggle any time with `recall telemetry on` / `off` / `view`.\n\n```bash\nrecall similar <session-id>\n```\n\n### Cost Analytics\n\nPer-session and per-project token + dollar totals. Daily sparkline. Top-10 heaviest sessions. Know exactly where your Anthropic bill is going.\n\n```bash\nrecall stats <id>\nrecall stats --project Tools --days 7\n```\n\n<div align=\"center\">\n\n<video autoplay loop muted playsinline width=\"540\">\n  <source src=\"https://cdn.clauderecall.com/marketing/cost-analytics.mp4?v=hd3\" type=\"video/mp4\">\n  <img src=\"https://cdn.clauderecall.com/marketing/cost-analytics.gif?v=hd3\" alt=\"Cost analytics dashboard — daily spend bars, top sessions ranked by cost, primary model breakdown\" width=\"540\">\n</video>\n\n<sub>Hover any day. Exact cost. Exact tokens.</sub>\n\n</div>\n\n### Git Correlation\n\nEvery session links to commits authored in its working directory during its time window. Reverse-map any commit back to the session that produced it.\n\n```bash\nrecall correlate\nrecall blame <sha>\n```\n\n### Auto-Tagging\n\nLet Claude label your sessions automatically. Two modes: **MCP mode** (zero-setup, runs through your existing Claude Code subscription at no extra cost) or **BYOK** (paste your own Anthropic API key). Off by default, fully opt-in.\n\n### MCP Server (35 tools)\n\nExpose Recall to Claude Desktop, Claude Code, or any MCP client as native tools. **13 read tools always on**, **22 write tools** opt-in with rate limiting and append-only audit logging.\n\n```bash\nrecall mcp\nrecall mcp --allow-writes\n```\n\n<div align=\"center\">\n\n<video autoplay loop muted playsinline width=\"900\">\n  <source src=\"https://cdn.clauderecall.com/marketing/mcp-server-demo.mp4?v=hd3\" type=\"video/mp4\">\n  <img src=\"https://cdn.clauderecall.com/marketing/mcp-server-demo.gif?v=hd3\" alt=\"Claude calling Recall as native MCP tools — search and get_session executing live\" width=\"900\">\n</video>\n\n<sub>Claude searches your history, pulls context, and decides — no copy-paste.</sub>\n\n</div>\n\n### Collections, Tags and Notes\n\nHand-curated hierarchical collections that cut across projects. Flat tags. Markdown notes per session. Aliases. Pins. Cross-session diff. Every write is reversible: three-layer durability with plain-text mirrors on disk.\n\n<div align=\"center\">\n\n<video autoplay loop muted playsinline width=\"540\">\n  <source src=\"https://cdn.clauderecall.com/marketing/collections.mp4?v=hd3\" type=\"video/mp4\">\n  <img src=\"https://cdn.clauderecall.com/marketing/collections.gif?v=hd3\" alt=\"Collections panel — Auth System, Database Migrations, React Refactor, API Design, Deployment Issues; drag a session card into a collection\" width=\"540\">\n</video>\n\n<sub>Drag-to-organize. Collections cut across projects.</sub>\n\n</div>\n\n### Web UI\n\nDark-mode three-pane layout. **Virtualized transcript** (10,000-message sessions open instantly). `Cmd+K` command palette. Cross-session diff. First-60-seconds onboarding tour. Export to markdown, HTML, or print-ready PDF.\n\n<div align=\"center\">\n\n<video autoplay loop muted playsinline width=\"900\">\n  <source src=\"https://cdn.clauderecall.com/marketing/tui-demo.mp4?v=hd3\" type=\"video/mp4\">\n  <img src=\"https://cdn.clauderecall.com/marketing/tui-demo.gif?v=hd3\" alt=\"Full-screen terminal UI — sessions list with live preview pane, slash-to-filter\" width=\"900\">\n</video>\n\n<sub>Or stay in the terminal. <code>recall tui</code> ships the same library as a full-screen terminal app — slash to filter, arrow keys to navigate, live preview.</sub>\n\n</div>\n\n### Rediscovery (\"For you\")\n\nThree rotating cards in the left pane surface forgotten sessions worth revisiting: a 60+-day-old session that overlaps with what you've been working on, your top-cost session this week, and the session that authored your current `HEAD`.\n\n```bash\nrecall digest\n```\n\n### IDE Extension\n\n**VS Code, Cursor, Windsurf, VS Code Insiders.** Tag terminal tabs from inside your editor; terminal names sync to Recall so sessions get meaningful aliases with zero CLI ceremony, live as you rename tabs.\n\n```bash\nrecall install-extension\n```\n\n<br />\n\n<details>\n<summary><strong>More: secrets redaction, memory health, audit log, keyboard shortcuts...</strong></summary>\n\n<br />\n\n- **Secrets redaction.** API keys, auth tokens, passwords, private-key blobs are detected by pattern and replaced with placeholders **before** text lands in the searchable index or any export. Original JSONLs untouched.\n- **Memory health scores.** Every session gets a freshness score; surfaces stale data so you know when to re-run a backfill.\n- **MCP audit log.** Every write tool call lands in `mcp_audit_events` with status (ok / error / rate_limited). Pure local, no telemetry.\n- **First-60-seconds onboarding.** 3-step modal demos the moat (`recall context <id> | claude`) the moment you open the web UI.\n- **Cmd+K command palette.** Jump to any session, action, or setting in one keystroke.\n- **Multi-select sessions.** `Cmd+Click` toggle, `Shift+Click` range, right-click to copy IDs.\n- **Three-layer durability.** Every write goes to SQLite + an append-only history column + a plain-text mirror on disk. Source JSONLs at `~/.claude/projects/` are strictly read-only.\n\n#### Keyboard Shortcuts\n\n| Key | Action |\n|---|---|\n| `/` | Focus search |\n| `?` | Open Command Center |\n| `Cmd+K` / `Ctrl+K` | Command palette |\n| `Esc` | Close / clear / dismiss |\n| `n` / `p` | Next / previous search match |\n| `c` | New collection |\n| `Cmd+Shift+A` | Add session to collection |\n| `Cmd+Enter` | Save note |\n\n</details>\n\n<br />\n\n---\n\n<br />\n\n<div align=\"center\">\n\n<video autoplay loop muted playsinline width=\"900\">\n  <source src=\"https://cdn.clauderecall.com/marketing/vs-obsidian.mp4?v=hd3\" type=\"video/mp4\">\n  <img src=\"https://cdn.clauderecall.com/marketing/vs-obsidian.gif?v=hd3\" alt=\"Side-by-side: Obsidian vault on the left, Claude Recall TUI on the right showing 247 sessions across 8 projects with live preview\" width=\"900\">\n</video>\n\n<sub>People sometimes ask if this is \"Obsidian for Claude Code.\" It is not. A general note-taking app cannot watch your filesystem for new sessions, index JSONLs into FTS5 + vector search, expose those sessions as MCP tools, or pipe a session back into Claude with one command. Claude Recall is built specifically for the loop you actually run.</sub>\n\n</div>\n\n<br />\n\n## Quick Start\n\n### Install\n\n```bash\nnpm install -g @clauderecallhq/cli\n```\n\n### Start\n\n```bash\n# Start the background daemon (file watcher + local HTTP server)\nrecall start\n\n# Open the web UI\nrecall open\n```\n\nThe daemon watches `~/.claude/projects/` for new and changed session files, indexes them into a local SQLite database at `~/.recall/db.sqlite`, and serves the web UI on a random `127.0.0.1` port.\n\n### Browse\n\nTwo interactive surfaces, both work without the daemon (they read SQLite directly):\n\n```bash\nrecall                    # smart welcome dashboard with status + slash command palette\nrecall tui                # full terminal UI: arrow-key browse, live search, preview pane\n```\n\n`recall` (no args) prints a branded splash with version / daemon / sessions / license status and drops into a slash-aware prompt; type `/` to browse 60+ commands grouped by purpose (Setup, Browse, Pipe to Claude, Threads, Inference, Analytics, Daemon, Diagnostics, Integrations, Sharing, Feedback, Pro).\n\n`recall tui` mounts a full-screen terminal app modeled on `lazygit` and `k9s`. Arrow keys to navigate, `/` to filter, `enter` to view the full transcript, `o` to open the selected session in the browser, `q` to quit.\n\n### Explore\n\n```bash\nrecall projects           # list projects with session counts\nrecall list               # 30 most-recent sessions\nrecall list -p Tools      # filter by project\nrecall show <id>          # pretty-printed transcript\nrecall search \"auth bug\"  # full-text search\n```\n\n### The Moat\n\n```bash\n# Pipe a past session into a new Claude Code conversation\nrecall context abc12345 | claude\n\n# With a custom instruction\nrecall context abc12345 --prelude \"continue where we left off\" | claude\n\n# Just the last 2 hours\nrecall context abc12345 --since 2h | claude\n```\n\n<br />\n\n<div align=\"center\">\n\n<img src=\"https://cdn.clauderecall.com/marketing/product-demo.gif?v=hd3\" alt=\"Pipe past session context back into Claude with one command\" width=\"720\">\n\n<sub>Claude resumes with full prior context. One command. No re-explaining.</sub>\n\n</div>\n\n### How Claude Recall integrates with Claude Code\n\nDon't think of Claude Recall as a *separate* tool you context-switch to. It's **Claude Code's memory layer**: you reach it from inside any session through four surfaces, in increasing power:\n\n**1. Bash tool: always available, zero setup.**\n\nInside any Claude Code conversation, just say *\"run `recall search auth bug`\"* (or any other recall command). The Bash tool executes it; output lands in the conversation. Works the moment you `npm install -g @clauderecallhq/cli`. No config.\n\n**2. Slash commands (skills): one-tap workflows.**\n\nWhen Claude Recall is installed as a Claude Code plugin, typing `/` in Claude Code surfaces ready-made workflows:\n\n| Slash command | What it does |\n|---|---|\n| `/claude-recall:recall <query>` | Search past sessions and pull relevant ones in as context |\n| `/claude-recall:context <id>` | Load one specific session's full transcript |\n| `/claude-recall:neighborhood <id>` | Bundle parents + children + citations + similar |\n| `/claude-recall:tag <id> <tag>` | Tag a session for later retrieval |\n| `/claude-recall:alias <id> <name>` | Rename a session |\n| `/claude-recall:threads-sync` | Capture currently active terminals into a thread |\n| `/claude-recall:thread-scan` | Auto-detect threads across historical sessions |\n| `/claude-recall:setup` | Verify installation and MCP connection |\n\n**3. MCP server: the model calls Recall directly.**\n\nThe most powerful surface. With `recall mcp` registered as an MCP server in Claude Code, the model itself decides when to call Recall mid-conversation. Ask *\"have I solved this auth bug before?\"* and Claude calls `search` autonomously, gets results, and uses them. Ask *\"pull yesterday's context\"* and it calls `context_for_session`. No commands, no slash menu, pure intent.\n\n**4. Piping into a fresh `claude`: start tomorrow with yesterday's context.**\n\nThe cross-session continuation pattern, run from your shell:\n\n```bash\nrecall neighborhood abc12345 | claude   # bundle related sessions, start fresh chat\nrecall context abc12345 | claude        # one specific session, start fresh chat\n```\n\nUse case: you finish work Monday night, restart Tuesday morning with a clean Claude Code window, and want it to know what happened yesterday without re-explaining.\n\n### MCP Server\n\nPoint any MCP client at Recall and the model calls it as native tools:\n\n```json\n{\n  \"mcpServers\": {\n    \"recall\": {\n      \"command\": \"claude-recall-mcp\"\n    }\n  }\n}\n```\n\n<details>\n<summary><strong>Available MCP tools (35 total)</strong></summary>\n\n<br />\n\n**Read tools (13, always available):**\n\n| Tool | Purpose |\n|---|---|\n| `list_projects` | Every indexed project with session/message counts |\n| `list_sessions` | Recent sessions; filters: project, tag, date range |\n| `list_tags` | Tag cloud with counts, most popular first |\n| `search` | Full-text search with `#tag` support; BM25 + optional vector fusion |\n| `find_similar_sessions` | Semantic similarity via vector embeddings (Pro) |\n| `semantic_status` | Health snapshot: model, worker, queue depth (Pro) |\n| `get_session` | Full transcript (accepts 8+ char id prefix) |\n| `context_for_session` | Condensed markdown export, ready to inject |\n| `recall_neighborhood` | Bundle parents/children/citations/similar as one budget-bounded markdown blob |\n| `doctor` | Read-only health snapshot: db size, WAL, FTS5 fragmentation, integrity check |\n| `thread_list` | All threads, newest first; can exclude archived |\n| `thread_get` | Full thread detail with every session edge |\n| `thread_for_session` | Non-archived threads referencing a session |\n\n**Write tools (22, opt-in via `--allow-writes`):**\n\n| Tool | Purpose |\n|---|---|\n| `list_sessions_to_tag` | Surface untagged sessions for review (auto-tag flow) |\n| `apply_tags` | Add tags to a session (merge-mode, never deletes) |\n| `add_tag` / `remove_tag` | Tag management; removals logged in append-only log |\n| `set_alias` | Human-friendly session name; previous alias archived |\n| `append_note` | Add markdown to session note; separated by `---` |\n| `create_collection` | New collection; optional parent, icon, color |\n| `add_session_to_collection` | Idempotent collection membership |\n| `remove_session_from_collection` | Remove session; logged in append-only log |\n| `thread_create` | Create thread, optionally seed with origin session |\n| `thread_add_session` | Attach session; role=origin or child |\n| `thread_set_parent` | Change parent within thread; null clears parent |\n| `thread_remove_session` | Detach session from thread |\n| `thread_rename` | Change thread display name |\n| `thread_close` / `thread_reopen` | Mark thread as closed or reopen |\n| `thread_archive` | Soft-delete thread; hidden by default |\n| `thread_merge` | Move all edges from source to dest, delete source |\n| `thread_split` | Peel sessions into new thread |\n| `sync_active_sessions` | Capture every Claude Code terminal currently open in a repo into one thread, so parallel sessions stay organized |\n| `generate_thread_titles` | Generate coherent titles for sessions in thread DAG |\n| `optimize` | WAL checkpoint, FTS5 segment merge, planner stats refresh; optional VACUUM |\n\nAll writes are rate-limited (default 60/min), zod-validated, and audited to `~/.recall/audit/`.\n\n</details>\n\n<br />\n\n---\n\n<br />\n\n## How It Works\n\n```text\n~/.claude/projects/**/*.jsonl   <-- Claude Code session files (read-only to Recall)\n        |\n        v  chokidar file watcher\n~/.recall/db.sqlite             <-- indexed database (FTS5 + sqlite-vec 768d)\n        |\n        +-- background embedding worker (idle-aware, transactional)\n        +-- git correlator (read-only 'git log' scoped to session cwd)\n        +-- semantic / auto-tag scanner (opt-in, off by default)\n        |\n  +-----+-----+\n  |           |\n  CLI         HTTP server (Hono, 127.0.0.1 only)\n  |           |\n  recall ...  Web UI (React + Tailwind SPA, Vite-bundled)\n              MCP server (stdio, 35 tools, opt-in writes)\n```\n\n### Data stays local\n\n| Path | What |\n|---|---|\n| `~/.recall/db.sqlite` | Indexed database (projects, sessions, messages, FTS5, vectors, aliases, notes, tags, collections, threads, semantic summaries, commit links, usage rollups, audit logs) |\n| `~/.recall/aliases.json` | Plain-text mirror of every alias with full edit history |\n| `~/.recall/notes/<session>.md` | One markdown file per session note |\n| `~/.recall/tags.json` | Current tag state + append-only event log |\n| `~/.recall/collections.json` | Current tree state + append-only event log |\n| `~/.recall/semantic/<id>.json` | Per-session summary + keywords (semantic mode) |\n| `~/.recall/license.jwt` | Activated Pro license (offline-validatable, dead-man clause) |\n\n<br />\n\n---\n\n<br />\n\n## Privacy & Security\n\n<div align=\"center\">\n\n<img src=\"https://cdn.clauderecall.com/marketing/privacy-trust.gif?v=hd3\" alt=\"Local-first design — daemon binds to 127.0.0.1, no telemetry, no outbound network calls\" width=\"640\">\n\n</div>\n\n<br />\n\nClaude Recall is **local-first by design**, not as an afterthought.\n\n- **The daemon binds to `127.0.0.1` only.** Never `0.0.0.0`, never a public interface.\n- **No telemetry. No analytics. No background phone-home.** The daemon, file watcher, indexer, and web UI never make outbound network calls. Your session content never leaves your machine.\n- **The only outbound calls are user-initiated**, never automatic, and never transmit your session data.\n- **No cloud. No account.** Your data lives at `~/.recall/` and nowhere else.\n- **Source sessions are never modified.** Claude Code's JSONL files at `~/.claude/projects/` are strictly read-only to Recall.\n- **Never-delete-data invariant.** Every write enforces three independent durability layers: SQLite with history columns, plain-text mirror on disk, and source JSONLs untouched. Renaming, clearing, or removing anything is always additive; the prior value is archived, never destroyed.\n\nThe two user-initiated outbound calls:\n\n| Command | Endpoint | What it sends | What it gets |\n|---|---|---|---|\n| `recall activate <key>` | `clauderecall.com` | The license key only | A signed JWT for offline validation |\n| `recall semantic install` | `huggingface.co` | Nothing about you | The `bge-base-en-v1.5` ONNX model file |\n\nBoth are optional and not required for core indexing, search, or context re-injection. Skip them and Recall is fully air-gapped.\n\n<br />\n\n---\n\n<br />\n\n## Full CLI Reference\n\n<details>\n<summary><strong>Click to expand</strong></summary>\n\n<br />\n\n```bash\n# Surfaces\nrecall                    # smart welcome dashboard + slash command palette (no args)\nrecall tui                # interactive terminal UI for browsing and search\n\n# Lifecycle\nrecall start              # start daemon (watcher + local HTTP)\nrecall stop               # stop daemon\nrecall open               # open web UI (starts daemon if needed)\nrecall status             # db + daemon health\n\n# Indexing\nrecall index              # scan for new/changed session files\nrecall index --force      # reindex everything\n\n# Explore\nrecall projects           # list projects with session counts\nrecall list               # 30 most-recent sessions\nrecall list -p Tools      # filter by project substring\nrecall list -n 100        # higher limit\n\n# Read\nrecall show <id>          # pretty transcript, auto-paged\nrecall show <id> --raw    # raw JSONL\nrecall show <id> --no-pager\n\n# Search\nrecall search \"zod schema\"\nrecall search \"auth\" -p Pest-Control\nrecall search bug -n 50\n\n# Context re-injection\nrecall context <id>                              # condensed markdown\nrecall context <id> | pbcopy                     # to clipboard (macOS)\nrecall context <id> | claude                     # into new Claude session\nrecall context <id> --full                       # full transcript\nrecall context <id> --since 2h                   # last 2 hours only\nrecall context <id> --prelude \"continue this\"    # prepend instruction\nrecall context <id> --subagents                  # include subagent messages\n\n# Stats\nrecall stats <id>              # tokens + dollars for one session\nrecall stats --project Tools   # per-project rollup\nrecall stats --days 7          # 7-day overview\nrecall stats --backfill        # one-shot usage backfill\n\n# Git correlation\nrecall correlate               # link sessions to commits\nrecall blame <sha>             # commit -> session reverse lookup\n\n# Semantic / vector search (Pro)\n# Embedder model auto-installs on `npm install`; manual install also available.\nrecall semantic install        # download on-device embedding model (auto-runs on npm install)\nrecall semantic status         # model + backfill progress + auto-extract state\nrecall semantic reindex        # re-embed everything\nrecall semantic auto-extract on  # daemon nibbles un-extracted sessions through Claude (Pro)\nrecall similar <id>            # cosine kNN over session chunks\n\n# Threads\nrecall thread list             # all threads, newest first\nrecall thread create <name>    # new thread\nrecall thread add <t> <s>      # attach session to thread\n\n# Rediscovery\nrecall digest                  # today's \"For you\" picks\nrecall digest --json           # machine-readable\n\n# MCP server\nrecall mcp                     # stdio, read-only\nrecall mcp --allow-writes      # opt-in write tools\n\n# Pro license\nrecall activate <key>          # one-time activation, offline forever\nrecall license                 # show license status\n\n# IDE extension\nrecall install-extension       # auto-install for VS Code / Cursor / Windsurf\n\n# Maintenance\nrecall health                  # memory health scores per project\nrecall paste                   # archive clipboard content into Recall (opt-in)\nrecall audit-secrets           # scan index for residual secrets\n```\n\n</details>\n\n<br />\n\n---\n\n<br />\n\n## Tech Stack\n\n| Layer | Technology |\n|---|---|\n| CLI + daemon | TypeScript (strict), Node 22+, ESM |\n| HTTP server | Hono + @hono/node-server |\n| Database | better-sqlite3 with FTS5 full-text search |\n| Vector store | sqlite-vec (768d, on-device) |\n| Embeddings | @huggingface/transformers (`bge-base-en-v1.5` ONNX) |\n| File watcher | chokidar |\n| CLI parsing | commander |\n| MCP server | @modelcontextprotocol/sdk (stdio) |\n| Validation | zod |\n| Auth | jose (offline-validatable signed JWT licenses) |\n| Web UI | Vite 8 + React 19 + Tailwind CSS |\n| Data fetching | @tanstack/react-query |\n| Virtualization | @tanstack/react-virtual |\n| Markdown | marked + highlight.js + DOMPurify |\n\n<br />\n\n---\n\n<br />\n\n## Supported Platforms\n\nClaude Recall is a Node.js CLI with a few native dependencies (`better-sqlite3`, `sqlite-vec`, and the optional `@huggingface/transformers` for semantic search). npm picks the right prebuilt binary for your platform automatically; no compile toolchain required.\n\n| Platform | Tier | Status |\n|---|---|---|\n| **macOS** arm64 (Apple Silicon, M1+) | Tier 1 | Tested in pre-publish smoke test |\n| **macOS** x64 (Intel) | Tier 1 | Tested in pre-publish smoke test |\n| **Linux** x64 (glibc, kernel 4.x+) | Tier 1 | Tested on every CI run (Node 22, 24) |\n| **Linux** arm64 (glibc) | Tier 2 | Best-effort. Native deps ship arm64 prebuilds; report issues if you hit one |\n| **Windows** x64 (Windows 10+) | Tier 1 | Tested in pre-publish smoke test |\n| Windows arm64 / Linux musl (Alpine) / 32-bit | Unsupported | Native deps lack reliable prebuilds; install will be rejected |\n\n**Node:** 22 LTS or 24 LTS. Node 20 and earlier are unsupported (declared in `engines.node`).\n\n**Semantic search is optional.** The on-device embedder is the only feature that loads the native ONNX runtime. The model auto-downloads (~110MB) on `npm install`; skip with `RECALL_SKIP_MODEL_DOWNLOAD=1` and install later via `recall semantic install`. Core CLI features (search, list, context, daemon, MCP) work on every supported platform regardless of whether the embedder is installed. If the embedder fails to load on your platform, you get a clear error pointing here, and the rest of Claude Recall keeps working.\n\n<br />\n\n---\n\n<br />\n\n## Distribution\n\nClaude Recall ships on every surface a developer already works in.\n\n| Surface | Identity | Install |\n|---|---|---|\n| **npm** (CLI + MCP) | [`@clauderecallhq/cli`](https://www.npmjs.com/package/@clauderecallhq/cli) | `npm i -g @clauderecallhq/cli` |\n| **VS Code Marketplace** | [`clauderecallhq.clauderecall-vscode`](https://marketplace.visualstudio.com/items?itemName=clauderecallhq.clauderecall-vscode) | Search \"Claude Recall\" in Extensions |\n| **MCP Registry** | [`com.clauderecall/recall`](https://registry.modelcontextprotocol.io/v0/servers?search=clauderecall) | Auto-discovered by MCP clients |\n| **Claude Code Plugin Hub** | `claude-recall` | `/plugin install claude-recall` in Claude Code |\n| **Website** | [clauderecall.com](https://clauderecall.com) |   |\n\nThe npm package ships **the CLI and the MCP server**. The VS Code extension is a thin companion that talks to the local daemon over `127.0.0.1`. The MCP Registry and Claude Code Plugin Hub both point back to the npm package: one source of truth, one update pipeline.\n\n<br />\n\n---\n\n<br />\n\n## Pricing\n\nOne tier is free forever. One tier is a **one-time** purchase that works offline for life, even if we disappear. One tier is a conversation.\n\n### Free\n\n**$0.** Forever. No signup. No credit card.\n\n- Full indexing of every `~/.claude/projects/` JSON-L\n- CLI: `list`, `show`, `projects`, `status`\n- Web UI: browse projects, read transcripts, copy code\n- Three-layer durability\n\n```bash\nnpm install -g @clauderecallhq/cli\n```\n\n### Pro (daily driver)\n\n**$29.69 one-time** through May 2026 (Founder pricing). **$49.69 one-time** from June 2026 (standard). Pay once. Offline forever. Lifetime updates. Dead-man clause included. Never a subscription.\n\n- Full-text search (FTS5 BM25)\n- On-device semantic vector search (768d, RRF fusion)\n- `recall context` re-injection, **the moat**\n- MCP server (Claude Desktop / Claude Code native tools)\n- VS Code / Cursor / Windsurf extension\n- Aliases, tags, markdown notes, pins, date filters, cross-session diff\n- Export: clean markdown, self-contained dark-mode HTML, print-ready\n- Virtualized transcript (10k+ message sessions open instantly)\n- Auto-tagging (API-key + MCP modes)\n- Secrets redaction (client-side scrub of keys, tokens, passwords pre-index)\n- **Every future personal-use feature.** One price, lifetime updates.\n\n[**Buy Pro for $29.69 (Founder pricing through May)**](https://clauderecall.com/pricing)\n\n### Enterprise\n\n**Contact us.** Built for 50+ developer organizations.\n\n- Shared session library with end-to-end encrypted team sync\n- Team-wide tag conventions\n- Local audit log (compliance-grade, not surveillance)\n- SSO + per-project access control\n- Priority support, named engineer\n- Optional on-prem deployment\n\n[hello@clauderecall.com](mailto:hello@clauderecall.com)\n\n<br />\n\n### How it compares to what you already pay\n\n| Tool | Price |\n|---|---|\n| **Claude Recall** | **$29.69 one-time** through May 2026, **$49.69 one-time** from June |\n| Claude Code | $20 / mo |\n| Cursor | $20 / mo |\n| Raycast Pro | $8 to $16 / mo |\n| GitHub Copilot | $10 / mo |\n\n<sub>Prices as of May 2026.</sub>\n\n<br />\n\n### The dead-man clause\n\nYour Pro license validates against our server exactly once, at activation. After that, Recall works **offline forever**. If `clauderecall.com` ever disappears, every existing license stays valid; we'll publish the validation secret if we ever shut down, so you're never stranded.\n\nFull pricing FAQ: **[clauderecall.com/pricing](https://clauderecall.com/pricing)**\n\n<br />\n\n---\n\n<br />\n\n## Roadmap\n\n- [x] CLI, daemon, web UI, full-text search\n- [x] Context re-injection (the moat)\n- [x] Aliases, notes, tags, pins\n- [x] Cross-session diff\n- [x] VS Code / Cursor / Windsurf extension\n- [x] MCP server (read-only)\n- [x] Collections (hierarchical, cross-project)\n- [x] Auto-tagging (MCP + BYOK modes)\n- [x] Cost / token analytics\n- [x] Git correlation\n- [x] Cmd+K command palette\n- [x] Bidirectional MCP write tools (rate-limited + audited)\n- [x] First-60-seconds onboarding\n- [x] Rediscovery surface (\"For you\" cards)\n- [x] **On-device vector search** (768d ONNX embeddings, RRF fusion)\n- [x] **Threads.** DAG view, drag-to-reparent, bulk title generation\n- [x] **Pro license + dead-man clause** (offline-validatable JWT)\n- [x] Memory health scores\n- [x] Claude Code plugin manifest\n- [ ] Public launch at clauderecall.com\n- [ ] Team features (E2E-encrypted sync, SSO, audit log)\n- [ ] Enterprise tier (on-prem, named-engineer support)\n\n<br />\n\n---\n\n<br />\n\n## License\n\nProprietary. Free tier is free forever for personal use. Pro is a one-time purchase with offline-validatable JWT and a dead-man clause: if `clauderecall.com` ever shuts down, every existing license stays valid and the validation secret will be published so you're never stranded. Full terms at [clauderecall.com/terms](https://clauderecall.com/terms).\n\n<br />\n\n---\n\n<br />\n\n<div align=\"center\">\n\n<img src=\"https://clauderecall.com/mark-scrollback-dark.svg\" alt=\"Claude Recall\" width=\"48\">\n\n<br />\n<br />\n\n**Claude Recall.** The memory layer for the agent you're steering.\n\n[Website](https://clauderecall.com) · [Install](https://www.npmjs.com/package/@clauderecallhq/cli) · [Issues](https://gitlab.com/clauderecallhq/clauderecallhq/-/issues)\n\n<br />\n\n<sub>Built by <a href=\"https://gitlab.com/clauderecallhq\">@clauderecallhq</a></sub>\n\n</div>\n",
   "engines": {
     "node": ">=22"
   },