← Back to directory
A

Agent Recall

Community
Correction-first agent memory: the only open-source system that measures whether your agent actually stops repeating mistakes.
GitHub source repository ↗
★ 370 Stars Category · Other Very popular Source revision b95b1eb9b824
57FMRS · C
Reliability
8/20
Security and permissions
10/20
Maintenance
12/20
Documentation
13/20
Setup experience
14/20

AgentRecall offers a unique correction-first memory approach and an honest measurement framework, but its current self-reported numbers are low (e.g., capture recall 35.3%, transfer recall 0/4), indicating that its utility is still being validated. Suitable for Claude Code users who value auditability and local control, provided they actively follow the session loop.

Read the FMRS scoring method →

AgentRecall is a correction-first agent memory system that provides an MCP server, SDK, and CLI. It records every correction you make to your agent as a structured entry with severity, evidence, and outcome tracking, persisting across sessions, projects, and restarts. Its distinctive corrections ledger and measurement harness track whether a correction actually changes agent behavior in later sessions—not just retrieval. All memory is stored locally in Markdown files by default, with an optional Supabase mirror for vector semantic search.

Tools

session_start
Call at the start of a session to load context.
session_end
Call at the end of a session to compound what you learned.
remember
Call when the human corrects you, with type "correction".
recall
Search past knowledge.
memory_query
Query memory on demand.

Setup

  1. Install the MCP server: run claude mcp add --scope user agent-recall -- npx -y agent-recall-mcp in Claude Code. For other clients, use the JSON configuration. 2. In the first message of every new session, run the loop: call session_start to load context, call remember with type "correction" when corrected, and session_end at session end. 3. Optionally install the SDK (npm install agent-recall-sdk) or CLI (npx agent-recall-cli).
claude_desktop_config.json
{
  "mcpServers": {
    "agent-recall": {
      "command": "npx",
      "args": [
        "-y",
        "agent-recall-mcp"
      ]
    }
  }
}

Fit and risk

Best for

  • Claude Code users who want their agent to stop repeating mistakes
  • Developers who want honest measurement of memory effectiveness
  • Privacy-conscious users requiring local storage
  • Teams adopting structured memory layers (episodic, semantic, procedural, etc.)

Not for

  • Scenarios requiring real-time or high-throughput memory retrieval
  • Users wanting fully automatic memory management without manual session loop
  • Projects needing cloud sync or multi-user collaboration
  • Users requiring advanced retrieval performance like BM25 indexing

Required permissions

  • Read and write local filesystem (default path ~/.agent-recall/)
  • Execute local commands (e.g., CLI tools)
  • Optional: OpenAI API usage if OPENAI_API_KEY is set for vector search
  • Optional: Supabase mirror for remote sync

Risks and side effects

  • Memory content may contain sensitive information; ensure access control despite local storage
  • The measurement instrument may produce misleading data (e.g., defaulted to "heeded" bias); interpret cautiously
  • The automatic session loop requires user compliance with session start/end protocols; otherwise memory may be incomplete
  • Experimental components (e.g., dream consolidation, recurrence harness) may be unstable
  • Dependency on npm package execution poses supply-chain risk (verify source)

Troubleshooting

  1. If the MCP server fails to start, check Node.js version and npm connectivity.
  2. If memories are not persisted, ensure you follow the /arstart and /arsave session loop.
  3. If retrieval results are poor, verify that local memory files exist under ~/.agent-recall/projects/<slug>/.
  4. If you encounter login expiration, run `claude login` to restore automatic features like dreaming.
  5. Consult the official docs/ and UPDATE-LOG.md for further debugging.

Use cases

AI-assisted coding with persistent memory across sessions
Tracking whether corrections actually change agent behavior
Local-first memory with no cloud dependency
Managing multiple projects with per-project slugs

Supported clients

Claude DesktopFull support
CursorPartial support
WindsurfPartial support
VS CodePartial support
CodexPartial support