Skip to content
Skill

agent-recall

by Goldentrii

AI Summary

AgentRecall is a persistent memory system. Default surface: 5 tools (two verbs + three essentials). Full surface: 18 tools via . This guide describes how and when to use them. AgentRecall requires the MCP server to be running. If tool calls fail with "unknown tool", the human needs to install it fir

Install

Copy this and paste it into Claude Code, Cursor, or any AI assistant:

I want to install the "agent-recall" skill in my project.

Please run this command in my terminal:
# Install skill into your project
mkdir -p .claude/skills/AgentRecall-X && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/AgentRecall-X/SKILL.md "https://raw.githubusercontent.com/Goldentrii/AgentRecall-X/main/SKILL.md"

Then restart Claude Code (or reload the window in Cursor) so the skill is picked up.

Description

Persistent compounding memory for AI agents. 5 default MCP tools: session_start, session_end, remember, recall, check. Full surface (18 tools) available with --full flag. Two-verb model: inhale (session_start) and exhale (session_end). 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.

AgentRecall v3.4.30 — Usage Guide

AgentRecall is a persistent memory system. Default surface: 5 tools (two verbs + three essentials). Full surface: 18 tools via npx agent-recall-mcp --full. This guide describes how and when to use them. Two-verb model: session_start (inhale — load context) and session_end (exhale — save and compound). Everything else is available but secondary; most agents never need more than the default 5. See Automaticity Law below.

Tools

AgentRecall's default surface provides 5 tools. Start the server with --full to enable the complete 18-tool surface. Default tools (always available): session_start, session_end, remember, recall, check Full-mode only (--full): memory_query, check_action, register_rule, pipeline_open, pipeline_close, pipeline_list, pipeline_current, pipeline_show, skill_write, skill_recall, skill_list, dashboard_export, session_end_reflect, project_board, project_status, digest, bootstrap_scan, bootstrap_import ---

Setup

AgentRecall requires the MCP server to be running. If tool calls fail with "unknown tool", the human needs to install it first. > Visual setup guide (all 13 clients, copy-paste prompts): open warroom/install.html from the repo, or the GitHub raw link in a browser.

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 ` ---

Discussion

0/2000
Loading comments...

Health Signals

MaintenanceCommitted 7d ago
Active
Adoption100+ stars on GitHub
310 ★ · Growing
DocsREADME + description
Well-documented

GitHub Signals

Stars310
Forks52
Issues27
Updated7d ago
View on GitHub
MIT License

My Fox Den

Community Rating

Sign in to rate this booster

Works With

Claude Code
Claude.ai
Cursor
Windsurf
Copilot