@clauderecallhq/cli 0.12.0 → 0.12.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +468 -413
  2. package/package.json +3 -3
  3. package/README.public.md +0 -523
package/package.json CHANGED
@@ -1,15 +1,15 @@
1
1
  {
2
2
  "name": "@clauderecallhq/cli",
3
- "version": "0.12.0",
3
+ "version": "0.12.1",
4
4
  "description": "Never lose a Claude Code session again. Local, fast, searchable memory over every session you've ever run.",
5
5
  "type": "module",
6
6
  "homepage": "https://clauderecall.com",
7
7
  "repository": {
8
8
  "type": "git",
9
- "url": "git+https://github.com/citizencapet/claude-recall.git"
9
+ "url": "git+https://github.com/clauderecallhq/.github.git"
10
10
  },
11
11
  "bugs": {
12
- "url": "https://github.com/citizencapet/claude-recall/issues"
12
+ "url": "https://github.com/clauderecallhq/.github/issues"
13
13
  },
14
14
  "bin": {
15
15
  "recall": "./dist/cli.js",
package/README.public.md DELETED
@@ -1,523 +0,0 @@
1
- <div align="center">
2
-
3
- <picture>
4
- <source media="(prefers-color-scheme: dark)" srcset="marketing/logos/wordmark-dark.svg">
5
- <source media="(prefers-color-scheme: light)" srcset="marketing/logos/wordmark-light.svg">
6
- <img src="marketing/logos/wordmark-dark.svg" alt="Claude Recall" width="400">
7
- </picture>
8
-
9
- <br />
10
- <br />
11
-
12
- **Stop re-explaining your project to Claude every morning.**
13
-
14
- Claude Recall indexes every Claude Code session you've ever run, surfaces what matters,<br />and pipes the right context back in with one command.
15
-
16
- <br />
17
-
18
- [![npm](https://img.shields.io/npm/v/@clauderecallhq/cli?style=flat-square&color=f97316&label=npm)](https://www.npmjs.com/package/@clauderecallhq/cli)
19
- [![Node](https://img.shields.io/badge/node-%E2%89%A522-43853d?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org)
20
- [![TypeScript](https://img.shields.io/badge/typescript-strict-3178c6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
21
- [![Local-first](https://img.shields.io/badge/local--first-127.0.0.1%20only-0b0c0f?style=flat-square)](#privacy--security)
22
- [![License](https://img.shields.io/badge/license-proprietary-1a1a2e?style=flat-square)](#license)
23
- [![Site](https://img.shields.io/badge/clauderecall.com-f97316?style=flat-square&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld0JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9IndoaXRlIiBzdHJva2Utd2lkdGg9IjIiPjxjaXJjbGUgY3g9IjEyIiBjeT0iMTIiIHI9IjEwIi8+PGxpbmUgeDE9IjIiIHkxPSIxMiIgeDI9IjIyIiB5Mj0iMTIiLz48cGF0aCBkPSJNMTIgMmExNS4zIDE1LjMgMCAwIDEgNCAxMCAxNS4zIDE1LjMgMCAwIDEtNCA4IDEwIi8+PC9zdmc+)](https://clauderecall.com)
24
-
25
- <br />
26
-
27
- <sub>100% local. No cloud. No account. No telemetry. Your conversations never leave your machine.</sub>
28
-
29
- </div>
30
-
31
- <br />
32
-
33
- ---
34
-
35
- <br />
36
-
37
- ## The Problem
38
-
39
- Claude Code is incredible until the conversation ends. Then you hit three walls:
40
-
41
- <table>
42
- <tr>
43
- <td width="33%" valign="top">
44
-
45
- ### Context Amnesia
46
-
47
- Every new `claude` invocation starts from zero. You re-explain the architecture, re-paste the key files, re-describe the bug you already fixed yesterday.
48
-
49
- You built that context pyramid once. Now you're building it again.
50
-
51
- </td>
52
- <td width="33%" valign="top">
53
-
54
- ### Cost Blindness
55
-
56
- Claude Code tells you nothing about spend after a session ends. Which session burned through tokens? Which project is quietly eating half your Anthropic bill?
57
-
58
- You're guessing.
59
-
60
- </td>
61
- <td width="33%" valign="top">
62
-
63
- ### Session Sprawl
64
-
65
- Claude 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.
66
-
67
- Dozens of projects. Hundreds of sessions. Zero discoverability.
68
-
69
- </td>
70
- </tr>
71
- </table>
72
-
73
- <br />
74
-
75
- ## The Fix
76
-
77
- ```bash
78
- npm install -g @clauderecallhq/cli
79
- recall start
80
- recall open
81
- ```
82
-
83
- That'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:
84
-
85
- ```bash
86
- # The moat: past session -> new conversation
87
- recall context abc12345 | claude
88
- ```
89
-
90
- Claude picks up where you left off instead of asking you to explain it again.
91
-
92
- <br />
93
-
94
- ---
95
-
96
- <br />
97
-
98
- ## Features
99
-
100
- <table>
101
- <tr>
102
- <td width="50%" valign="top">
103
-
104
- ### Search Everything
105
- Full-text search across 100,000+ messages in milliseconds. BM25 ranking, highlighted snippets, inline `#tag` filters.
106
-
107
- ```bash
108
- recall search "zod schema"
109
- recall search "auth #auth-fix"
110
- ```
111
-
112
- </td>
113
- <td width="50%" valign="top">
114
-
115
- ### Context Re-injection
116
- The core feature. Pipe any past session into a new Claude Code conversation as condensed markdown. Runs locally, never touches the network.
117
-
118
- ```bash
119
- recall context <id> | claude
120
- recall context <id> --prelude "continue this" | claude
121
- ```
122
-
123
- </td>
124
- </tr>
125
- <tr>
126
- <td width="50%" valign="top">
127
-
128
- ### Cost Analytics
129
- Per-session and per-project token + dollar totals. Daily sparkline. Top-10 heaviest sessions. Know exactly where your Anthropic bill is going.
130
-
131
- ```bash
132
- recall stats <id>
133
- recall stats --project Tools
134
- recall stats --days 7
135
- ```
136
-
137
- </td>
138
- <td width="50%" valign="top">
139
-
140
- ### Git Correlation
141
- Every session links to commits authored in its working directory during its time window. Reverse-map any commit back to the session that produced it.
142
-
143
- ```bash
144
- recall correlate
145
- recall blame <sha>
146
- ```
147
-
148
- </td>
149
- </tr>
150
- <tr>
151
- <td width="50%" valign="top">
152
-
153
- ### Semantic Search
154
- Conceptual search powered by your local `claude` CLI. Find "the session where I debugged the worker memory leak" without remembering exact words.
155
-
156
- ```bash
157
- recall semantic on
158
- recall semantic backfill
159
- ```
160
-
161
- </td>
162
- <td width="50%" valign="top">
163
-
164
- ### MCP Server
165
- Expose Recall to Claude Desktop, Claude Code, or any MCP client as native tools. Read-only by default, opt-in write tools with rate limiting and audit logging.
166
-
167
- ```bash
168
- recall mcp
169
- recall mcp --allow-writes
170
- ```
171
-
172
- </td>
173
- </tr>
174
- <tr>
175
- <td width="50%" valign="top">
176
-
177
- ### Collections & Tags
178
- Hand-curated hierarchical groupings of sessions that cut across projects. Human-readable aliases. Auto-tagging via your Anthropic API key or Claude CLI (zero extra cost).
179
-
180
- </td>
181
- <td width="50%" valign="top">
182
-
183
- ### Web UI
184
- Beautiful dark-mode three-pane layout. Virtualized transcript rendering (10,000-message sessions open instantly). `Cmd+K` command palette. Multi-select. Export to markdown, HTML, or PDF.
185
-
186
- </td>
187
- </tr>
188
- </table>
189
-
190
- <br />
191
-
192
- <details>
193
- <summary><strong>More: VS Code extension, cross-session diff, onboarding, keyboard shortcuts...</strong></summary>
194
-
195
- <br />
196
-
197
- - **VS Code / Cursor / Windsurf extension** -- auto-names sessions using terminal tab names via process-tree matching
198
- - **Cross-session diff** -- split view of two transcripts with shareable `cmp=` URL
199
- - **First-run onboarding** -- a 3-step tour that demos the moat in the first 60 seconds
200
- - **Multi-select sessions** -- `Cmd+Click` to toggle, `Shift+Click` for range, right-click to copy IDs
201
- - **Export** -- condensed markdown, full markdown, self-contained dark-mode HTML, print-ready PDF
202
- - **Cmd+K command palette** -- jump to any session, action, or setting in one keystroke
203
-
204
- #### Keyboard Shortcuts
205
-
206
- | Key | Action |
207
- |---|---|
208
- | `/` | Focus search |
209
- | `?` | Open Command Center |
210
- | `Cmd+K` / `Ctrl+K` | Command palette |
211
- | `Esc` | Close / clear / dismiss |
212
- | `n` / `p` | Next / previous search match |
213
- | `c` | New collection |
214
- | `Cmd+Shift+A` | Add session to collection |
215
- | `Cmd+Enter` | Save note |
216
-
217
- </details>
218
-
219
- <br />
220
-
221
- ---
222
-
223
- <br />
224
-
225
- ## Quick Start
226
-
227
- ### Install
228
-
229
- ```bash
230
- npm install -g @clauderecallhq/cli
231
- ```
232
-
233
- ### Start
234
-
235
- ```bash
236
- # Start the background daemon (file watcher + local HTTP server)
237
- recall start
238
-
239
- # Open the web UI
240
- recall open
241
- ```
242
-
243
- 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.
244
-
245
- ### Explore
246
-
247
- ```bash
248
- recall projects # list projects with session counts
249
- recall list # 30 most-recent sessions
250
- recall list -p Tools # filter by project
251
- recall show <id> # pretty-printed transcript
252
- recall search "auth bug" # full-text search
253
- ```
254
-
255
- ### The Moat
256
-
257
- ```bash
258
- # Pipe a past session into a new Claude Code conversation
259
- recall context abc12345 | claude
260
-
261
- # With a custom instruction
262
- recall context abc12345 --prelude "continue where we left off" | claude
263
-
264
- # Just the last 2 hours
265
- recall context abc12345 --since 2h | claude
266
- ```
267
-
268
- ### MCP Server
269
-
270
- Point any MCP client at Recall and the model calls it as native tools:
271
-
272
- ```json
273
- {
274
- "mcpServers": {
275
- "recall": {
276
- "command": "claude-recall-mcp"
277
- }
278
- }
279
- }
280
- ```
281
-
282
- <details>
283
- <summary><strong>Available MCP tools</strong></summary>
284
-
285
- <br />
286
-
287
- **Read-only (always available):**
288
-
289
- | Tool | Purpose |
290
- |---|---|
291
- | `list_projects` | Every indexed project |
292
- | `list_sessions` | Recent sessions, filterable by project / tag / date |
293
- | `list_tags` | Tag cloud with counts |
294
- | `search` | Full-text search with `#tag` support |
295
- | `get_session` | Full transcript (accepts 8+ char id prefix) |
296
- | `context_for_session` | Condensed markdown export |
297
-
298
- **Write tools (opt-in via `--allow-writes`):**
299
-
300
- | Tool | Purpose |
301
- |---|---|
302
- | `add_tag` / `remove_tag` | Organize sessions from inside Claude |
303
- | `set_alias` | Rename a session |
304
- | `append_note` | Add to a session's markdown note |
305
- | `create_collection` | Create a new collection |
306
- | `add_session_to_collection` | Curate memberships |
307
-
308
- All writes are rate-limited, zod-validated, and audited.
309
-
310
- </details>
311
-
312
- <br />
313
-
314
- ---
315
-
316
- <br />
317
-
318
- ## How It Works
319
-
320
- ```
321
- ~/.claude/projects/**/*.jsonl <-- Claude Code's session files (read-only)
322
- |
323
- v chokidar file watcher
324
- ~/.recall/db.sqlite <-- indexed database (FTS5 full-text search)
325
- |
326
- +-----+-----+
327
- | |
328
- CLI HTTP server (Hono, 127.0.0.1 only)
329
- | |
330
- recall ... Web UI (React + Tailwind SPA)
331
- ```
332
-
333
- ### Data stays local
334
-
335
- | Path | What |
336
- |---|---|
337
- | `~/.recall/db.sqlite` | Indexed database (projects, sessions, messages, FTS5, aliases, notes, tags, collections, semantic summaries, commit links, usage rollups, audit logs) |
338
- | `~/.recall/aliases.json` | Plain-text mirror of every alias with full edit history |
339
- | `~/.recall/notes/<session>.md` | One markdown file per session note |
340
- | `~/.recall/tags.json` | Current tag state + append-only event log |
341
- | `~/.recall/collections.json` | Current tree state + append-only event log |
342
-
343
- <br />
344
-
345
- ---
346
-
347
- <br />
348
-
349
- ## Privacy & Security
350
-
351
- Claude Recall is **local-first by design**, not as an afterthought.
352
-
353
- - The daemon binds to **`127.0.0.1` only**. Never `0.0.0.0`, never a public interface.
354
- - **No telemetry.** No analytics. No outbound network calls. The only exception is a one-time license check when you activate a Pro key.
355
- - **No cloud. No account.** Your data lives at `~/.recall/` and nowhere else.
356
- - **Source sessions are never modified.** Claude Code's JSONL files at `~/.claude/projects/` are strictly read-only to Recall.
357
- - **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.
358
-
359
- <br />
360
-
361
- ---
362
-
363
- <br />
364
-
365
- ## Full CLI Reference
366
-
367
- <details>
368
- <summary><strong>Click to expand</strong></summary>
369
-
370
- <br />
371
-
372
- ```bash
373
- # Lifecycle
374
- recall start # start daemon (watcher + local HTTP)
375
- recall stop # stop daemon
376
- recall open # open web UI (starts daemon if needed)
377
- recall status # db + daemon health
378
-
379
- # Indexing
380
- recall index # scan for new/changed session files
381
- recall index --force # reindex everything
382
-
383
- # Explore
384
- recall projects # list projects with session counts
385
- recall list # 30 most-recent sessions
386
- recall list -p Tools # filter by project substring
387
- recall list -n 100 # higher limit
388
-
389
- # Read
390
- recall show <id> # pretty transcript, auto-paged
391
- recall show <id> --raw # raw JSONL
392
- recall show <id> --no-pager
393
-
394
- # Search
395
- recall search "zod schema"
396
- recall search "auth" -p Pest-Control
397
- recall search bug -n 50
398
-
399
- # Context re-injection
400
- recall context <id> # condensed markdown
401
- recall context <id> | pbcopy # to clipboard (macOS)
402
- recall context <id> | claude # into new Claude session
403
- recall context <id> --full # full transcript
404
- recall context <id> --since 2h # last 2 hours only
405
- recall context <id> --prelude "continue this" # prepend instruction
406
- recall context <id> --subagents # include subagent messages
407
-
408
- # Stats
409
- recall stats <id> # tokens + dollars for one session
410
- recall stats --project Tools # per-project rollup
411
- recall stats --days 7 # 7-day overview
412
- recall stats --backfill # one-shot usage backfill
413
-
414
- # Git correlation
415
- recall correlate # link sessions to commits
416
- recall blame <sha> # commit -> session reverse lookup
417
-
418
- # Semantic search
419
- recall semantic on # enable conceptual search
420
- recall semantic status # backfill progress
421
- recall semantic backfill # run now
422
-
423
- # MCP server
424
- recall mcp # stdio, read-only
425
- recall mcp --allow-writes # opt-in write tools
426
- ```
427
-
428
- </details>
429
-
430
- <br />
431
-
432
- ---
433
-
434
- <br />
435
-
436
- ## Tech Stack
437
-
438
- | Layer | Technology |
439
- |---|---|
440
- | CLI + daemon | TypeScript 5 (strict), Node 22+, ESM |
441
- | HTTP server | Hono + @hono/node-server |
442
- | Database | better-sqlite3 with FTS5 full-text search |
443
- | File watcher | chokidar |
444
- | CLI parsing | commander |
445
- | MCP server | @modelcontextprotocol/sdk (stdio) |
446
- | Validation | zod |
447
- | Web UI | Vite 8 + React 19 + Tailwind CSS |
448
- | Data fetching | @tanstack/react-query |
449
- | Virtualization | @tanstack/react-virtual |
450
- | Markdown | marked + highlight.js + DOMPurify |
451
-
452
- <br />
453
-
454
- ---
455
-
456
- <br />
457
-
458
- ## Pricing
459
-
460
- | | Free | Pro |
461
- |---|---|---|
462
- | **Search** | Unlimited | Unlimited |
463
- | **Context re-injection** | Unlimited | Unlimited |
464
- | **Sessions indexed** | Unlimited | Unlimited |
465
- | **Cost analytics** | Unlimited | Unlimited |
466
- | **Git correlation** | Unlimited | Unlimited |
467
- | **MCP server** | Read-only | Read + Write |
468
- | **Semantic search** | -- | Included |
469
- | **Auto-tagging** | -- | Included |
470
- | **Price** | $0 | **$29.69 one-time** |
471
-
472
- No subscriptions. No recurring fees. Pay once, own it forever.
473
-
474
- <br />
475
-
476
- ---
477
-
478
- <br />
479
-
480
- ## Roadmap
481
-
482
- - [x] CLI, daemon, web UI, full-text search
483
- - [x] Context re-injection (the moat)
484
- - [x] Aliases, notes, tags, pins
485
- - [x] Cross-session diff
486
- - [x] VS Code / Cursor / Windsurf extension
487
- - [x] MCP server (read-only)
488
- - [x] Collections (hierarchical, cross-project)
489
- - [x] Auto-tagging
490
- - [x] Cost / token analytics
491
- - [x] Git correlation
492
- - [x] Semantic search
493
- - [x] Cmd+K command palette
494
- - [x] Bidirectional MCP write tools
495
- - [x] First-run onboarding
496
- - [ ] Public launch at clauderecall.com
497
- - [ ] Team features
498
-
499
- <br />
500
-
501
- ---
502
-
503
- <br />
504
-
505
- <div align="center">
506
-
507
- <picture>
508
- <source media="(prefers-color-scheme: dark)" srcset="marketing/logos/mark-scrollback-dark.svg">
509
- <img src="marketing/logos/mark-scrollback-dark.svg" alt="Claude Recall" width="48">
510
- </picture>
511
-
512
- <br />
513
- <br />
514
-
515
- **Claude Recall** -- the memory layer for the agent you're steering.
516
-
517
- [Website](https://clauderecall.com) &nbsp;&middot;&nbsp; [Install](https://www.npmjs.com/package/@clauderecallhq/cli) &nbsp;&middot;&nbsp; [Issues](https://github.com/citizencapet/claude-recall/issues)
518
-
519
- <br />
520
-
521
- <sub>Built by <a href="https://github.com/citizencapet">@citizencapet</a></sub>
522
-
523
- </div>