Start here
Claude Code plugin
Install Recall for Claude Code, configure your API key, and manage plugin updates.
In this guide
#Recall Plugin for Claude Code
The recommended way to install Recall — everything in one package
The Recall plugin bundles everything you need into a single install: the MCP server connection, auto-memory hooks, RLM agents, slash commands, and a setup wizard. No manual config files to edit.
MCP Server
Pre-configured connection to recallmcp.com and its memory tools
Auto-Memory Hooks
Context loading, Bash failure capture, and session summaries built in
RLM Agents
Context loader, result aggregator, and task decomposer for large files
Slash Commands
/recall:setup, /decompose, /load-context, /rlm-status
Status Line
Shows memory count and version info in Claude Code's status bar
Auto-Updates
Plugin updates automatically when you restart Claude Code
Installation
Install the marketplace, configure your key, and restart Claude Code
1Add the Recall marketplace
/plugin marketplace add joseairosa/recall-claude-pluginThis registers the Recall marketplace as a plugin source in Claude Code.
2Install the Recall plugin
/plugin install recall@recall-claude-pluginThis installs the Recall plugin with MCP server, hooks, agents, and commands.
3Run /recall:setup to configure your API key
In Claude Code, run /recall:setup and provide your API key when prompted. This writes your key to ~/.claude/recall/config.json (for lifecycle hooks) and ~/.claude/settings.json (for the plugin MCP server).
Get your API key from the API Keys page in your Recall dashboard. The setup command configures both auth paths automatically.
4Restart Claude Code
The plugin and API key are loaded at launch. Restart once after install and after any key rotation.
Done! After restarting, Recall will automatically load your previous context at every session start and begin capturing memories.
What the Plugin Does
How each component works together
Auto-Memory Hooks
Hooks fire at key moments in Claude Code's lifecycle — no prompting required:
SessionStart
Loads recent memories, decisions, and active workflows into context
PostToolUse
Captures detected Bash failures with an output excerpt
PreCompact
Saves state before context compaction so nothing is lost
SessionEnd
Stores a session activity summary when memories were recorded
Slash Commands
/recall:setupGuided wizard to configure your API key and verify connection/recall-updateManually trigger a Recall update, or toggle auto-update on/off/decomposeBreak down large files or tasks using RLM processing/load-contextLoad content into RLM memory for chunk-based processing/rlm-statusCheck status of active RLM execution chainsMCP Tools
The plugin connects to recallmcp.com's MCP server, giving Claude access to all memory tools:
Managing Auto-Updates
How updates work and how to control them
Recall checks for updates once per day at session start and applies them in the background — no interruption to your workflow. You'll see a banner when an update is detected, and the new version takes effect after a Claude Code restart.
Disabling auto-updates
Two ways to opt out — the env var takes precedence over the config file:
Option A — environment variable (recommended for teams and CI)
Add to your shell profile (~/.zshrc or ~/.bashrc):
export RECALL_AUTO_UPDATE=falseOption B — config file (per-machine preference)
Add "auto_update": false to ~/.claude/recall/config.json:
{
"api_key": "sk-...",
"auto_update": false
}Or ask Claude to do it: just say "disable Recall auto-update" and run /recall-update.
Manual update
When auto-update is off, Recall still notifies you about new versions at session start. To update on demand:
/recall-updateAsk Claude to run the update — works for both plugin and curl|bash installs/plugin install recallRe-installs the plugin at the latest version (plugin installs only)false to disable, or remove it to re-enable auto-updates.Plugin vs Manual Setup
When to use the plugin vs configuring MCP manually
| Feature | Plugin | Manual MCP |
|---|---|---|
| MCP tools | ||
| Auto-memory hooks | — | |
| Slash commands | — | |
| RLM agents | — | |
| Status line integration | — | |
| Auto-updates | — | |
| Setup wizard | — | |
| Works with Claude Desktop | — | |
| Works with other MCP clients | — |
Use the plugin if you're on Claude Code — it gives you everything with zero config. Use manual MCP config if you're on Claude Desktop, Cursor, or another MCP-compatible client that doesn't support plugins.
Plans & Pricing
The plugin works on all plans including Free
Choose a plan for your memory, workspace, and webhook needs. The pricing page lists current allowances and billing options.