| name | recall |
| description | Pull relevant findings stashed from past sessions — on demand. Triggers on: recall, remember, what did I learn, prior session, past findings, did I hit this before, what do we know about. |
Recall
IMPORTANT: Start your response by telling the user:
Recall — Searching cross-session memory for findings related to
your query.
What It Does
/recall is the on-demand companion to the automatic SessionStart
recall. It searches the findings stashed by the Stop hook across past
sessions (file backend by default; Redis AMS when connected) and
surfaces the most relevant ones, formatted for reading.
- With a query (
/recall AMS event loop): keyword + recency search,
same-project findings ranked first.
- No query (
/recall): the most recent findings for this project.
How To Run It
Recall is exposed through attune.memory.session_stash. Run the
appropriate snippet via Bash from the project root, then present the
results as a readable list (newest / most-relevant first), grouped or
annotated by their [type].
With a query:
python -c "import json, os; from attune.memory.session_stash import recall_entries; print(json.dumps(recall_entries(os.environ['Q'], top_k=8, cwd=os.getcwd()), ensure_ascii=False))"
Pass the user's topic as the Q environment variable (avoids quoting
issues), e.g. Q="AMS event loop" python -c "...".
No query (recent):
python -c "import json, os; from attune.memory.session_stash import recent_entries; print(json.dumps(recent_entries(top_k=8, cwd=os.getcwd()), ensure_ascii=False))"
Each result is a dict with text, topics (carrying type:<kind> and
cwd:<path>), cwd, and session_id. Render them as:
- [decision] <text>
- [bug] <text>
When Nothing Comes Back
An empty list means no matching findings yet (the store fills as the
Stop hook stashes findings over sessions), or no searchable backend is
installed. Say so plainly — do not invent findings. Suggest the
user keep working; the soak fills the store over time.
Promote A Keeper
If a recalled finding is worth keeping permanently, the user can
promote it into curated memory with /remember — the durable,
human-curated tier above this raw cross-session stash.
