| name | ctx-remember |
| description | Recall project context and present structured readback. Use when the user asks 'do you remember?', at session start, or when context seems lost. |
Recall project context and present a structured readback as if
remembering, not searching.
Before Recalling
Check that the context directory exists. If it does not, tell the
user: "No context directory found. Run ctx init to set up context
tracking, then there will be something to remember."
When to Use
- The user asks "do you remember?", "what were we working on?",
or any memory-related question
- At the start of a session when context is not yet loaded
- When context seems lost or stale mid-session
- When the user asks about previous work, decisions, or learnings
When NOT to Use
- Context was already loaded this session via
/ctx-agent: don't
re-fetch what you already have
- Mid-session when you are actively working on a task and context
is fresh: don't interrupt flow
- When the user is asking about a specific past session by name
or ID: use
/ctx-history instead, which has list/show/export
subcommands
Process
Do all of this silently: narrating the steps makes the readback
feel like a file search rather than genuine recall:
-
Load context packet:
ctx agent
-
Read the files listed in the packet's "Read These Files"
section (TASKS.md, DECISIONS.md, LEARNINGS.md, etc.)
-
List recent sessions:
ctx journal source --limit 3