memory_list
Lists every memory in a specified project scope, providing the total count and source breakdown. Use to audit the full inventory and verify if specific memories still exist.
Instructions
List every memory in a scope, with counts and source breakdown.
Use this when you want to see the full inventory of what Cortex has stored — e.g. to audit which projects have the most memories, to check if a specific memory you wrote earlier is still present, or to find a memory whose exact title you remember but whose keywords are ambiguous.
Behaviour:
Read-only. No mutations at all, not even telemetry bumps.
No authentication required.
No rate limits. Latency scales linearly with memory count; typical sub-second on corpora up to ~10k.
Data access scope: reads ~/obsidian-brain/cortex/memories/ markdown files via filesystem glob. Nothing leaves the machine.
Idempotent and deterministic for a given filesystem state.
Failure modes: returns "No memories in scope: " for an empty scope. Never raises.
Use memory_list when:
You want to see everything, not a ranked subset
You need to audit the current memory inventory
You're about to run a cleanup/purge operation and want a preflight
You suspect
memory_recallis missing something and want to confirm
Do NOT use for:
Searching for specific content (use
memory_recall— faster, ranked)Assembling a context briefing (use
context_assemble)
Returns: A markdown listing with the total memory count, source type breakdown (mined/user/import), and one line per memory showing its short ID, title, and project. Memories are sorted newest-first by creation date.
Example output: 47 memories Sources: mined:32, user:12, import:3
- [63d6570e] JWT algorithm — RS256 only in prod | project:my-webapp
- [a8b12c44] Pytest fixtures must use tmp_path | project:default
- ...
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scope_id | No | Project scope to list. "default" lists every memory across all projects. A specific project name lists only memories tagged with that project. | default |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |