Recall

Your agent forgets between sessions. Recall fixes that.

Three modes: temporal (date-based), topic (semantic search), graph (visual map). Every recall ends with One Thing — a concrete, specific next action synthesized from what you find.

Modes

1. Temporal — What were you working on?

/recall yesterday
/recall last week
/recall 2026-03-28
/recall this week
/recall last 3 days

Scans memory/YYYY-MM-DD.md and memory/chat-log-YYYY-MM-DD.jsonl files chronologically. Shows a timeline of sessions with topics, decisions made, and tasks in progress.

What it shows:

• Sessions list (time, topic, key decisions)
• Tasks that were in progress → which are done, which are stuck
• Decisions made and why
• Open loops that weren't closed

2. Topic — What do you know about X?

/recall authentication
/recall meeting with Bayram
/recall MoltNet architecture
/recall voice cloning

Searches across:

• memory/ daily files
• MEMORY.md long-term memory
• SESSION-STATE.md
• Any notes in the workspace

Uses keyword + semantic matching. Returns relevant excerpts with dates.

3. Graph — Visualize your work streams

/recall graph yesterday
/recall graph last week
/recall graph last 3 days

Generates an interactive HTML visualization:

• Sessions as nodes, colored by day
• Files touched as connected nodes
• Clusters reveal related work streams
• Shared files show cross-session dependencies

Output: memory/recall-graph-YYYY-MM-DD.html — opens in browser.

The One Thing

Every recall ends with synthesis:

Based on what has momentum, what's blocked, and what's closest to done — here's the single highest-leverage action right now:

[Specific, actionable, not generic]

Not "work on your project." More like "The auth flow has been blocked for 3 days — unblock it by making the decision about OAuth vs API keys you've been deferring."

How It Works

Step-by-step execution

Temporal query:

# 1. Find relevant memory files
ls ~/[workspace]/memory/YYYY-MM-DD.md  # today and requested range

# 2. Read them chronologically
cat memory/2026-03-28.md memory/2026-03-29.md ...

# 3. Also check SESSION-STATE.md for current hot context
cat memory/SESSION-STATE.md

# 4. Build timeline
# 5. Synthesize One Thing

Topic query:

# 1. Search memory files for topic
grep -r "TOPIC" memory/ --include="*.md" -l

# 2. If QMD is available (faster, semantic):
qmd search "TOPIC" -n 10

# 3. Read matched sections
# 4. Synthesize what's known + One Thing

Graph query:

# 1. Parse memory files for file references and decisions
# 2. Build adjacency data
# 3. Generate HTML with D3.js visualization
python3 ${CLAUDE_SKILL_DIR}/scripts/generate-graph.py --days 7 --output memory/recall-graph.html
# 4. Open in browser or share link

Configuration

No configuration required. Works with any workspace that has memory/ files.