remember
Store one atomic memory claim that an AI agent can recall later. Include enough context for the claim to stand alone.
Instructions
Write one durable memory the agent should be able to recall later. Mutating: persists a memory (set dry_run to validate without writing). Store exactly one atomic, self-contained fact, decision, preference, or lesson per call — include enough context that it stands alone ("the user deploys from the release branch, never main", not just "release branch"). Do not store secrets or raw transcripts. For a plausible-but-unverified inference, use candidate_submit instead so a human approves it first.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Memory kind (fact, decision, preference, lesson, action, ...). Inferred from the content prefix when omitted. | |
| mode | No | How to resolve against existing memories sharing the same entity/claim key. Default auto. | |
| silo | No | Retention tier (e.g. short-term, durable). Omit to use the space default. | |
| tags | No | Free-form tags for filtering and retrieval boosts. | |
| scope | No | Visibility scope: global, workspace, project, session, or custom. | |
| space | No | Memory space (namespace) to write into. Omit for the default space. | |
| pinned | No | If true, exempt from automatic eviction. Default false. | |
| content | Yes | The memory text: one atomic, self-contained claim with enough context to stand on its own. Required. | |
| dry_run | No | If true, validate and return what would be written without persisting. Default false. | |
| project | No | Free-form project key this memory belongs to. | |
| summary | No | Optional shorter summary of the content. | |
| valid_to | No | RFC 3339 timestamp the fact stops being true (past values are excluded from recall). | |
| claim_key | No | Stable key identifying the claim, used to group versions for supersession. | |
| confidence | No | Confidence in the memory, 0.0–1.0. Default 1.0. | |
| entity_key | No | Stable key of the entity this memory is about (groups related memories in the graph). | |
| expires_at | No | RFC 3339 timestamp after which the memory is dropped from recall. | |
| supersedes | No | Memory ids this memory replaces (they become superseded). | |
| valid_from | No | RFC 3339 timestamp the fact starts being true. | |
| contradicts | No | Memory ids this memory conflicts with. | |
| derive_keys | No | Auto-derive entity_key/claim_key from the content when not provided. Default true. | |
| observed_at | No | RFC 3339 timestamp of when this was observed. Defaults to now. | |
| sensitivity | No | Mark sensitive to flag the memory for stricter handling. Default normal. | |
| source_type | No | Provenance: assistant-inference (default) when the agent inferred it, or explicit-user when the user stated it directly. | |
| verified_against | No | What this memory was checked against, if any. |