---
name: proxium-memory-save
description: >-
  Write to the proxium project memory. Use when the user says "remember this",
  "note that we decided", "that is wrong", "forget that", or when the task produced
  something a later session needs: a decision and its reason, a preference, a fact
  about the system or the customer, an event, or a procedure that worked. Uses
  proxium_save_memory, proxium_correct_memory, proxium_rate_memory and
  proxium_forget_memory.
compatibility: Needs the proxium MCP server (https://proxium.tech/mcp) connected in the agent.
---

# Write to the project memory

## When to save

Save a statement only when all three are true:

1. A later session needs it.
2. The code, the docs and the git history do not already hold it.
3. It is true after this conversation ends.

Good: "The order service uses Postgres, because checkout needs multi-row
transactions." Bad: "The user said hello." Bad: "I am now editing main.rs."

## How to save

Call `proxium_save_memory` once for each statement.

- `text`: one statement, true on its own, in plain words. Keep names and numbers
  exact. Do not write "the user said".
- `kind`: `fact`, `preference`, `decision`, `event` or `procedure`. A decision
  includes its reason.
- `importance`: 0 to 5. Use 4 or 5 only for what changes how the team works.
- `subject`: only for a memory about one end user of the project's product.

Before you save, search with `proxium_search_memory`. If a memory already says it,
do not save it again. If a memory says something older, correct that memory.

## Correct, rate, remove

- **The memory changed:** `proxium_correct_memory` with the memory's `id` and the new
  text. The old text stays in the history.
- **You used a memory:** `proxium_rate_memory` with `useful`, or with `wrong` when it
  was not true. Two `wrong` ratings take it out of the recall until a person reviews it.
- **The memory is wrong or not needed:** `proxium_forget_memory`. It leaves every
  recall and stays in the history.

A memory with origin `human` is a person's. You cannot correct or remove it. Tell the
person what is wrong, and let them change it in the proxium console.