Claude Recall for VS Code

Never lose a Claude Code session again. Label every session with the name of the terminal it ran in. Automatically.

Claude Recall is a local-first memory tool that indexes every Claude Code session you have ever run and makes them searchable from the recall CLI, a browser UI, and an MCP server. This extension is the VS Code companion that gives every session a meaningful name with zero manual steps. Renames in your editor propagate to your session library automatically.

_{The library this extension keeps labeled for you.}

_{Claude calls Recall as native MCP tools. Searches your history. Pulls context. Decides.}

_{Cost analytics. Hover any day. Exact cost. Exact tokens.}

_{Collections. Drag-to-organize sessions across projects.}

_{Or stay in the terminal. recall tui ships the same library as a full-screen terminal app.}

_{Built specifically for Claude Code, not adapted from notes apps.}

What it does

1. Name your terminal tabs the way you already do (auth-refactor, billing-bug, dashboard-v2).
2. Run claude in any of those tabs as you normally would.
3. The session shows up in Claude Recall labeled with the tab name within a couple seconds. Rename the tab mid-session and the alias updates live.

Works in VS Code, VS Code Insiders, Cursor, and Windsurf.

What's new in 0.18

Tab names flow through every time, no matter what

The 0.18 series fixes a regression where the extension was silently rejected by newer daemons that require an auth token. Symptom: sessions stopped picking up your tab name and fell back to the heuristic first-message snippet. Fix: the extension now reads ~/.recall/daemon.token on every request and attaches it as X-Recall-Token. Older daemons without the token still work; the header is simply omitted.

Pipeline-health visibility in recall doctor

A new diagnostics section in recall doctor reports the live state of the tab-name → session-alias chain: how many extension requests the daemon rejected, when the last successful sync was, and what fraction of recent sessions fell back to the heuristic title. If something silently breaks the chain, you see it in five seconds, not eighteen hours.

Real version in daemon logs

The User-Agent string clauderecall-vscode/X.Y.Z is now sourced from the extension's actual package.json at activation time, so daemon access logs always show the real client version instead of a stale literal.

Recent releases

Full history: CHANGELOG.md.

Install

Open the Extensions panel (Cmd+Shift+X / Ctrl+Shift+X), search Claude Recall, install the entry by publisher clauderecallhq.

You also need the Recall daemon running. Install the CLI:

npm install -g @clauderecallhq/cli
recall start

Requires Node 22 LTS or newer on macOS (Apple Silicon / Intel), Linux x64 / arm64 (glibc), or Windows 10+ x64.

Enable

In VS Code settings (Cmd+, / Ctrl+,) flip claude-recall.autoAlias to true. A ⟳ Recall · N indicator appears in the status bar showing how many terminals are connected to your session library.

Settings

Commands

How it works

1. The extension watches every VS Code terminal you have open. It reports the tab name to the local Claude Recall daemon and updates that name whenever you rename the tab.
2. When you run claude in a terminal, the extension tells the daemon which terminal you started it from.
3. The daemon uses that to label the new session with the terminal's tab name.
4. For sessions that ran before the daemon knew about them, the v0.12 scrollback matcher reconnects them by spotting verbatim text from the conversation in your open terminal buffers.

Everything happens on your machine. Nothing about your code, prompts, or terminal output ever leaves 127.0.0.1.

Troubleshooting

Status bar shows ⊘ Recall Auto-alias is off. Flip claude-recall.autoAlias to true in settings.

Status bar shows nothing The Recall daemon is not running. Run recall status to check, recall start to fix.

Status bar shows ⟳ Recall · 0 but terminals are open Run Claude Recall: Re-register all open terminals from the command palette.

Renames in VS Code not appearing in Claude Recall Open the Claude Recall Output channel from the View menu. Every rename the extension detects is logged there with the before and after tab name. If you do not see your rename in the log, try renaming the tab one more time. Some terminal title overrides from other extensions can race with our detection on the first edit.

An old session is still showing as unlinked Open it in the web UI. With 0.12+ installed, the system tries to relink it the moment you open it by matching scrollback content from your live terminals. If the original terminal was closed long ago, click the chain icon next to the title and pick the right terminal from the list.

Privacy

We promise three things:

1. Nothing leaves your machine. Every byte the extension produces is bound for 127.0.0.1 and the local daemon. There are no outbound network calls. No telemetry. No analytics.
2. Secrets get redacted before they leave the extension. The redaction filter runs inside the extension on every byte of terminal output. Anthropic, OpenAI, GitHub, AWS, Slack-style keys, Bearer tokens, JWTs, and PASSWORD= / API_KEY= style assignments are replaced with placeholders before the daemon ever sees them.
3. The extension never reads your code. No editor buffer access. No clipboard. No files outside the daemon's port file.

What the extension actually sends to the daemon, in plain English:

Buffers live in daemon memory only. They never reach disk.

Built for security teams

• Zero runtime dependencies. The published .vsix ships only our own bundled JavaScript, an icon, and metadata. There is no transitive supply chain to audit.
• Localhost-only by construction. The HTTP client refuses any host other than 127.0.0.1. The connection target is enforced in code, not configuration.
• No webview, no HTML rendering. The extension's only UI surface is a status bar text indicator.
• Hard timeouts on every daemon request so a hung daemon never blocks the editor.

Links

• Product site: clauderecall.com
• CLI on npm: @clauderecallhq/cli
• Pricing & Pro: clauderecall.com/pricing
• Public profile: gitlab.com/clauderecallhq/clauderecallhq
• Send feedback from inside the CLI: recall feedback
• Changelog: CHANGELOG.md