| name | remember |
| description | Store a memory from the current session. Triggered by /remember, 'remember this', 'save that', or session end in auto mode. Summarizes work, detects project, appends to correct memory file. |
Remember — Store Memory
When This Fires
- User types
/remember
- User says "remember this", "save that", "note that down"
- Auto mode: session is ending
What To Do
Step 1: Classify the memory
| Conversation contains... | Write to... |
|---|
| How the agent should behave | ~/katana-agent/agent/memory/core/soul.md → Learned Behaviors |
| User preferences, goals, personal facts | ~/katana-agent/agent/memory/core/user.md → appropriate section |
| Work done, code changes, decisions | ~/katana-agent/agent/memory/work.md → new entry at top |
If session contains multiple types, write to multiple files.
Step 2: Summarize
- Strip raw code blocks longer than 5 lines
- Strip tool call outputs and error logs
- Strip repetitive troubleshooting
- Keep: decisions, problems solved, features built, user preferences
- Condense to 1-3 sentences for work.md
Step 3: Detect project context
- If user specified:
/remember --project myapp → use that
- If inside a git repo: use repo folder name
- If neither: ask user or tag as
general
Step 4: Write
work.md — prepend at TOP:
## YYYY-MM-DD — project-tag
Summary sentence(s).
user.md — find right section, append:
- YYYY-MM-DD: New context or preference noted here.
soul.md — append to Learned Behaviors:
- NEW: Description of learned behavior
Step 5: Confirm (manual mode)
Before writing, show the user:
📝 Memory save:
→ work.md: "Summary of what happened"
Tagged: project-name | YYYY-MM-DD
Save this? (y/n/edit)
Step 6: Acknowledge
✓ Saved to work.md (project-name, YYYY-MM-DD)
