recall

Claude Recall Plugin v2.2.0

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

Marketplace Status: Submitted via the official submission form at claude.ai/settings/plugins/submit.

Pre-built Marketplace: claude-recall-marketplace (for easy installation until approved)

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 only reliable method for the VSCode extension until the plugin is approved in the official marketplace.

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": "1.0.0",
  "description": "Local marketplace for the recall plugin",
  "owner": {
    "name": "your-name",
    "email": "your-email@example.com"
  },
  "plugins": [
    {
      "name": "recall",
      "description": "Recover conversation context when Claude loses track",
      "source": "./plugins/recall",
      "category": "productivity"
    }
  ]
}

claude plugin marketplace add /path/to/claude-recall-marketplace
claude plugin install recall@recall-local

Claude Code: Option 2 - Shell Alias (CLI Only)

This method works for the terminal but does not work with the VSCode extension.

git clone https://github.com/bledden/claude-recall-plugin.git

For Zsh (default on macOS):

echo "alias claude='claude --plugin-dir /path/to/claude-recall-plugin'" >> ~/.zshrc
source ~/.zshrc

For Bash:

echo "alias claude='claude --plugin-dir /path/to/claude-recall-plugin'" >> ~/.bashrc
source ~/.bashrc

Claude Code: Option 3 - Plugin Install Command (Not Recommended)

claude plugins install https://github.com/bledden/claude-recall-plugin

Warning: This method does not reliably persist in Claude Code 2.1.x. The plugin may disappear after restarting. Use Option 1 instead.

Migration from v1.0.1

Migration is automatic. On the first prompt after upgrading to v2.0.0, the hook migrates your existing index.json into SQLite and renames the file to index.json.migrated. No manual steps required.

Rollback: If you need to go back to v1.0.1, rename index.json.migrated to index.json. v1.0.1 ignores recall.db.

Quick Start

When Claude seems to have lost context, run:

/recall:recall

This will:

1. Show you a timestamped index of all exchanges in your session
2. Present a menu asking what you'd like to recall
3. Fetch and display the exchanges you select
4. Summarize where you left off

Full Command Reference

Core Commands