agent-recall

Solid

Persistent compounding memory for AI agents. 10 MCP tools: session_start, remember, recall, session_end, check, digest, project_board, project_status, bootstrap_scan, bootstrap_import. Correction-first memory with decision trail tracking, watch_for warnings, palace rooms with salience scoring, cross-project insight matching, same-day journal merging, ambient recall hooks. Local markdown only. Zero cloud, zero telemetry, Obsidian-compatible. Optional Supabase backend: when configured via `ar setup supabase`, recall() uses pgvector cosine similarity on OpenAI/Voyage embeddings instead of keyword search — same API, semantic understanding. Gracefully degrades to local search if not configured.

AI & Automation 298 stars 52 forks Updated today MIT

Install

View on GitHub

Quality Score: 94/100

Stars 20%

Recency 20%

100

Frontmatter 20%

Documentation 15%

100

Issue Health 10%

License 10%

100

Description 5%

100

Skill Content

# AgentRecall v3.4.10 — Usage Guide AgentRecall is a persistent memory system with 10 MCP tools. This guide describes how and when to use them. ## Setup AgentRecall requires the MCP server to be running. If tool calls fail with "unknown tool", the human needs to install it first. ### Installation (human runs once) **Claude Code:** ```bash claude mcp add --scope user agent-recall -- npx -y agent-recall-mcp ``` **Cursor** (`.cursor/mcp.json`): ```json { "mcpServers": { "agent-recall": { "command": "npx", "args": ["-y", "agent-recall-mcp"] } } } ``` **VS Code / GitHub Copilot** (`.vscode/mcp.json`): ```json { "servers": { "agent-recall": { "command": "npx", "args": ["-y", "agent-recall-mcp"] } } } ``` **Windsurf** (`~/.codeium/windsurf/mcp_config.json`): ```json { "mcpServers": { "agent-recall": { "command": "npx", "args": ["-y", "agent-recall-mcp"] } } } ``` **Codex:** ```bash codex mcp add agent-recall -- npx -y agent-recall-mcp ``` **Hermes Agent** (`~/.hermes/config.yaml`): ```yaml mcp_servers: agent-recall: command: npx args: ["-y", "agent-recall-mcp"] ``` **Roo Code** (`.roo/mcp.json`): ```json { "mcpServers": { "agent-recall": { "command": "npx", "args": ["-y", "agent-recall-mcp"] } } } ``` **Any MCP-compatible agent:** ``` command: npx args: ["-y", "agent-recall-mcp"] transport: stdio ``` --- ## Tools AgentRecall provides these MCP tools: ### `session_start` **When:** Beginning of a session, to load prior context. **What it returns:** - `proje...