Remember
chaoscore_rememberSave key-value data to persistent memory for later retrieval, overwriting existing keys and updating timestamps. Optionally add tags or TTL for controlled recall.
Instructions
Persist a key/value record to Semantic Memory (durable, SQLite-backed), so it can be retrieved later with chaoscore_recall — in this session, in a future session, after a server restart, and from either transport. Writing to an existing key overwrites its value and updates its timestamp, making chaoscore_remember idempotent for a given key/value pair.
Memory is a property of the deployment, not of the connection: a record written over stdio is readable over HTTP and vice versa, provided both point at the same database file.
Args:
key (string, 1-200 chars): Unique identifier for this memory
value (string): The content to remember
tags (array of strings): Optional tags for filtering later (default: [])
ttl_seconds (number, optional): If set, the record is treated as expired (and excluded from chaoscore_recall) after this many seconds
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: For JSON format: { "key": string, "value": string, "tags": string[], "createdAt": string, "updatedAt": string, "expiresAt": string | null }
Examples:
Use when: "Remember that the staging DB uses the Melbourne region" -> key="staging.region", value="Melbourne (australiaeast)"
Don't use when: You need to search existing memories -> use chaoscore_recall instead
Error Handling:
Returns "Error: ..." with the underlying SQLite error message if the write fails (e.g. disk full, path unwritable)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | Unique key for this memory. Writing an existing key overwrites its value. | |
| tags | No | Optional tags for later filtering with chaoscore_recall | |
| value | Yes | The content to remember | |
| ttl_seconds | No | Optional time-to-live in seconds. Omit for a record that never expires. | |
| response_format | No | Output format: 'markdown' for human-readable or 'json' for machine-readable | markdown |