✦ open source · MIT · Python 3.8+

Your AI coding tool
should remember things.

recall gives Claude Code, Codex, and Claude Desktop a persistent session memory — so you never have to re-explain your project from scratch.

Get recall on GitHub
$ ./install.sh

Platforms

Works wherever you code with AI.

Same install, same commands — whether you're in Claude Code, Codex, or Claude Desktop.

🤖
Claude Code
Full hook integration. recall loads context automatically at session start — no extra steps needed.
# loads on every session start
✓ Last session: payroll-fix (2h ago)
✓ 3 learnings loaded from index

$ /recall save
✓ Saved → restarts/payroll-fix.prompt
$ /recall restart 1
✓ Continuing from where you left off.
  • SessionStart hook loads prior context
  • /recall save distills before hitting the limit
  • /recall restart picks up mid-thought
⚡
Codex
AGENTS.md integration. Your recall index is surfaced to Codex on every task — zero extra config.
# AGENTS.md auto-surfaced to Codex
Reading recall index...
✓ 4 relevant sessions found

$ codex "fix the auth bug"
→ context: JWT expiry (session 3)
# already knows what you tried
  • AGENTS.md surfaces your session index
  • Relevant sessions matched per task
  • Same index file — no duplicate config
🖥
Claude Desktop
MCP filesystem bridge. Point Claude Desktop at your recall index and search session history just by asking.
# claude_desktop_config.json
"filesystem": {
"path": "~/.claude/projects"
}

you: what did I decide about auth last week?
→ Found it — session 2026-03-15
  • Filesystem MCP reads your recall index
  • Search session history in plain English
  • One index across all your tools

The core loop

Save. Distill. Resume.

When a session gets long, run one command. Open fresh, carry everything forward.

1
Save
Run /recall save — it captures messages, commands, and decisions, then distills everything into a clean briefing file.
2
Distill
Noise stripped. Conclusions kept. The file holds what-was-decided and where-you-left-off — not the full conversation transcript.
3
Resume
Open a new session, run /recall restart 1, and your AI picks up exactly mid-thought — branch state, open questions, next step.

Install

Five minutes. Pick what you need.

Each piece installs independently. Start minimal, add more when you want it.

$ git clone https://github.com/ashrocket/recall-skill
$ cd recall-skill && ./install.sh
 
# or pick only what you want
$ ./install.sh --recall # session memory
$ ./install.sh --recall --history # memory + history
$ ./install.sh --minimal # zero hooks, just /history

Requires Python 3.8+  ·  MIT licensed  ·  View on GitHub →