Memory System

Global Memory

Enable in Settings > Personalization > Global Memory. The agent automatically extracts noteworthy information:

• Your preferences (address, writing style, formats)
• Project background (tech stack, org structure, terminology)
• Recurring conventions (naming, delivery formats)

Memory persists across sessions: no need to repeat yourself; the agent recalls relevant context.

Project Memory

Each project maintains independent memory (MEMORY.md):

• Right-click project → Project Context → Memory tab
• Manually edit knowledge the agent should remember long-term
• Sits alongside AGENTS.md (guidelines) and RULES.md (hard constraints)

Good for: glossaries, historical decisions, API conventions, pitfalls.

How It Works

The agent:

1. Recalls relevant memories when topics arise (memory_recall)
2. Proactively saves new important info (memory_save)
3. Periodically organizes and deduplicates (reflect)

Say “Remember I prefer tables for data” or “Forget what you know about X” to manage memory.

Management

Settings > Personalization > Memory:

• Enable/disable global memory: toggle
• Delete global memory: clears all stored memories (requires confirmation, irreversible)

Token Budget Memory

On long tasks nearing the budget limit, the agent proactively warns you instead of silently truncating, and key decisions are recorded so they can be recovered even after the context is cleared.

This works automatically—nothing to configure.