Skip to content

Reminders during work

After the briefing, agent-mem speaks only when it has something specific to say. You see none of it in the terminal. The agent gets it as context, framed as data.

agent-mem searches memory with your prompt and gives the agent the matches it is confident about:

- [T1 · 2026-10-13 · claude] Add a subtract function to calc.py and run the tests → Added `subtract` to calc.py; `uv run pytest -q` passes (2 tests). (files: calc.py)

Confident means: a high enough score, and at least two of the question’s content words (one if it has only one) in the match, covering at least half of them. A match by meaning must still share a third of the words. No confident match, no context: a weak match cannot be told from an unrelated one, and noise is not context.

Time words help. “What did we do last week about the parser?” ranks last week’s requests first.

A rule you taught it. After you said “use pnpm instead of npm” twice:

- Note (R1): earlier correction — Use `pnpm` instead of `npm` (2x).

Switch the rule on (agent-mem rules enable R1) and npm is blocked with that reason. See Rules & Lessons.

The history of a file. Before the agent reads or edits a file that memories are linked to:

Earlier memories about this file (history, not its current contents):
- Caution [M12 · 2026-10-09] calc.py: Changes to calc.py were reverted (`git checkout`) — context: Make subtract accept strings
- Decision [M7 · 2026-10-12] calc.py: Keep calc.py free of third-party imports

Failed attempts first, then decisions and lessons, then facts. Up to three per file, each memory once per session. Facts older than the file’s last change are left out because they may describe code that is gone. A small file (under 1.5 KB) gets no history when it is only read; reading it costs about as much.

If the same error was fixed before in this project:

- This error was seen before with `uv run pytest` and fixed by changing calc.py (see T1). Seen 1x, fixed 1x.

Only for tests, builds, lints and installs. A failed cat or grep is looking around, not an error worth a recipe.

When the agent’s context is compacted, it gets back what the cut part must not lose:

- Session goal (T41): Add a subtract function to calc.py and run the tests
- [M7 · decision] Keep calc.py free of third-party imports
- Still failing: `uv run pytest` E ImportError: …
- Files touched: calc.py, test_calc.py
ReminderBudget (tokens)Key
matching memories2,400budgets.prompt
rule note300budgets.warning
file history1,200budgets.file_history
fix hint400budgets.failure
after compaction4,000budgets.compact

0 turns one off. To get more or fewer matches per prompt, change retrieval.inject_min_score (0.35) and retrieval.min_term_coverage (0.5); lower means more context and more noise.