Goldentrii/AgentRecall-X

Correction-first persistent memory for AI agents. MCP server + SDK + CLI. Compounds across sessions.

What it solves

AgentRecall provides a persistent memory system for AI agents that specifically focuses on learning from human corrections. While most memory tools focus on retrieving information, AgentRecall tracks whether a correction actually changes the agent's behavior across different sessions, preventing the agent from repeating the same mistakes.

How it works

The system implements a governed corrections ledger and a measurement harness to track the lifecycle of a correction from capture to behavioral change. It organizes memory into five distinct layers: Episodic (session journals), Semantic (topic-clustered facts), Procedural (IF-THEN rules), Narrative (project phases), and Correction (behavioral calibration).

It integrates via an MCP server, SDK, or CLI, and uses a "session loop" (start, save, recall, reflect) to ensure memory is loaded and consolidated. For enhanced retrieval, it offers an optional 100% local ONNX embedding model for semantic search without cloud dependency.

Who it’s for

Developers using AI agents (specifically Claude Code, Cursor, Windsurf, and VS Code) who want their agents to remember specific preferences, project-specific rules, and corrections to avoid repetitive errors.

Highlights

  • Behavioral Measurement: Tracks "heed rates" and "phantom gradient steps" to quantify if an agent actually stops making a mistake after being corrected.
  • Five-Layer Memory Architecture: Maps cognitive psychology to a filesystem-based memory store (Episodic, Semantic, Procedural, Narrative, and Correction).
  • Local-First Privacy: Memory is stored as local markdown files, and optional semantic embeddings run locally via ONNX.
  • Autonomous Consolidation: An optional "Dreaming" mode that runs nightly to mine patterns, decay low-signal information, and promote repeated corrections to cross-project awareness.
  • War Room Dashboard: A local-first visual interface to manage and review the agent's learned memory.

Related

  • Project
  • Project
  • Project
  • Project
  • Project