Memory Skill
How to use
The query is either a search question or a management command. Run via the Bash tool.
The user ID is automatically provided via the PAWLIA_USER_ID environment variable — do NOT pass it manually.
python <scripts_dir>/memory.py search "<question>"
python <scripts_dir>/memory.py index
python <scripts_dir>/memory.py dream
python <scripts_dir>/memory.py lint
python <scripts_dir>/memory.py status
Commands
| Command | Bash call | Description |
|---|---|---|
| search | python <scripts_dir>/memory.py search "<question>" |
Semantic search across all past conversations |
| index | python <scripts_dir>/memory.py index |
Index any new/updated daily chat logs |
| dream | python <scripts_dir>/memory.py dream |
Trigger Dream Wiki: process chat logs into structured wiki pages |
| lint | python <scripts_dir>/memory.py lint |
Wiki health check: merge overlapping pages, fix missing links |
| status | python <scripts_dir>/memory.py status |
Show how many days are indexed |
Step-by-step instructions
- Determine if the query is a command (
index,status,dream,lint) or a search question. - For search questions, use the
searchcommand with the user's question. - Run the command using the Bash tool.
- Return the result — for searches, present the relevant information naturally.
Important
- Every
searchkeyword-scans the full daily-log history straight from the chat logs (no index needed), so any past conversation is recallable — today's, a call/file from minutes ago, and threads from weeks back that were never distilled into the wiki. Only threads that actually share keywords with the question are returned; if nothing matches you get a clear "nothing found" instead of unrelated context. - On top of that,
searchqueries the distilled long-term wiki for consolidated knowledge. Background indexing/dreaming runs automatically on idle — you do not need toindexbefore asearch. - Search results contain relevant excerpts from past conversations — use them to answer the user's question.
- The
dreamcommand processes unprocessed chat logs into a structured wiki with cross-references (Obsidian wikilinks by default, configurable viawiki_link_format). - The Dream Wiki runs automatically when the user has been idle for 30 minutes (configurable via
dream_idle_minutes).