Memory
Memory is a durable, long-term, per-repository knowledge base for everything your team
decides about a repo's tests — quarantine calls, assertion conventions, maintenance TODOs,
and “always / never” constraints. Memories are auto-saved and auto-categorized
from your Ask AI conversations (after you approve), then read back on every future turn — in
the platform's Repo Memory tab, from the CLI's map command, and by AI coding agents
through the MCP memory tools. Because the context persists across sessions, assistants get
precise, repo-specific grounding on the very next turn instead of re-deriving it.
Memory is in Beta. The Repo Memory tab, Ask AI auto-save, the MCP memory tools, and the
CLI map command are all available now.
This page is about repo Memory — a team-shared, per-repository knowledge base. It is different from Ask AI's conversation memory, which is the per-user recall of your recent chats and preferences. See Ask AI → Memory for that. Repo Memory is scoped to a repository and shared with your team, not to a person.
Why it exists
Test knowledge usually lives in one engineer's head or scrolls out of a chat history: why a test was quarantined, why an assertion is written a certain way, what still needs cleaning up. Memory captures those decisions once and keeps them durable, so neither a teammate nor an AI agent re-litigates them. Ask AI reads the repo's memory before reasoning about its tests, so its answers respect established decisions instead of contradicting them.
The four categories
Every memory is auto-classified into one of four categories so the right context surfaces at the right time.
| Category | What it captures | Example |
|---|---|---|
| Decision | Agreed verdicts | “Quarantine login_oauth.spec — flaky in CI.” |
| Insight | Observations and findings | “checkout flakes on the OAuth redirect, not the payment step.” |
| Maintenance | Follow-up TODOs and refactors | “Split the cart suite after the v3 migration.” |
| Context | Constraints and conventions | “Never assert on toast timing — it's environment-dependent.” |
How memories are created
There are three sources. Each memory records its source, so you always know where it came from.
From Ask AI (auto-save)
In any repo-scoped Ask AI chat, when you agree to a decision the agent proposes a memory. An Approve / Reject prompt appears above the composer — nothing is written until you confirm. On approval, the memory is saved, its category is auto-classified from the title and content, and (when relevant) it's linked to a specific test. The entry keeps a link back to the conversation that created it.
You don't need to ask the agent to “save this.” When the conversation reaches a decision, it offers to persist it — you just approve or reject.
Manually
Open the repo's Memory tab and choose Add Memory. Give it a title and content, and optionally tie it to a test. Manually created entries are marked with the Manual source.
From an AI agent over MCP
AI coding agents can save memories through the MCP memory tools (for example, recording a
decision reached while fixing a test), so context captured by an assistant is available on the
next turn. Writes require the mcp:memory token scope. See
MCP capabilities.
Viewing and managing memories
Open a repository and select the Repo Memory tab (marked Beta). There you can:
- Scan the stats strip — total active memories, how many map to live tests, and how many reference a test spec that no longer exists.
- Spot stale entries — a memory whose linked test spec is gone is flagged with a “test spec no longer found” warning, so you can update or archive it.
- Search memories by title, content, or linked test.
- Open the conversation that created an Ask AI memory.
- Edit, archive, or delete entries. Archived memories are hidden from the agent but stay recoverable; deleting is permanent.
How memory is read back
| Surface | What it does |
|---|---|
| Ask AI | Injects the repo's memory digest into every repo-scoped turn, so answers respect prior decisions. |
| Repo Memory tab | The team's view — browse, search, and manage every entry. |
| CLI | Review and manage repo memory from the terminal with the map command. See CLI slash commands. |
| AI agents (MCP) | Read the digest and write new memories through the MCP memory tools. See MCP capabilities. |
FAQ
FAQ
How is Memory different from Ask AI conversation memory?
Will the agent save things without asking?
What happens to a memory if its linked test is deleted?
Who can see a repository’s memory?
Related
- Ask AI — where most memories are created (and the home of conversation memory).
- CLI slash commands — manage memory from the terminal with the
mapcommand. - MCP capabilities — how AI agents read and write memory.
- Repositories — where the Memory tab lives.