Skip to content

Changelog

A better memory, release by release.
New features, improvements, and fixes for Recall MCP.

Latest release notes

Latest published update

NEW

v1.18.8

October 4, 2026

Recall's Row Is Back

A fix for 1.18.7

  • 1.18.7 was published without one of its files, so Recall's Claude Code mod did not load: no Recall row above the prompt. Failing commands were still recorded, with secrets redacted
  • Update with /plugin marketplace update recall-claude-plugin, then /plugin update recall
  • Every release is now checked as installed, before and after it is published

Earlier releases

Explore the changes that brought us here.

v1.18.7Failing commands recorded againOctober 4, 2026

v1.18.7

October 4, 2026

Failing Commands Recorded Again

When Recall's mod is not running

  • Claude Code reports a failing Bash command as PostToolUseFailure, not PostToolUse. observe.sh now listens there too, so a failing command is recorded when the mod is not running (older Claude Code, mods off, or a mod that failed to load)
  • An interrupted command (Esc) is not recorded
  • Standalone installs register the new hook on their next session start
  • Secrets in a failing command or its output (API keys and tokens, Authorization and Bearer values, passwords in URLs, token= and password= values and flags, private keys) become [REDACTED] before the memory leaves your machine. Commit SHAs stay
Link to this release
v1.18.6Update hint that worksOctober 4, 2026

v1.18.6

October 4, 2026

Update Hint That Works

Recall's row above the prompt

  • When a newer Recall is out, the row now says to refresh the marketplace first: /plugin marketplace update recall-claude-plugin, then /plugin update recall
  • Tip: turn on auto-update for recall-claude-plugin in /plugin → Marketplaces, and new versions arrive on their own
Link to this release
v1.18.5Band fits narrow windowsOctober 4, 2026

v1.18.5

October 4, 2026

Band Fits Narrow Windows

Recall's row above the prompt

  • In a narrow window a long warning in Recall's row no longer pushes the band's last row out of view
Link to this release
v1.18.4Band lines upOctober 4, 2026

v1.18.4

October 4, 2026

Band Lines Up

Recall's row above the prompt

  • Recall's workspace now starts at the same column as the values in other products' rows
  • One blank row above the band when it has room; in a short window the rows come first
Link to this release
v1.18.3Status line keeps upOctober 4, 2026

v1.18.3

October 4, 2026

Status Line Keeps Up

For status lines set up before the plugin

  • A status line set up before the plugin now updates with it, so it stops showing Recall where Recall already has its own line above the prompt
Link to this release
v1.18.2Two small fixesOctober 4, 2026

v1.18.2

October 4, 2026

Two Small Fixes

The status line and Recall's row above the prompt

  • The status line leaves Recall's segment out only when Claude Code really loads Recall's mod, so a curl install always keeps its segment
  • Recall's row above the prompt starts 2 cells in, lined up with the status line
Link to this release
v1.18.1Recall shows onceOctober 3, 2026

v1.18.1

October 3, 2026

Recall shows once. Where Recall draws its own line above the prompt, the status line no longer shows Recall as well.

One Place for Recall

From the first render of a session

In 1.18.0 the status line dropped its Recall segment only once the mod had started. The status line draws before that and does not redraw while Claude Code is idle, so a session could show Recall in both places. The status line now decides from what is installed.

  • Claude Code 2.1.287 or later, mods on, and the recall plugin at 1.18 or later: Recall shows only above the prompt
  • Older Claude Code, VS Code's chat panel, claude -p, or the curl install without the plugin: the status line segment works as before
  • Recall's line is one row: Recall in bold, the workspace, then dim detail. It no longer says "workspace not confirmed", and turns yellow only when something failed

The plugin and its scripts update by themselves. To get it at once:

claude plugin marketplace update recall-claude-plugin
claude plugin update recall@recall-claude-plugin
Link to this release
v1.18.0Recall as a Claude Code modOctober 3, 2026

v1.18.0

October 3, 2026

Recall as a Claude Code mod. On Claude Code 2.1.287 or later, the plugin runs inside Claude Code: its own line above the prompt, no script per tool call, and a lost workspace that fixes itself.

Recall's Own Line

Above the prompt, next to other plugins

Recall used to add a segment to your status line, wrapped around whatever status line you had. It now has a line of its own in the band above the prompt, and your status line is yours again.

🧠 Recall 1.18.0 · 2 stored · workspace confirmed · stored a memory (5s ago)
  • Version, memories stored this session, workspace, recent activity, and a notice when an update is out
  • Lines that other plugins draw above the prompt stay
  • Where mods do not draw (VS Code's chat panel, claude -p, older Claude Code), the status line segment works as before

No Script per Tool Call

Failing commands are recorded inside Claude Code

Recall remembers a shell command that failed, with its output. The plugin used to start a script for that after every shell command, about 290 ms and ten small programs each time. The mod does it inside Claude Code and sends what it found every 15 seconds, so the command's result reaches Claude at once.

A Lost Workspace Fixes Itself

Confirm and retry once, in code

When a session's workspace has expired, Recall refuses to store into it (WORKSPACE_NOT_CONFIRMED). Claude had to remember to confirm the workspace and try again. The mod now does it: it confirms the workspace and runs the call once more. It never loops.

Getting It

A plugin update, nothing else to install

The mod comes with the plugin, not with the background script update. Update the plugin, then restart Claude Code:

claude plugin marketplace update recall-claude-plugin
claude plugin update recall@recall-claude-plugin

Or in Claude Code: /plugin, Installed, recall, Update, then /reload-plugins. It needs Claude Code 2.1.287 or later (claude --version).

Link to this release
v1.17.3One workspace per projectSeptember 30, 2026

v1.17.3

September 30, 2026

One workspace per project. Memories stay with the project you started in, wherever the session wanders, and the Workspaces page helps you tidy up what the old behaviour scattered.

One Workspace per Project

No more workspaces for every subfolder

The hooks used the shell's current folder, which follows every cd. A session that stepped into a subfolder, a git worktree, a scratch folder or /tmp started a new workspace there, and memories saved there never showed up in the project. One account had 217 workspaces this way.

  • The workspace is the folder Claude Code was started in, for the whole session
  • Resolved to its git checkout: the repo root for a subfolder, the main checkout for a worktree
  • An explicit RECALL_WORKSPACE still wins

Workspaces, Organized

Grouped by folder, with a suggested cleanup

The Workspaces page now groups workspaces by the folder that holds them and suggests what to tidy: worktrees, scratch folders and subfolders to link into their project, and empty workspaces to delete. One click each, nothing without it.

  • Linking keeps a workspace's memories searchable from its project, and new ones go to the project
  • Linked workspaces don't count toward your workspace limit, and can be unlinked any time
  • Sibling projects under one folder are left alone

No Tokens in Git Remotes

Stripped before sending, and again before storing

A repository cloned over https with a token in its URL keeps that token in its remote. Recall used the remote to identify the workspace and sent it as it was. The hooks now remove the user and token first, and the server removes them again before storing or hashing, so older clients are covered and a rotated token keeps the same workspace.

Self-Hosted Listens Locally

A fresh install is reachable from this machine only

The installer used to publish Recall on every network interface, and Docker's published ports bypass host firewalls. A new install now listens on 127.0.0.1. Set RECALL_BIND=0.0.0.0 (behind a TLS reverse proxy) to reach it from other machines; a reinstall keeps the address it already had.

Link to this release
v1.17.0–1.17.2The memory infrastructure releaseAugust 30, 2026

v1.17.0 - v1.17.2

August 30, 2026

The memory infrastructure release: semantic search rebuilt around pipelined fetches and a vector cache, auto-memory hooks that store signal instead of noise, duplicate writes ended at three layers, and updates that actually apply however you restart Claude Code.

Search That Answers in Under a Second

Measured in production, not estimated

Memory fetches are now pipelined in batches instead of one round trip per record, and decrypted embedding vectors are cached in-process. Semantic searches that previously took tens of seconds on large workspaces now return in well under a second, with the relevance floor keeping unrelated results out.

  • Batched memory fetches across workspace, linked and global scopes
  • In-process vector cache (RECALL_VECTOR_CACHE_SIZE, default 10,000)
  • Same relevance floor: gibberish returns nothing, not noise

Hooks Store Signal, Not a Firehose

Your memory is for things worth remembering

Per-call capture of every file read, search and edit produced 99% of stored memories while being retrieved essentially never - and crowded real memories out of search results. The observe hook now stores only failing commands, with the error output attached so the memory is actually useful later.

  • observe.sh captures only failing Bash commands, with an output excerpt
  • One session summary per session (SessionEnd), no longer one per turn
  • Summaries no longer carry embeddings they never needed

Duplicates Ended, Guards Everywhere

Reliability fixes across the write path

  • Double-registered hooks no longer store every observation twice - registration is reconciled automatically, and a server-side guard collapses identical rapid writes into one record
  • The pinned-workspace write guard now applies to REST exactly as it does to MCP - a restored session cannot silently file memories under a guessed project
  • set_workspace on the workspace you already hold correctly lifts the write refusal after a session expires

Updates That Apply However You Restart

v1.17.1

Restarting into a resumed session never triggered the updater, so "Restart Claude Code to update" could nag forever. The update check now runs on resume as well, and the self-updater keeps every installed copy - including the one your status line reads - on the same version.

And in v1.17.2: sessions now stay writable for 4 hours of idle time instead of 30 minutes, and when a genuinely stale session does need re-confirming, agents recover silently with a re-confirm and retry instead of surfacing an error.

Technical Details

Performance

  • hgetallBatch on all storage adapters
  • Chunked pipeline fetches (500/batch)
  • Decrypted-vector LRU keyed by ciphertext
  • Duplicate stores skip embedding generation

Integrity

  • Tenant-scoped duplicate fingerprints
  • Workspace source enforced on every REST route
  • Hook behaviors covered by a CI test suite
  • E2E relevance-floor guard fixed and green
Link to this release
v1.16.0Self-teaching session protocolApril 8, 2026

v1.16.0

April 8, 2026

Six new features inspired by benchmarking research: self-teaching session protocol, pre-write deduplication, temporal validity on relationships, bulk conversation import, heuristic content classification, and a retrieval benchmark harness.

Self-Teaching Session Protocol

Every auto_session_start response now teaches Claude the workflow - no CLAUDE.md configuration required

Previously, getting Claude to use Recall correctly required adding rules to ~/.claude/rules/recall.md. Now the expected workflow is baked into theauto_session_start response itself - a ~130-token protocol string that travels with the tool call. New users get the correct behavior on first contact.

  • Call set_workspace FIRST (memories are workspace-isolated), then auto_session_start to load context
  • Search before claiming past work - never guess from memory alone
  • Store decisions, discoveries, patterns, errors proactively
  • Call summarize_session at the end of a session

Pre-Write Duplicate Check

New check_duplicate tool prevents noise from prolific auto-save patterns

Returns similar memories above a threshold (default 0.85) so Claude can skip, merge, or explicitly override instead of writing yet another duplicate. Especially useful before bulk imports or when stop hooks fire on every interaction.

Just tell Claude:

"Check if we already have this stored before saving"

Temporal Validity on Relationships

Facts can end without being deleted - historical queries still work

The memory_graph tool now supports temporal validity via three additions:

valid_from / valid_to

Links now have optional validity windows. Empty valid_to means still active.

invalidate action

Mark a relationship as ended without deleting it. Preserves history.

as_of parameter

Point-in-time queries: 'What was Kai working on in January 2026?'

Just tell Claude:

"Kai stopped working on Orion as of March 1st"

Bulk Conversation Import

Backfill Claude Code, ChatGPT, and generic transcripts into Recall

The new import_conversations tool parses three formats and chunks by exchange pair (user turn + AI response = one memory). Each chunk is auto-classified and stored verbatim - no summarization.

claude_code

JSONL files from ~/.claude/projects/

chatgpt

OpenAI conversation export JSON

generic

Blockquote or Human:/Assistant: labeled text

Supports dry_run mode to preview what would be imported without writing. Six months of conversation history? Import it in one call.

Zero-LLM Content Classifier

Regex-based auto-classification for imported content

Powers the conversation importer. Classifies content into Recall's ContextType enum (decision, preference, directive, error, insight, code_pattern, todo, requirement) using regex marker sets. Zero LLM calls, zero API cost. Also suggests importance (1-10) from keyword signals like "critical", "breaking", "security", "minor", "typo".

LongMemEval Benchmark Harness

Standardized retrieval quality measurement

New benchmarks/ directory with a runner that measures R@1, R@5, and R@10 on the LongMemEval dataset. Ships with a synthetic 15-question dataset for quick validation. Accepts the full LongMemEval corpus via --dataset path/to/longmemeval.json.

Link to this release
v1.15.xAlways-on memory directivesMarch 5 – April 7, 2026

v1.15.x

March 5 - April 7, 2026

The v1.15 series landed always-on memory directives, billing enforcement, memory add-on packs, the pick_up tool, and a long tail of reliability fixes across hooks, API key healing, and version propagation.

Always-On Memory Directives

v1.15.0 - rules file injected into every session automatically

Recall now ships a recall.md rules file that injects directly into ~/.claude/rules/ on every session start. No CLAUDE.md edits, no manual configuration - Claude just knows to call set_workspace and auto_session_start at the start, store decisions mid-session, and call summarize_session on exit.

pick_up Tool

v1.15.18 - structured work resumption brief

New tool for returning to a project after time away. Returns a narrative brief with:

  • Last session summary
  • Active workflows in progress
  • Pending todos with priority
  • Recent decisions and their reasoning
  • Error signals from unfinished work

When to use vs auto_session_start:

auto_session_start for every session (fast, ~2000 tokens). pick_up when returning after hours or days, switching projects, or when explicitly asked "catch me up" (~3000 tokens).

Memory Limit Enforcement

v1.15.18 - clear upgrade messages instead of silent failure

store_memory, analyze_and_remember, and quick_store_decision now block with a helpful upgrade message when you hit your plan's memory limit. Previously the store would silently fail or truncate - now you know exactly when and why to upgrade.

Memory Add-On Packs

v1.15.18 - top up without upgrading your plan

Need more memories without changing plans? Purchase add-on packs directly from your dashboard at $4.99 per 5,000 memories (one-time, no subscription). Admins can grant and adjust add-ons per user.

Reliability & Infrastructure

Hooks, version propagation, and API key self-healing

  • Self-healing API keys (v1.15.14-16) - session-start now detects 401 errors, finds active keys from ~/.claude.json, and updates config silently
  • Hook self-registration (v1.15.8-9) - all hooks (PreCompact, Stop, SessionStart) now register themselves in settings.json to avoid unreliable CLAUDE_PLUGIN_ROOT resolution
  • Fast update propagation (v1.15.5) - update checks run on every session start instead of once per 24h, so new releases are picked up immediately
  • Self-hosted version checker (v1.15.18) - now queries the GHCR Docker registry instead of stale GitHub releases, so self-hosted instances see new versions the moment they ship
  • Dashboard key stability (v1.15.11) - Revoke and Regenerate API key buttons now work correctly with Firebase auth; dashboard no longer silently rotates keys on every fresh browser session
Link to this release
v1.14.0Automatic session summariesMarch 2, 2026

v1.14.0

March 2, 2026

Session continuity. Recall now persists work across session stops and context compactions automatically, so nothing is lost between conversations.

Automatic Session Summaries

Async Stop hook snapshots your work when a session ends

The new stop-summarize.sh hook fires when Claude Code stops and stores a summary memory at importance 7. It tracks which files were touched, what decisions were made, and where the session ended - so your next session picks up where this one left off.

  • Runs asynchronously - no delay on session exit
  • Skips zero-memory sessions (nothing to summarize)
  • Importance 7 by default so it surfaces in auto_session_start
  • Includes session name, project path, and memory count

Context Compaction Recovery

State re-injected after context window shrinks

When Claude Code compacts its context window mid-session, the new compact-restore.sh hook fires on SessionStart(compact) and re-injects the pre-compaction state snapshot (session name, project, CWD, memory count). Compactions used to wipe context - now they preserve it.

Richer Activity Observation

File edits and command failures now captured automatically

The observe hook now captures a wider signal:

  • Write/Edit/MultiEdit file paths at importance 2
  • Bash command failures detected and stored at importance 6 with an error tag
  • Variable importance levels tuned per tool type
Link to this release
v1.13.0Persistent to-do lists & Claude Code pluginFebruary 25, 2026

v1.13.0

February 25, 2026

Persistent To-Do Lists

Track tasks across sessions with automatic context injection

Recall now includes a built-in to-do list that persists across sessions and integrates directly into your workflow. Claude can create, track, defer, and complete tasks — and pending to-dos are automatically injected into every session start so nothing falls through the cracks.

Persists across sessions

To-dos are stored in Redis alongside your memories. They survive session restarts and context compaction.

Auto-injected at session start

Pending to-dos appear in auto_session_start context with priority indicators, so Claude always knows what's outstanding.

Priority & defer tracking

Four priority levels (low, medium, high, urgent) and defer counting to identify repeatedly postponed items.

Token-budget aware

Context injection is hard-capped at 300 tokens. To-dos are formatted compactly to minimize per-session cost.

Single tool, 8 actions

The todo_list tool uses action dispatch (like workflow) to keep the tool count minimal:

createCreate a new to-do with title, priority, and tags
listList all to-dos, optionally filtered by status
getGet details of a specific to-do
updateUpdate title, priority, status, or tags
completeMark a to-do as completed
deferDefer a to-do (tracks defer count)
deleteRemove a to-do permanently
contextGet a token-budgeted summary of pending to-dos

Just tell Claude:

"Create a to-do to refactor the auth middleware — high priority"

Claude Code Plugin

Zero-config installation via the official plugin directory

Recall is now available as an official Claude Code plugin. Instead of manually editing .mcp.json and configuring skills, you can install with a single command and get everything pre-configured.

  • Zero-config MCP connection — just set RECALL_API_KEY and install
  • Built-in memory lifecycle skill — Claude learns session patterns automatically
  • /recall:setup command for first-time configuration and verification
  • Compatible with existing .mcp.json setups (plugin takes precedence)

Install

/install recall

Reduced Token Overhead

~200-300 fewer tokens per session start

Tool definitions have been streamlined to reduce per-session token cost. Redundant property descriptions were removed from self-documenting fields, and Claude Code's Tool Search (lazy-loading) is now enabled so tools are loaded on-demand instead of all at once.

Before

~1,200

tokens per ListTools

After

~900

tokens per ListTools

Link to this release
v1.12.0Self-hosted deploymentFebruary 23, 2026

v1.12.0

February 23, 2026

Self-Hosted Deployment

Run Recall on your own infrastructure with a single command

Recall is now available as a self-hosted Docker image. Teams with strict data residency requirements, air-gapped environments, or simply a preference for running their own stack can deploy a fully-featured Recall instance in under two minutes.

Unlimited everything

No memory caps, no workspace limits, no webhook quotas. Your server, your rules.

License-key activation

Activate with a license key from recallmcp.com. Works air-gapped with a 7-day grace window for offline environments.

Full data sovereignty

Memories never leave your infrastructure. No telemetry, no cloud dependency — just Redis + Recall running inside Docker.

One-command Docker install

curl -fsSL https://install.recallmcp.com | bash detects Docker, pulls the image, configures Redis, and prints your MCP config.

Install

curl -fsSL https://install.recallmcp.com | bash

Pro Free Trial

7 days of Pro, no card required

New accounts can now activate a 7-day Pro trial from the billing dashboard — no payment method required. Trial accounts get the full Pro feature set: 5,000 memories, 3 workspaces, cross-session workflows, webhooks, and event history.

  • Activate from Dashboard → Billing with one click
  • Full Pro features for 7 days
  • Automatically reverts to Free at trial end
  • No credit card needed to start

Updated Pricing

Simpler tiers, lower entry price

Pro dropped from $9.99 to $5/mo, and Team dropped from $19.99 to $15/mo. Existing subscribers are grandfathered on their current rate — no action needed.

Free

$0/mo

500 memories

Pro

$5/mo

5,000 memories

Team

$15/mo

25,000 memories

Link to this release
v1.11.0Outgoing webhooksFebruary 21, 2026

v1.11.0

February 21, 2026

Outgoing Webhooks

Push memory events to any HTTP endpoint in real time

Recall can now call your own HTTP endpoint whenever a memory is created, updated, deleted, or when a session summary is written. Webhooks unlock integrations that were previously impossible — trigger CI runs, sync to Notion, fire Slack alerts, or feed a second AI agent whenever context changes.

HMAC signature verification

Every webhook request is signed with your secret. Verify the X-Recall-Signature header on your server to reject spoofed calls.

Event filtering

Subscribe only to the event types you care about. Pro gets 25 filters; Team gets 100. Filter by workspace, memory type, or action.

Event history & replay

Every fired event is stored for 30 days. Replay missed events after downtime or roll back a bad deploy by replaying the event stream.

Session-targeted routing

Route webhook payloads directly into a running Claude Code session using the stop hook. Claude processes the event as a task — no polling needed.

New REST endpoints

  • POST /api/webhooks
  • GET /api/webhooks
  • DELETE /api/webhooks/:id
  • GET /api/webhooks/:id/events
  • POST /api/webhooks/:id/replay
  • POST /api/events (queue tasks for Claude sessions)
Link to this release
v1.10.0Auto-memory hooks for Claude CodeFebruary 19, 2026

v1.10.0

February 19, 2026

Auto-Memory Hooks for Claude Code

Zero-effort memory capture with installable Claude Code hooks

Until now, Recall required Claude to proactively call memory tools — meaning it only captured what you explicitly asked it to remember. Auto-Memory Hooks change this: install four lightweight bash scripts once and Recall captures context automatically on every session start, file edit, and key command.

Install in one command

curl -fsSL https://recallmcp.com/install-hooks | bash

Installs hooks to ~/.claude/recall/hooks/ and patches your Claude Code settings.json automatically. Backs up your settings first. Idempotent — safe to re-run.

What the hooks do

session-start.sh

SessionStart

Fetches your recent memories and injects them as context at the start of every Claude Code session.

observe.sh

PostToolUse

Silently captures Write, Edit, Task, and key Bash events (git commit, npm install, deploy) as low-importance observations.

pre-compact.sh

PreCompact

Saves a state marker before context compaction so session continuity is preserved.

session-end.sh

Stop

Records a session-end marker when Claude Code closes.

Design principles

  • Silent failures — Every hook exits 0 regardless of errors. A missing API key, unreachable server, or timeout never blocks Claude.
  • Non-blocking — Observe and session-end hooks run async: true. Claude never waits for them.
  • Preserves existing hooks — The installer merges into your settings.json hooks array without overwriting Pilot, sx, or other tools.
  • No daemon required — Pure bash + curl. No background processes, no npm packages, no Node.js requirements beyond what Claude Code already uses.

New REST endpoint

A new GET /api/context endpoint returns your recent memories as a formatted markdown block — grouped by type (decisions, errors, patterns, recent work) and ready for direct stdout injection into Claude's session context.

Link to this release
v1.9.0Workflow threads & auto-consolidationFebruary 17, 2026

v1.9.0

February 17, 2026

Cross-Session Workflow Threads

Named workflows that span multiple Claude sessions

The #1 pain point with AI assistants is context loss across sessions. Workflow threads solve this by creating named workflows that automatically link memories across multiple sessions, giving Claude persistent context about what you're working on.

How to Use with Claude Code

Step 1: Start a workflow at the beginning of a multi-session task

start_workflow({ name: "Implementing auth system", description: "Adding OAuth 2.0 with refresh tokens" })

Step 2: Work normally — memories are auto-tagged

store_memory({ content: "Decided to use PKCE flow for public clients", context_type: "decision" })

Memories created during an active workflow are automatically linked to it. No extra steps needed.

Step 3: In a new session, context is automatic

auto_session_start({ task_hint: "Continue auth implementation" })

Active workflow context (name, description, recent memories) is included automatically.

Step 4: Pause and resume workflows

pause_workflow() // Pauses the current workflow resume_workflow({ workflow_id: "..." }) // Resume later

Step 5: Complete the workflow when done

complete_workflow({ summary: "Auth system implemented with OAuth 2.0 PKCE" })

New MCP Tools

start_workflow

Start a named multi-session workflow

complete_workflow

Complete with summary

pause_workflow

Pause without losing progress

resume_workflow

Resume a paused workflow

get_active_workflow

Check current active workflow

list_workflows

List all workflows by status

get_workflow_context

Get linked memories for a workflow

Claude Code Prompt Tip

Tell Claude: “Start a workflow called '[your task]' so we can track context across sessions.” Claude will call start_workflow automatically. Only one workflow can be active at a time — pause or complete the current one before starting another.

Auto-Consolidation Pipeline

Automatically merge similar memories to keep your store efficient

As your memory store grows, similar and overlapping memories accumulate. The auto-consolidation pipeline clusters similar memories using cosine similarity, creates consolidated summaries, and keeps originals as version history via supersedes relationships.

How to Use with Claude Code

Check if consolidation is needed

consolidation_status()

Returns memory count, threshold, last run date, and recommendation.

Run automatic consolidation (safe to call proactively)

auto_consolidate()

Checks memory count threshold and 24h cooldown. Returns early if not needed — safe to call at any time.

Force consolidation (after large imports or manual trigger)

force_consolidate({ similarity_threshold: 0.8, min_cluster_size: 3 })

Runs regardless of thresholds. Configurable similarity (default 0.75), minimum cluster size (default 2), and max memories to process (default 1000).

New MCP Tools

auto_consolidate

Smart consolidation — only runs when needed

force_consolidate

Manual trigger with custom thresholds

consolidation_status

Check status and get recommendations

Embedding Provider Note

Consolidation quality depends on your embedding provider. For best results, use Voyage AI, Cohere, or OpenAI embeddings. The Anthropic keyword-based fallback works but may require lowering the similarity threshold to 0.6. Run consolidation_status() to see your current provider.

How It Works

Fetches recent memories (capped at 1,000 for performance)

Clusters by cosine similarity with cross-scope guard (global memories only cluster with global)

Creates consolidated summary combining content from all cluster members

Preserves originals with 'consolidated' tag and supersedes relationships

Takes max importance and merges tags from all cluster members

24-hour cooldown prevents redundant runs

Technical Details

Architecture

  • WorkflowStore — extracted composition class
  • WorkflowService — business logic layer
  • ConsolidationService — clustering + merge
  • Atomic SET NX for concurrent safety

Compatibility

  • Both stdio and HTTP transports
  • Redis and Valkey backends
  • Full workspace isolation
  • 261 tests, zero regressions
Link to this release
v1.8.0–1.8.2Automatic hooks & RLM toolsJanuary – February 2026

v1.8.2

February 2026

Added clearWorkspace() method to MemoryStore

Fixed MCP SDK 1.25.x architecture for stale sessions

Gracefully handle missing Firebase API key

v1.8.0

January 2026

Automatic hooks — auto_session_start, quick_store_decision, should_use_rlm

RLM (Recursive Language Model) tools for handling large contexts exceeding context window limits

7 AI Embedding Providers — Voyage AI, Cohere, OpenAI, Deepseek, Grok, Anthropic, Ollama

Link to this release

Your next session starts with context.

Put Recall to work in the tools you already use.

Get started free