Skip to content
Skill

total-recall

by gavdalf

AI Summary

No database. No vectors. No manual saves. Just an LLM observer that compresses your conversations into prioritised notes, consolidates when they grow, and recovers anything missed. Five layers of redundancy, zero maintenance. ~$0.00/month (using free-tier models). While other memory skills ask you t

Install

Copy this and paste it into Claude Code, Cursor, or any AI assistant:

I want to install the "total-recall" skill in my project.

Please run this command in my terminal:
# Install skill into your project
mkdir -p .claude/skills/total-recall && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/total-recall/SKILL.md "https://raw.githubusercontent.com/gavdalf/total-recall/main/SKILL.md"

Then restart Claude Code (or reload the window in Cursor) so the skill is picked up.

Description

The only memory skill that watches on its own. No database. No vectors. No manual saves. Just an LLM observer that compresses your conversations into prioritised notes, consolidates when they grow, and recovers anything missed. Five layers of redundancy, zero maintenance. ~$0.00/month (using free-tier models). While other memory skills ask you to remember to remember, this one just pays attention.

What It Does

• Observer reads recent session transcripts (JSONL), sends them to an LLM, and appends compressed observations to observations.md with priority levels (high, medium, low) • Reflector kicks in when observations grow too large, consolidating related items and dropping stale low-priority entries • Session Recovery runs at session start, checks if the previous session was captured, and does an emergency observation if not • Reactive Watcher watches the session directory with inotify so high-activity periods get captured faster than the cron interval • Pre-compaction hook fires when OpenClaw is about to compact context, ensuring nothing is lost

Install inotify-tools (Debian/Ubuntu)

sudo apt install inotify-tools

What It Does

• Classifies every observation by impact (critical / high / medium / low / minimal) and age • Archives items that have passed their relevance threshold • Adds a semantic hook for each archived item (specific keywords + archive reference) • Validates the result and rolls back automatically if something goes wrong

Features

Multi-Hook Retrieval — 4-5 alternative search phrasings per archived item. Searches using different words than the original still find the memory. Confidence Scoring — every observation gets a confidence score (0.0-1.0) and source type (explicit, implicit, inference, weak, uncertain). High-confidence items are preserved longer; low-confidence items are archived sooner. Memory Type System — 7 types with per-type TTLs: event (14d), fact (90d), preference (180d), goal (365d), habit (365d), rule (never), context (30d). Embedded as invisible HTML metadata comments in observations.md. **Obser

Discussion

0/2000
Loading comments...

Health Signals

MaintenanceCommitted 2mo ago
Active
Adoption100+ stars on GitHub
264 ★ · Growing
DocsREADME + description
Well-documented

GitHub Signals

Stars264
Forks42
Issues5
Updated2mo ago
View on GitHub
MIT License

My Fox Den

Community Rating

Sign in to rate this booster

Works With

Claude Code