raiyanyahya/recall

Stop wasting tokens and re-explaining your project every session. Recall gives Claude Code , Opencode durable memory — entirely offline.

What it solves

Recall provides a fully-local, automatic session memory for AI coding agents (specifically Claude Code and OpenCode), solving the "cold-start" problem where users must re-explain project context, goals, and progress to the AI in every new session. It reduces token usage and costs by replacing long transcripts with a compact, locally-generated summary.

How it works

Recall captures session activity (prompts, replies, files touched, and commands run) into an append-only history.md file. When a user saves the context, a local Python summarizer uses TF-IDF and TextRank algorithms to extract the most central sentences from the history to create a context.md file. This summary includes the project goal, files touched, and git diffs, which is then loaded into the next session to resume work.

Who it’s for

Developers using Claude Code or OpenCode who want to maintain persistent project memory without sending their session transcripts to an external API or incurring additional LLM costs for summarization.

Highlights

  • Fully Local: No API keys or external models; summarization is done via a classical Python algorithm.
  • Token Efficient: Resumes sessions from a compact digest (~1–2K tokens) rather than replaying full transcripts.
  • Privacy-First: Session transcripts and secrets are kept on the local machine with built-in redaction for sensitive data.
  • Harness Agnostic: While built for Claude Code, it uses plain markdown files, allowing it to be shared across different coding agents.
  • Zero Dependencies: The summarizer is vendored and runs on Python stdlib, with NumPy as an optional accelerator.

Related

  • Dispatch
  • Project
  • Project
  • Project
  • Project