Skip to content

VS Code / Cursor / Windsurf extension (v0.7)

Automatically names Claude Code sessions with the terminal tab name you started them in.

Install

From the Marketplace (recommended): search Claude Recall in the VS Code / Cursor / Windsurf Extensions panel and install clauderecallhq.clauderecall-vscode. Direct link: marketplace.visualstudio.com/.../clauderecall-vscode.

Via the recall CLI (offline sideload): ships the bundled .vsix into every editor CLI it detects on your PATH.

recall install-extension           # installs into every detected editor
recall install-extension --editor cursor

From a local build:

cd extensions/vscode
npm install
npm run build
npm run package          # produces clauderecall-vscode-<version>.vsix
code --install-extension clauderecall-vscode-*.vsix
# Cursor: cursor --install-extension …
# Windsurf: windsurf --install-extension …

Or via GUI: Extensions → "..." menu → Install from VSIX.

Enable

VS Code settings (Cmd+,):

claude-recall.autoAlias: true

A ⟳ Recall · N indicator appears in the status bar — that's the number of terminals it has registered with the local daemon.

What it does

  • Watches VS Code's own terminal events (onDidOpenTerminal, rename, close)
  • POSTs { shell_pid, tab_name, cwd, opened_at } to your local daemon on 127.0.0.1:<port>
  • Daemon correlates: when a new Claude Code JSONL appears, lsof → parent-shell PID → registered tab name → auto-alias

What it does NOT do

  • Never reads terminal buffer / output
  • Never touches clipboard
  • Never reads editor buffers or files
  • Never makes outbound network calls — hardcoded to 127.0.0.1 / localhost only

Inspect the source at extensions/vscode/src/ — no minified or bundled third-party code.

Commands

| Palette entry | Purpose | |---|---| | Claude Recall: Show daemon status | Confirm the daemon is reachable | | Claude Recall: Re-register all open terminals | Manual refresh if daemon restarted |

Troubleshooting

  • Status bar shows ⊘ Recall — autoAlias is off in settings. Turn it on.
  • Status bar missing — daemon isn't running. recall start.
  • Tab named X but session aliased differently — a stale correlation. Run "Re-register all open terminals" from the palette.