recall

Claude Recall Plugin v2.2.3

A Claude Code plugin that persists conversation context across sessions, /clear commands, and compaction events. It adds cross-session search, tagging, highlight sharing between sessions, and observability.

Marketplace Status: Published in Anthropic's community marketplace (recall@claude-community). The catalog currently pins an older version while a refresh is in review (claude-plugins-community#1121); until it lands, install from the pre-built marketplace below to get the current release.

Pre-built Marketplace: claude-recall-marketplace (always serves the latest release)

Why Recall (vs. native Claude Code)

Claude Code ships with /recap, /resume, and a memory/ directory. Recall is positioned around what those do not cover:

• Cross-project full-text search (FTS5). Native /recap and /resume operate within the current session/project. Recall indexes every exchange into SQLite FTS5 and searches across all sessions in a project (--all) or across every project (--global) — including past, closed sessions.
• Tagging. Apply manual tags to sessions or individual exchanges, plus automatic keyword extraction, then query them across projects (/recall tag, /recall tags, /recall search --tag). The native memory/ directory is freeform notes, not a queryable tag index.
• Highlight & connection sharing between parallel sessions. Link two live sessions and share findings as lightweight highlights delivered to a connected session's inbox (/recall connect, /recall highlight, /recall inbox). Native Claude Code has no mechanism to push a finding from one session to another.

If you only need to re-anchor within the current session, native /recap / /resume may be enough. Recall is for cross-session, cross-project retrieval, tagging, and sharing.

Requirements

• Claude Code 2.0.x or 2.1.x (see breaking change note below for 2.1.x), or Claude Cowork (macOS desktop app)
• Python 3.6+ (for hook and script execution)

UPDATE: Claude Code 2.1.x Breaking Change

As of Claude Code 2.1.x, local plugins no longer persist across sessions. This is an undocumented breaking change from 2.0.x behavior. See issue #17089.

Custom plugins now require a marketplace structure to work reliably with the VSCode extension. The --plugin-dir flag only works with the CLI, not VSCode.

Installation

Claude Cowork (macOS Desktop App)

From GitHub:

1. Open the Claude Desktop app
2. Navigate to the Cowork tab
3. Click "Plugins" in the left sidebar
4. Click "Add from GitHub"
5. Enter: https://github.com/bledden/claude-recall-plugin

From zip file:

1. Download claude-recall-plugin.zip
2. In the Cowork Plugins sidebar, click "Upload plugin"
3. Select the downloaded claude-recall-plugin.zip file

The plugin will appear in your Cowork plugins list. Invoke with /recall during a Cowork session.

Claude Code: Option 1 - Pre-Built Marketplace (Recommended for VSCode)

This is the recommended method: it always serves the latest release, and it is the only reliable method for the VSCode extension. (The community-marketplace listing recall@claude-community works too, but currently pins an older version until the refresh in review lands.)

claude plugin marketplace add https://github.com/bledden/claude-recall-marketplace
claude plugin install recall@recall-local

The plugin will now persist across sessions in both CLI and VSCode.

# Clone this repo
git clone https://github.com/bledden/claude-recall-plugin.git

# Create a marketplace wrapper
mkdir -p claude-recall-marketplace/.claude-plugin
mkdir -p claude-recall-marketplace/plugins
cp -R claude-recall-plugin claude-recall-marketplace/plugins/recall

{
  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  "name": "recall-local",
  "version": "2.2.2",
  "description": "Local marketplace for the recall plugin",
  "owner": {
    "name": "your-name",
    "email": "[email protected]"
  },
  "plugins": [
    {
      "name": "recall",
      "description": "Recover conversation context when Claude loses track",
      "source": "./plugins/recall",
      "category": "productivity"
    }
  ]
}