memory

Memory

Manage a two-tier memory system: $ARGUMENTS

Two Tiers

Daily notes (memory/daily/YYYY-MM-DD.md) — Raw log of what happened. Append freely. These are scratch notes, not documentation.

Long-term memory (memory/long-term/ knowledge base) — Curated wisdom: user preferences, recurring patterns, important decisions. Distilled from daily notes during reviews.

Commands

Action	Command
Log an event	mkdir -p memory/daily && echo "- <entry>" >> memory/daily/$(date +%Y-%m-%d).md
Read today	cat memory/daily/$(date +%Y-%m-%d).md
Recent days	for f in $(ls -r memory/daily/ | head -<N>); do echo "=== $f ==="; cat "memory/daily/$f"; done
Remember (long-term)	aux4 kb add "<topic>" --content "<text>" --tags "<tags>" --folder memory/long-term
Recall	aux4 kb search "<query>" --folder memory/long-term and grep -rl "<query>" memory/daily/
Forget	aux4 kb remove "<topic>" --folder memory/long-term
Review	List recent dailies + aux4 kb list --folder memory/long-term

When to Log

Log things that might matter later:

• Key decisions and why they were made
• User preferences discovered
• Outcomes of significant tasks
• Problems encountered and solutions
• Important context the user shared

Don't log routine operations or things obvious from the codebase.

When to Remember (Long-term)

Promote to long-term when:

• A pattern repeats across sessions
• The user explicitly asks to remember something
• A decision has lasting implications
• You discover a strong user preference

Most daily entries are ephemeral — that's fine. Long-term memory should be lean and high-signal.

Reviewing and Curating

Use review to read recent daily notes alongside long-term memory:

1. Look for patterns, recurring themes, important outcomes
2. Promote what matters with remember
3. Update existing long-term entries if new info changes them
4. Let the rest go — daily notes fade naturally

Recall Strategy

• Long-term results are more reliable (curated)
• Daily results give raw context for recent events
• If you need more detail from a daily match, read that day's full note

Rules

• Log naturally during sessions — don't wait until the end
• When the user says "remember this", save to long-term immediately
• Keep long-term entries concise — one topic per entry
• Use meaningful tags for better search
• Don't fabricate memories — only record what actually happened