aboutsummaryrefslogtreecommitdiff
path: root/skills/memory-and-profile.md
diff options
context:
space:
mode:
Diffstat (limited to 'skills/memory-and-profile.md')
-rw-r--r--skills/memory-and-profile.md30
1 files changed, 30 insertions, 0 deletions
diff --git a/skills/memory-and-profile.md b/skills/memory-and-profile.md
new file mode 100644
index 0000000..6605893
--- /dev/null
+++ b/skills/memory-and-profile.md
@@ -0,0 +1,30 @@
+---
+name: memory-and-profile
+description: How to use the user profile system, session memory, and pattern tracking for persistent context
+tags: [memory, profile, session, persistence]
+category: system
+---
+## Steps
+1. **User Profile (persists across sessions):**
+ - user_get(key) — read any profile field (e.g. "preferredModel", "fontSize")
+ - user_set(key, value) — write to profile, auto-persists to localStorage
+ - user_list — show all stored profile keys
+ - user_forget(key) — delete a profile key
+ - Dot notation supported: user_set knownFacts.name "Alex"
+
+2. **Session Memory (VFS-based daily logs):**
+ - session_save(summary) — save a summary of what was accomplished
+ - session_load(date) — read a specific day's log (format: YYYY-MM-DD)
+ - session_recent(count) — show last N session summaries
+ - session_stats — aggregate totals across all sessions
+ - Recent sessions auto-load into context on first message
+
+3. **Conversation Patterns:**
+ - Pattern tracking runs automatically — frequent topics surface as hints
+ - my-set, my-get, my-list store additional personal data
+ - AI conversation context persists within a session (use ai-clear to reset)
+
+4. **When to use:**
+ - At start: call session_recent(3) to see what was worked on before
+ - After identifying user preferences: call user_set to store them
+ - After complex tasks: call session_save with a brief summary \ No newline at end of file