Project memory

A session starts knowing only what its instruction files and your prompt tell it. Project memory is a place where a project keeps the things you want its later sessions to know as well: a decision you made, a finding that took an hour to work out, a rule about one file. The studio adds the memory that fits to the prompts it sends, so you do not have to repeat yourself.

It is off until you turn it on, on each computer. The instruction files (CLAUDE.md, AGENTS.md) are not touched by it; see Instruction files for those.

Turn it on

1. Open a project and press Project memory in its header.
2. Press Enable project memory on this computer.

The advanced first-run setup offers the same switch. Turning memory off later stops anything new from being found, given or proposed, and keeps what was saved. It cannot take back what was already sent to a tool.

Add to the memory

There are three ways, and in all of them you decide what is kept.

• Add memory in the Project memory window, and write it yourself.
• Remember this message on a message of a conversation. The memory keeps a short quote of that message and where it came from.
• Ask the project's own AI subscription to propose memory from sources you pick. It reads only those, proposes at most a dozen items, and every proposal waits for you to approve, edit or drop it. This is the only part that uses a model, and only when you ask.

A technical finding needs its source and the system it applies to, so a fix found on Windows is not given to a session on a Mac. A finding tied to a file goes stale when that file changes.

What a session gets

When you send a prompt from the studio, it picks the memory that fits the prompt, the project and the computer, up to a fixed size, and sends it with the prompt as background, not as an order. Your prompt and the project's own instructions come first. Picking needs no model and costs nothing.

Under the session you can see what each prompt was given. Being given memory does not mean the model read it or followed it.

Change, retire or delete

Every item can be edited, replaced by a newer one, set aside or deleted, and keeps its history. Deleting removes the text from the studio's own data, including the copies of it kept for sessions. It cannot remove it from a tool's own transcript or a provider's records.

Carry memory to another computer

When you carry a project to another computer, Carry selected memory lets you choose which items go. On the other side you see them first and decide what to do with each one that differs. The computer it came from is not changed.

Small tips

Questions