memorystorage / memory write

Memory Write

memory_write

Writes or updates a persistent fact in the agent memory store. Use when: storing decisions, preferences, project details, or any key-value data that should persist across sessions and clients. Scope: local filesystem (~/.config/agentic-store/memory/facts.json). No network access. Not for: logging events (use memory_log), saving session snapshots (use memory_checkpoint), or retrieving facts (use memory_read).

How to use memory_write

Provide only the required inputs below. Start with the smallest scope that answers the task, then review the risk properties before an agent executes the call.

Risk and execution properties

Read only: no

Destructive: no

Idempotent: no

Open world: no — operates locally or through configured services

Inputs

keystringrequired

Unique fact identifier. Example: 'project_language', 'user_preferred_style'.

valuevaluerequired

Value to store. Can be a string, number, boolean, list, or object.

categorystring

Optional grouping label. Example: 'project', 'preferences', 'context'. Defaults to 'facts'.

Default: "facts"

Example input

{
  "key": "<string>",
  "value": "<value>",
  "category": "facts"
}

Browse or search the full 74-tool reference to choose the smallest suitable capability.

Browse all tools →