Recall is a memory tool for your project.

It helps you and your AI assistant remember important work across sessions.

• Saves short notes about decisions and progress
• Creates summaries automatically
• Stores project docs in .recall/
• Gives one command (recall context) to load a quick project snapshot
• Works with MCP (recall mcp) for tool-based agents

git clone https://github.com/roostermade/recall.git
cd recall
go build -o recall ./cmd/recall

go install github.com/roostermade/recall/cmd/recall@latest

From your project folder:

recall init

Then use it:

recall context
recall note add "Built export command and tested it"
recall note list

• recall init - Set up Recall in this project
• recall context - Show project snapshot (context + recent summaries + docs list)
• recall status - Show counts (notes, summaries, docs)
• recall doctor - Check if everything is set up correctly

• recall note add "<text>" (or pipe text via stdin)
• recall note list [--limit <n>]
• recall note get <id>
• recall note delete <id>
• recall note search <query> [--limit <n>]

• recall summary add (generate summary for unsummarized notes)
• recall summary list [--limit <n>]
• recall summary get <id>
• recall summary search <query> [--limit <n>]

Search uses SQLite FTS5 ranking when available and automatically falls back to substring matching otherwise.

• recall doc add <name>
• recall doc edit <name>
• recall doc list
• recall doc get <name>

Note: new docs created by Recall start with a Summary: line.

• recall config - Interactive editor
• recall config get <key>
• recall config set <key> <value>

Writable keys:

• project_name
• summary_threshold
• summarizer_cmd

Read-only keys:

• docs
• initialized

Useful env vars:

• RECALL_SUMMARIZER_CMD (override summarizer command)
• RECALL_SUMMARIZER_TIMEOUT (example: 90s, 2m)

• recall export (creates a zip in .recall/exports/)
• recall import <zipfile>

• --summary-limit <n> how many recent summaries to show
• --summary-full show full summary text
• --query <text> add matching notes and summaries
• --query-note-limit <n>
• --query-summary-limit <n>
• --include-doc-index=false hide docs list
• --max-chars <n> limit output size
• --full print everything

Examples:

recall context
recall context --query "auth"
recall context --summary-full

Run MCP server:

recall mcp

If you use Claude Code:

claude mcp add recall -- /absolute/path/to/recall mcp
claude mcp list

MCP tools:

• note_add, note_list, note_get, note_delete, note_search
• summary_add, summary_list, summary_search
• context_get, context_snapshot
• doc_get, doc_list

context_snapshot params:

• summary_limit, summary_full, max_chars, include_doc_index
• query, query_note_limit, query_summary_limit

Recall is not initialized in this project.

Run:

recall init

go test ./...
go build -o recall ./cmd/recall