Build a project's memory
Memory is an active layer: decisions and learnings produced by your sessions are captured, consolidated and reinjected into upcoming sessions. The agent does not start from scratch.
How capture works
Section titled “How capture works”The memory-local addon listens to chat events:
- Session end (
chat.session.ended) — the addon analyzes the transcript and captures milestones (decisions, learnings, actions, methods). - Runtime failure — notable errors are logged.
- Explicit command (e.g.
/memorize) — you request a specific capture.
Entries are sorted by importance level:
| Level | Typical content |
|---|---|
| L1 | Short note, observation |
| L2 | Relevant technical detail |
| L3 | Session synthesis |
| L4 | Decision, conclusion |
| L5 | Structured learning, method |
Consult memory
Section titled “Consult memory”Memory view in the project:
- List of entries sorted by level and date.
- Filtering by tag, source session, agent.
- Detail of each entry (summary, content, actions, decisions).
How the agent uses it
Section titled “How the agent uses it”Before each turn, memory-local enriches the agent’s context with:
- Recent entries relevant to the project.
- Still-valid decisions and learnings.
- A condensed recall pack that fits the available token budget.
You see the effect immediately: the agent recalls what was decided without you having to re-paste.
What does NOT go into memory
Section titled “What does NOT go into memory”- No secrets, no credentials. If a secret appears in a session, it must not be captured. The addon applies conservative filters.
- Not the raw history. Memory is a semantic extraction, not a transcription log.
Disable memory for a project
Section titled “Disable memory for a project”The Addons view lets you disable memory-local per project if you don’t want capture on this project. Sessions run normally, simply no entry will be added.
Going further
Section titled “Going further”- Memory concept: 03-concepts
- Memory Local dev sheet: ../../dev/addons-firstparty/memory-local
- Data posture: 07-securite-et-donnees