
Recall
- 42 installs
- 61 repo stars
- Updated August 4, 2026
- joelhooks/joelclaw
Resolve vague 'from earlier' references by fanning out search across daily logs, curated memory, session transcripts, and Vault notes.
About
Resolves vague references to past context by fanning out search across all joelclaw memory sources in parallel. A developer uses it when a request references earlier work that must be found before the agent can act.
- Detects vague context references and fans out across daily logs, curated memory, sessions, and Vault
- Prioritizes fastest sources first (today's daily log) before broader searches
Recall by the numbers
- 42 all-time installs (skills.sh)
- Ranked #8,070 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/joelhooks/joelclaw --skill recallAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 42 |
|---|---|
| repo stars | ★ 61 |
| Last updated | August 4, 2026 |
| Repository | joelhooks/joelclaw ↗ |
What it does
Resolve vague 'from earlier' references by fanning out search across daily logs, curated memory, session transcripts, and Vault notes.
Files
Recall — Find What Was Said
When Joel references something vaguely, don't guess — fan out across all memory sources and find it.
Trigger Detection
Phrases that indicate a recall is needed (case-insensitive):
- "from earlier", "earlier today", "earlier this week"
- "remember when", "remember that", "you mentioned"
- "what we discussed", "what we talked about", "the conversation about"
- "that thing with", "the thing about", "what was that"
- "did we ever", "have we", "wasn't there"
- "last session", "the other day", "yesterday"
- "correlate with", "connect to what we"
- Any vague pronoun reference to past context ("those photos", "that idea", "the notes")
Key principle: If you'd have to guess what "earlier" or "that" refers to, you need recall.
Fan-Out Search Pattern
Search these sources in parallel where possible, with timeouts on each:
1. Today's Daily Log (fastest, most likely)
# Always check first — most "from earlier" references are same-day
cat ~/.joelclaw/workspace/memory/$(date +%Y-%m-%d).md2. Recent Daily Logs (if today's doesn't have it)
# Yesterday and day before
cat ~/.joelclaw/workspace/memory/$(date -v-1d +%Y-%m-%d).md
cat ~/.joelclaw/workspace/memory/$(date -v-2d +%Y-%m-%d).md3. Curated Memory
cat ~/.joelclaw/workspace/MEMORY.mdSearch for keywords from the vague reference.
4. Session Transcripts
Use the session_context tool to search recent sessions:
sessions(limit: 10) # find recent session IDs
session_context(session_id: "...", query: "what was discussed about <topic>")5. Vault Notes
# Keyword search across Vault
grep -ri "<keywords>" ~/Vault/ --include="*.md" -l | head -106. System Log
slog tail --count 20 # recent infrastructure changes7. Processed Media
# Check for images/audio that were processed
ls /tmp/joelclaw-media/ 2>/dev/null8. Redis State
# Memory proposals, loop state, etc.
redis-cli LRANGE memory:review:pending 0 -1 2>/dev/nullWorkflow
1. Extract keywords from the vague reference. "Those photos from earlier" → keywords: photos, images, media, telegram. 2. Fan out across sources 1-8 above. Use timeout 5 on any command that might hang. 3. Synthesize — combine findings into a coherent summary of what was found. 4. Present context — show Joel what you found, then continue with the original task. 5. If nothing found — say so honestly. Don't fabricate. Ask Joel to clarify.
Timeouts Are Mandatory
Every external call (Redis, grep over large dirs, session reads) MUST have a timeout. The gateway session cannot hang on a recall operation.
# Good
timeout 5 grep -ri "keyword" ~/Vault/ --include="*.md" -l | head -10
# Bad — can hang indefinitely
grep -ri "keyword" ~/Vault/ --include="*.md"Anti-Patterns
- Don't grep one file and call it done. The whole point is fan-out.
- Don't guess when recall fails. Say "I couldn't find it" and ask.
- Don't read entire session transcripts. Use
session_contextwith a focused query. - Don't skip media. Photos, audio, processed images in
/tmp/joelclaw-media/are often what "from earlier" refers to.
interface:
icon_small: "./assets/small-logo.svg"
icon_large: "./assets/large-logo.png"
<svg width="16" height="16" viewBox="0 0 512 512" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="JoelClaw icon">
<defs>
<clipPath id="circle-clip">
<circle cx="256" cy="256" r="248" />
</clipPath>
</defs>
<circle cx="256" cy="256" r="248" fill="#0a0a0a" />
<g clip-path="url(#circle-clip)">
<path fill="#ff1493" d="M175.656 22.375l-48.47 82.094c-23.017 4.384-43.547 11.782-60.124 22.374-24.436 15.613-40.572 37.414-45.5 67.875-4.79 29.62 1.568 68.087 24.125 116.093 93.162 22.88 184.08-10.908 257.25-18.813 37.138-4.012 71.196-.898 96.344 22.97 22.33 21.19 36.21 56.808 41.908 113.436 29.246-35.682 44.538-69.065 49.343-99.594 5.543-35.207-2.526-66.97-20.31-95.593-8.52-13.708-19.368-26.618-32-38.626l14.217-33-41.218 10.625c-8.637-6.278-17.765-12.217-27.314-17.782l-7.03-59.782-38.157 37.406c-12.418-5.186-25.184-9.804-38.158-13.812l-8.375-71.28-57.625 56.5c-9.344-1.316-18.625-2.333-27.812-2.97l-31.094-78.125zM222 325.345c-39.146 7.525-82.183 14.312-127.156 11.686 47.403 113.454 207.056 224.082 260.125 87-101.18 33.84-95.303-49.595-132.97-98.686z" />
</g>
</svg>