Store a memory for AI agents. Persists information across sessions.

Search memories. Returns relevant context from past sessions.

Delete a specific memory by ID.

Update an existing memory in-place without losing metadata.

Trace the supersession chain of a memory: the point itself plus all successors (and predecessors via superseded_by), ordered by valid_from. Shows how a fact evolved over time.

Check if Nexus Memory is running and healthy.

Check if a newer version is available on GitHub.

Update Nexus Memory to the latest version. Pulls from GitHub and reinstalls.

Register a webhook URL to receive HTTP POST notifications when a memory event of the given type fires. Returns the subscription id (UUID) which you need to unsubscribe. Subscriptions are stored in ~/.nexus-webhooks.json and survive server restarts.

Remove a webhook subscription by its id (returned from subscribe).

List all currently registered webhook subscriptions (id, event_type, webhook_url, created_at).

Create a full backup of all memories as JSON file. Includes payloads + vectors. Saved to ~/.nexus-memory/backups/. Runs automatically every 24h - use this for manual backup on demand.

Restore memories from a backup JSON file. By default reuses stored vectors (zero API cost). Set reembed=true to re-embed with current provider (for provider changes).

Active Guardrails: Check if an action is safe before executing it. Queries Nexus Memory for protection rules (category='rule' with protection keywords like 'niemals', 'never delete', 'protected'). Returns allow/block/override verdict. Use before destructive operations (rm, drop, kill, overwrite, recreate).

Active Guardrails: Record a guardrail override with full audit trail. Required when guardrail_check returns 'block' but the action is explicitly authorized. The override is stored as a private session memory entry for audit. Requires explicit reasoning (min 10 chars).

Knowledge Graph: Multi-hop traversal from a starting fact. Answers 'what is connected to X?' across the entity graph. Returns a list of {fact_id, depth, relation, path} dicts.

Knowledge Graph: Find all entity-typed memories in Qdrant. Returns a list of {id, name, entity_type, content, attributes} dicts.

Knowledge Graph: Get a subgraph centered on a fact for visualization. Returns {nodes, edges} where nodes have {id, depth} and edges have {source, target, relation}.

Knowledge Graph: Get directly related facts (1-hop, bidirectional). Returns a list of {fact_id, relation, edge_id, direction} dicts.

Cost-Aware Routing: Get statistics about embedding provider routing. Shows available providers, routing decisions per provider, and tier configuration.

Cost-Aware Routing: Explain the routing decision for a memory category. Returns a human-readable explanation of which provider will be used and why.