What is recall CLAUDE.md?

Repository instructions for recall, a terminal application that searches and resumes past conversations from several coding-agent tools. It describes the product’s design principles, Rust commands, and terminal user-interface testing workflow.

Use them when building, testing, linting, or end-to-end testing recall, especially its search, indexing, and terminal interface.

They provide the project’s development rules and explain when the local search index must be cleared after parser changes.

How zippoxer/recall configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to zippoxer/recall. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/zippoxer/recall/main/CLAUDE.md

Clone the repo

git clone --depth 1 https://github.com/zippoxer/recall

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/zippoxer/recall/claude-md/github.svg)](https://agentmods.dev/instructions/zippoxer/recall/claude-md)

Your own site

<a href="https://agentmods.dev/instructions/zippoxer/recall/claude-md"><img src="https://agentmods.dev/badge/instructions/zippoxer/recall/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/zippoxer/recall/claude-md"><img src="https://agentmods.dev/badge/instructions/zippoxer/recall/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 659 This file is loaded in full into every session.

When invoked 659 The same file — it is already loaded in full.

Security scan C 1 finding. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00659	$0.00659
Opus 5.5	$0.00264	$0.00264
Sonnet 5.5	$0.00132	$0.00132
Haiku 4.5	$0.00066	$0.00066

Measured 2mo ago against content hash 76dcd7892e4c, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade C, and why

recall CLAUDE.md scanned grade C with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Recursive force deletehighDestructive command

rm -rf with a variable or a broad path is one typo away from removing the wrong tree.

rm -rf ~/Library/Caches/recall # macOS

CLAUDE.md · 63 lines

How it starts

The opening of the file, as written. The whole thing — 63 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CLAUDE.md

Purpose

Search and resume past conversations from Claude Code, Codex CLI, and Factory (Droid).

Principles

Delightful - Made with love, feels good to use
Simple, uncluttered, focused - Two panes, keyboard-driven, no chrome
Responsive - Instant startup via background indexing, sub-100ms search
Match-recency matters - Rank by most recent message containing the match (human memory anchors to recent context)
Seamless resume - Enter execs directly into the CLI, no intermediate steps

Development

cargo check          # Fast compile check (no binary)
cargo run            # Build debug + run
cargo test           # Run tests
cargo clippy         # Lint

To test the TUI end-to-end, use tmux:

# Clear index cache if testing parser changes
# macOS: ~/Library/Caches/recall, Linux: ~/.cache/recall
rm -rf ~/Library/Caches/recall        # macOS
rm -rf ~/.cache/recall                # Linux
cargo build && tmux new-session -d -s test './target/debug/recall'
tmux send-keys -t test 'search query'
tmux capture-pane -t test -p          # See output
tmux kill-session -t test             # Cleanup

Install

cargo install --path .

Architecture

Rust TUI for searching Claude Code, Codex CLI, and Factory conversation history.

src/main.rs - Entry point, event loop, exec into CLI on resume
src/app.rs - Application state, search logic, background indexing thread
src/ui.rs - Two-pane ratatui rendering, match highlighting
src/tui.rs - Terminal setup/teardown
src/theme.rs - Light/dark theme with auto-detection
src/session.rs - Core types: Session, Message, SearchResult
src/parser/ - JSONL parsers for Claude (~/.claude/projects/), Codex (~/.codex/sessions/), and Factory (~/.factory/sessions/)
src/index/ - Tantivy full-text search index, stored in ~/Library/Caches/recall/ (macOS) or ~/.cache/recall/ (Linux)

Key Patterns

Background indexing: spawns thread on startup, indexes most recent files first, sends progress via mpsc channel
Unicode-safe string handling: use char indices not byte indices when slicing (see highlight_matches, create_snippet)
Search ranking: combines BM25 relevance with recency boost (exponential decay, 7-day half-life)
Theme detection: queries terminal bg color via crossterm, falls back to COLORFGBG env var
Event handling: drains all pending events each frame to prevent mouse event flooding
Contextual status bar: hints adapt to state (e.g., scroll hint only when preview is scrollable)

Read the full file on GitHub · 63 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

2mo ago First seen · 63 lines · 659 tokens per session scan C 76dcd7892e4c

Subscribe to this mod's changes

recall CLAUDE.md is an instructions file published in the GitHub repository zippoxer/recall (198 stars, last pushed 9mo ago), licensed MIT. It adds 659 tokens to every session, about $0.0026 per session on Opus 5.5. A static security scan graded it C with 1 finding (recursive force delete). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

claude claude-ai claudecode codex codex-cli openai-codex

recall CLAUDE.md next to 6 instructions from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
recall CLAUDE.mdzippoxer/recall	Instructions file	198	9mo ago	MIT	C	659	Claude Code
vscode buildNext.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	9,719	GitHub Copilot
next.js AGENTS.mdvercel/next.js	Instructions file	143k	yesterday	MIT	A	7,461	Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchain	Instructions file	149k	yesterday	MIT	A	4,680	Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	5,516	GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	3,093	GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness	Instructions file	274k	2d ago	MIT	A	4,313	Codex, OpenCode

recall: Instructions file for Claude Code