@clauderecallhq/cli 0.12.5 → 0.61.2

package/LICENSE

@@ -1,27 +1,47 @@
-Claude Recall — Proprietary License (pre-release)
+Claude Recall Proprietary License
 
 Copyright (c) 2026 Claude Recall HQ. All rights reserved.
 
-This software and its source code are proprietary and confidential.
-No part of this software may be reproduced, distributed, modified,
-sublicensed, or used for commercial purposes without the prior written
-permission of the copyright holder.
+This software, its source code, and any compiled or bundled distribution
+of it are proprietary and confidential. No part of this software may be
+reproduced, distributed, modified, sublicensed, or used for commercial
+purposes without the prior written permission of the copyright holder.
 
-Access to the source code does not grant any rights of reuse,
-redistribution, or derivative work. Forking for the purpose of
-personal evaluation on the forker's own machine is permitted; any
-redistribution, public hosting, or resale is not.
+Reverse engineering. You may not decompile, disassemble, deobfuscate,
+extract source from compiled or minified bundles, or otherwise attempt
+to derive the source code of this software, except to the extent such
+restriction is expressly prohibited by applicable law. Tampering with
+or circumventing the license activation, revocation, or fingerprinting
+mechanisms is a material breach.
 
-Until a formal commercial license is published alongside the v0.6
-commercialization milestone, this notice governs all use of the
-software. The commercial license, once published, will supersede
-this notice.
+License keys. A license key is granted personally to the purchaser
+identified at activation time. License keys may not be sold, transferred,
+shared, sublicensed, or used by any person or organization other than
+the original purchaser. Each activated license is permitted on the
+specific machines registered through the activation flow and within the
+activation limit attached to the key.
 
-Trademarks: "Claude Recall" and the Claude Recall logo are trademarks
-of Claude Recall HQ. Nothing in this notice grants any trademark
-rights.
+Revocation. The copyright holder reserves the right to revoke any
+license for material breach of these terms. Material breach includes
+(without limitation): refunded purchases, license-key sharing or
+transfer, fraudulent or chargeback-disputed payments, automated abuse
+of activation endpoints, or any attempt to circumvent the protections
+described above. Upon revocation, the licensee's rights to use the
+software end immediately and the software may stop functioning on
+the next periodic license validation.
 
-No warranty: THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
+Permitted personal evaluation. Forking the repository, when access has
+been granted, for the purpose of personal evaluation on the forker's
+own machine is permitted. Any redistribution, public hosting, resale,
+or use for commercial purposes is not.
+
+Trademarks. "Claude Recall" and the Claude Recall logo are trademarks
+of Claude Recall HQ. Nothing in this notice grants any trademark rights.
+
+Severability. If any provision of this license is held to be
+unenforceable, the remaining provisions remain in full force.
+
+No warranty. 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

package/README.md

@@ -1,9 +1,9 @@
 <div align="center">
 
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/clauderecallhq/.github/main/profile/assets/wordmark-dark.svg">
-  <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/clauderecallhq/.github/main/profile/assets/wordmark-light.svg">
-  <img src="https://raw.githubusercontent.com/clauderecallhq/.github/main/profile/assets/wordmark-dark.svg" alt="Claude Recall" width="400">
+  <source media="(prefers-color-scheme: dark)" srcset="https://clauderecall.com/wordmark-dark.svg">
+  <source media="(prefers-color-scheme: light)" srcset="https://clauderecall.com/wordmark-light.svg">
+  <img src="https://clauderecall.com/wordmark-dark.svg" alt="Claude Recall" width="400">
 </picture>
 
 <br />
@@ -15,6 +15,11 @@ Claude Recall indexes every Claude Code session you've ever run, surfaces what m
 
 <br />
 
+<img src="https://clauderecall.com/hero/brand-morph.gif" alt="Claude Recall — memory tree morphing into the wordmark" width="700">
+
+<br />
+<br />
+
 [![npm](https://img.shields.io/npm/v/@clauderecallhq/cli?style=flat-square&color=f97316&label=npm)](https://www.npmjs.com/package/@clauderecallhq/cli)
 [![Node](https://img.shields.io/badge/node-%E2%89%A520-43853d?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org)
 [![TypeScript](https://img.shields.io/badge/typescript-strict-3178c6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
@@ -141,8 +146,9 @@ recall search "auth #auth-fix" -p Pest-Control
 ### On-Device Vector Search &nbsp;<sub>Pro</sub>
 Local **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.
 
+The embedder model (~110MB) auto-downloads on `npm install`. Skip with `RECALL_SKIP_MODEL_DOWNLOAD=1`.
+
 ```bash
-recall semantic install
 recall similar <session-id>
 ```
 
@@ -285,6 +291,19 @@ recall open
 
 The 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.
 
+### Browse
+
+Two interactive surfaces, both work without the daemon (they read SQLite directly):
+
+```bash
+recall                    # smart welcome dashboard with status + slash command palette
+recall tui                # full terminal UI: arrow-key browse, live search, preview pane
+```
+
+`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).
+
+`recall tui` mounts an Ink-based 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.
+
 ### Explore
 
 ```bash
@@ -308,6 +327,44 @@ recall context abc12345 --prelude "continue where we left off" | claude
 recall context abc12345 --since 2h | claude
 ```
 
+### How Claude Recall integrates with Claude Code
+
+Don'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:
+
+**1. Bash tool — always available, zero setup.**
+
+Inside 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.
+
+**2. Slash commands (skills) — one-tap workflows.**
+
+When Claude Recall is installed as a Claude Code plugin, typing `/` in Claude Code surfaces ready-made workflows:
+
+| Slash command | What it does |
+|---|---|
+| `/claude-recall:recall <query>` | Search past sessions and pull relevant ones in as context |
+| `/claude-recall:context <id>` | Load one specific session's full transcript |
+| `/claude-recall:neighborhood <id>` | Bundle parents + children + citations + similar |
+| `/claude-recall:tag <id> <tag>` | Tag a session for later retrieval |
+| `/claude-recall:alias <id> <name>` | Rename a session |
+| `/claude-recall:threads-sync` | Capture currently active terminals into a thread |
+| `/claude-recall:thread-scan` | Auto-detect threads across historical sessions |
+| `/claude-recall:setup` | Verify installation and MCP connection |
+
+**3. MCP server — the model calls Recall directly.**
+
+The 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.
+
+**4. Piping into a fresh `claude` — start tomorrow with yesterday's context.**
+
+The cross-session continuation pattern, run from your shell:
+
+```bash
+recall neighborhood abc12345 | claude   # bundle related sessions, start fresh chat
+recall context abc12345 | claude        # one specific session, start fresh chat
+```
+
+Use 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.
+
 ### MCP Server
 
 Point any MCP client at Recall and the model calls it as native tools:
@@ -323,11 +380,11 @@ Point any MCP client at Recall and the model calls it as native tools:
 ```
 
 <details>
-<summary><strong>Available MCP tools (31 total)</strong></summary>
+<summary><strong>Available MCP tools (33 total)</strong></summary>
 
 <br />
 
-**Read tools (13 -- always available):**
+**Read tools (14 -- always available):**
 
 | Tool | Purpose |
 |---|---|
@@ -341,11 +398,12 @@ Point any MCP client at Recall and the model calls it as native tools:
 | `semantic_status` | Health snapshot: model, worker, queue depth (Pro) |
 | `get_session` | Full transcript (accepts 8+ char id prefix) |
 | `context_for_session` | Condensed markdown export, ready to inject |
+| `recall_neighborhood` | Bundle parents/children/citations/similar as one budget-bounded markdown blob |
 | `thread_list` | All threads, newest first; can exclude archived |
 | `thread_get` | Full thread detail with every session edge |
 | `thread_for_session` | Non-archived threads referencing a session |
 
-**Write tools (18 -- opt-in via `--allow-writes`):**
+**Write tools (19 -- opt-in via `--allow-writes`):**
 
 | Tool | Purpose |
 |---|---|
@@ -364,6 +422,7 @@ Point any MCP client at Recall and the model calls it as native tools:
 | `thread_archive` | Soft-delete thread; hidden by default |
 | `thread_merge` | Move all edges from source to dest, delete source |
 | `thread_split` | Peel sessions into new thread |
+| `sync_active_sessions` | Capture currently-active terminals in a repo into a thread (Captain Code Pattern) |
 | `generate_thread_titles` | Generate coherent titles for sessions in thread DAG |
 
 All writes are rate-limited (default 60/min), zod-validated, and audited to `~/.recall/audit/`.
@@ -446,6 +505,10 @@ Claude Recall is **local-first by design**, not as an afterthought.
 <br />
 
 ```bash
+# Surfaces
+recall                    # smart welcome dashboard + slash command palette (no args)
+recall tui                # interactive terminal UI for browsing and search
+
 # Lifecycle
 recall start              # start daemon (watcher + local HTTP)
 recall stop               # stop daemon
@@ -492,9 +555,11 @@ recall correlate               # link sessions to commits
 recall blame <sha>             # commit -> session reverse lookup
 
 # Semantic / vector search (Pro)
-recall semantic install        # download on-device embedding model
-recall semantic status         # model + backfill progress
+# Embedder model auto-installs on `npm install`; manual install also available.
+recall semantic install        # download on-device embedding model (auto-runs on npm install)
+recall semantic status         # model + backfill progress + auto-extract state
 recall semantic reindex        # re-embed everything
+recall semantic auto-extract on  # daemon nibbles un-extracted sessions through Claude (Pro)
 recall similar <id>            # cosine kNN over session chunks
 
 # Threads (v0.15a)
@@ -556,6 +621,29 @@ recall audit-secrets           # scan index for residual secrets
 
 <br />
 
+## Supported Platforms
+
+Claude 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.
+
+| Platform | Tier | Status |
+|---|---|---|
+| **macOS** arm64 (Apple Silicon, M1+) | Tier 1 | Tested in pre-publish smoke test |
+| **macOS** x64 (Intel) | Tier 1 | Tested in pre-publish smoke test |
+| **Linux** x64 (glibc, kernel 4.x+) | Tier 1 | Tested on every CI run (Node 22, 24) |
+| **Linux** arm64 (glibc) | Tier 2 | Best-effort. Native deps ship arm64 prebuilds; report issues if you hit one |
+| **Windows** x64 (Windows 10+) | Tier 1 | Tested in pre-publish smoke test |
+| Windows arm64 / Linux musl (Alpine) / 32-bit | Unsupported | Native deps lack reliable prebuilds; install will be rejected |
+
+**Node:** 22 LTS or 24 LTS. Node 20 and earlier are unsupported (declared in `engines.node`).
+
+**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.
+
+<br />
+
+---
+
+<br />
+
 ## Distribution
 
 Claude Recall ships on every surface a developer already works in.
@@ -603,13 +691,13 @@ npm install -g @clauderecallhq/cli
 
 ### Pro &nbsp;<sub>← daily driver</sub>
 
-**$29.69 one-time**
-Pay once. Offline forever. Dead-man clause included.
-*Less than two coffees a year out.*
+**$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.
 
 - Full-text search (FTS5 BM25)
 - On-device semantic vector search (768d, RRF fusion)
-- `recall context` re-injection -- **the moat**
+- `recall context` re-injection, **the moat**
 - MCP server (Claude Desktop / Claude Code native tools)
 - VS Code / Cursor / Windsurf extension
 - Aliases, tags, markdown notes, pins, date filters, cross-session diff
@@ -619,7 +707,7 @@ Pay once. Offline forever. Dead-man clause included.
 - Secrets redaction (client-side scrub of keys, tokens, passwords pre-index)
 - **Every future personal-use feature.** One price, lifetime updates.
 
-[**Buy Pro for $29.69 →**](https://clauderecall.com/pricing)
+[**Buy Pro for $29.69 (Founder pricing through May) →**](https://clauderecall.com/pricing)
 
 </td>
 <td width="33%" valign="top">
@@ -627,7 +715,7 @@ Pay once. Offline forever. Dead-man clause included.
 ### Enterprise
 
 **Contact us**
-Priced per deal.
+Built for 50+ developer organizations.
 
 - Shared session library with end-to-end encrypted team sync
 - Team-wide tag conventions
@@ -648,13 +736,13 @@ Priced per deal.
 
 | Tool | Price |
 |---|---|
-| **Claude Recall** | **$29.69 one-time** |
+| **Claude Recall** | **$29.69 one-time** through May 2026, **$49.69 one-time** from June |
 | Claude Code | $20 / mo |
 | Cursor | $20 / mo |
-| Raycast Pro | $8–$16 / mo |
+| Raycast Pro | $8 to $16 / mo |
 | GitHub Copilot | $10 / mo |
 
-<sub>Prices as of April 2026.</sub>
+<sub>Prices as of May 2026.</sub>
 
 <br />
 
@@ -704,8 +792,8 @@ Full pricing FAQ: **[clauderecall.com/pricing](https://clauderecall.com/pricing)
 <div align="center">
 
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/clauderecallhq/.github/main/profile/assets/mark-scrollback-dark.svg">
-  <img src="https://raw.githubusercontent.com/clauderecallhq/.github/main/profile/assets/mark-scrollback-dark.svg" alt="Claude Recall" width="48">
+  <source media="(prefers-color-scheme: dark)" srcset="https://clauderecall.com/mark-scrollback-dark.svg">
+  <img src="https://clauderecall.com/mark-scrollback-dark.svg" alt="Claude Recall" width="48">
 </picture>
 
 <br />
@@ -713,10 +801,10 @@ Full pricing FAQ: **[clauderecall.com/pricing](https://clauderecall.com/pricing)
 
 **Claude Recall** -- the memory layer for the agent you're steering.
 
-[Website](https://clauderecall.com) &nbsp;&middot;&nbsp; [Install](https://www.npmjs.com/package/@clauderecallhq/cli) &nbsp;&middot;&nbsp; [Issues](https://github.com/clauderecallhq/.github/issues)
+[Website](https://clauderecall.com) &nbsp;&middot;&nbsp; [Install](https://www.npmjs.com/package/@clauderecallhq/cli) &nbsp;&middot;&nbsp; [Issues](https://gitlab.com/clauderecallhq/clauderecallhq/-/issues)
 
 <br />
 
-<sub>Built by <a href="https://github.com/clauderecallhq">@clauderecallhq</a></sub>
+<sub>Built by <a href="https://gitlab.com/clauderecallhq">@clauderecallhq</a></sub>
 
 </div>