Skip to content

Commit d66275d

Browse files
LEON-gittechsa-buc
authored andcommitted
Clarify memory_read vs memory_search usage in developer instructions
1 parent 6986b5f commit d66275d

1 file changed

Lines changed: 10 additions & 2 deletions

File tree

codex-rs/core/templates/memories/read_path.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,17 @@ memory files directly**, as they handle relevance scoring, truncation, and
1010
formatting automatically:
1111

1212
- `memory_read` — Read the memory index, relevant topics, and notepad priority.
13-
Use this when you need a broad overview or when starting a new task.
13+
Use this when you need a broad overview or when starting a new task. This
14+
tool combines the MEMORY.md index with the most relevant topics and notepad
15+
priority into a single response.
1416
- `memory_search` — Search topics by query with relevance scoring. Use this
15-
when looking for specific information across many topics.
17+
when looking for specific information across many topics. This searches the
18+
individual topic files under `topics/`, not the MEMORY.md index.
19+
20+
**When to use which:** Start with `memory_read` for a broad overview. If you
21+
need more detail on a specific area, use `memory_search` with targeted keywords.
22+
Do NOT read MEMORY.md or topic files directly — the tools already cover both
23+
the index and the topic content.
1624
- `memory_write` — Create or update a memory topic with frontmatter.
1725
- `memory_add_note` — Append a timestamped note to an existing topic (creates
1826
the topic if it does not exist).

0 commit comments

Comments
 (0)