NexusMem for VS Code

Search a NexusMem-tracked repository's remembered history — git commits, code diffs, shell commands (with exit codes), tracked docs and (if enabled) conversation transcripts — from the command palette, without leaving the editor.

This is an early, minimal surface: a search command, a read-only results panel, a sidebar list of what's been remembered lately, a sync command, and a proactive check when a terminal command fails. It talks to the same MCP server (nexusmem mcp) that Claude Desktop, Cursor and Windsurf already use against this codebase — no new server-side surface for search, sync or live detection, just a client for the existing one (plus one new tool, list_recent_memory, for the sidebar).

Live terminal-failure detection: npm whoami fails, and NexusMem — recognizing this exact command has failed and later been fixed before, from this repository's own history — says so immediately.

Requirements

• NexusMem installed and on PATH:

  npm install -g nexusmem
  

• The repository needs to be initialized and synced at least once before there's anything to search or list — either from a terminal (nexusmem init && nexusmem sync) or with NexusMem: Sync Memory below, which does both.

Usage

1. Open a folder that is a NexusMem-tracked git repository.
2. Run NexusMem: Search Memory from the command palette (Ctrl+Shift+P / Cmd+Shift+P).
3. Type a free-text query (e.g. why did npm whoami fail). Results open in a panel beside the editor: the packed, token-budgeted context block NexusMem would hand an agent, plus match/token stats.

Sync

NexusMem: Sync Memory (command palette, or the ↻-adjacent sync button in the sidebar's title bar) ingests new git/diff/shell/docs history and embeds it — the same as running nexusmem sync in a terminal, without leaving the editor. Initializes the repository first if it hasn't been already. The summary goes to the NexusMem output channel (a toast offers to open it); the sidebar refreshes itself afterward automatically.

Recent Memory sidebar

The Explorer view (Ctrl+Shift+E / Cmd+Shift+E) gains a NexusMem: Recent Memory panel: the most recently remembered items for the open repository, newest first — chronology, not a search. Click a row to search for it (pre-fills the query above with that item's title). Refresh with the ↻ button in the panel's title bar; it also loads once automatically when the extension activates.

Live terminal-failure detection

When a command in an integrated terminal exits non-zero, NexusMem checks its memory for that command in the background. If there's a match (e.g. a past run of the same command that later succeeded, or a related fix), a notification offers Show details, which opens the same results panel as a manual search. Silent when there's no match — this is meant to surface something genuinely useful, not to comment on every failed command.

Depends on VS Code's terminal shell integration actually being active for your shell (the status bar / a colored bar next to the prompt is the usual tell). If it isn't, this feature quietly does nothing rather than erroring — everything else in this extension still works.

Settings

Development

npm install
npm run typecheck
npm run compile   # -> dist/extension.js
npm test          # vitest; the stdio integration test builds the root NexusMem CLI first

Then, from VS Code, open this folder and press F5 to launch an Extension Development Host.