engram

Remove a memory from SurrealDB. Soft-deletes by marking as forgotten.

View or update the current SurrealDB memory configuration without the full setup wizard.

Interactive setup wizard for the SurrealDB memory system. Auto-detects environment, configures deployment mode, and verifies connectivity.

Show the status of the SurrealDB memory system — connection, counts, and configuration.

Search and retrieve memories from SurrealDB. Find past knowledge, decisions, and patterns.

Store a memory in SurrealDB. Persists knowledge, decisions, patterns, or experiences across sessions.

Use this agent when memory maintenance is needed — consolidating session memories, promoting important memories to project/user scope, and pruning low-value memories. Triggered by Stop hook or manually via /memory-consolidate. <example> Context: End of a productive coding session. user: "We're done for today, consolidate what we learned." assistant: "I'll use the memory-consolidator agent to review and persist session learnings." <commentary> Session ending, consolidation needed to preserve valuable session memories. </commentary> </example> <example> Context: Memory system has grown large. user: "Clean up the memory database" assistant: "I'll dispatch the memory-consolidator to review, merge duplicates, and prune low-value memories." <commentary> Explicit maintenance request for memory cleanup. </commentary> </example>

This skill should be used when the user asks to "manage memory", "consolidate memories", "promote memories", "archive old memories", "check memory health", "prune knowledge graph", "switch deployment mode", "export memory", or needs guidance on memory lifecycle management. Covers: consolidation pipeline, promotion criteria, archival, knowledge graph maintenance, deployment mode switching, memory diagnostics, and troubleshooting.

This skill should be used when the user asks to "search memories", "find in memory", "what do I remember about X", "recall past decisions", "check memory for X", or needs guidance on constructing memory queries. Covers: MCP tool usage patterns, memory type selection (episodic/semantic/procedural/working), scope selection (session/project/user), importance scoring, and retrieval strategies (BM25, graph, hybrid).

Use this skill when you need to write SurrealQL queries or schema definitions. Triggers on: "SurrealQL", "SurrealDB query", "surql", "DEFINE", "SELECT FROM", "CREATE TABLE", "RELATE", "full-text search", "vector search", "HNSW", "graph traversal", "computed field", "memory strength decay", "knowledge graph", "edge queries", "record link", "UPSERT", "BM25", "search operator", "@1@", "SPLIT", "FETCH". Use this skill to understand exact SurrealQL syntax for the surrealdb-memory plugin.

This skill should be used when writing SurrealQL queries for SurrealDB 3.0, modifying the engram schema, or debugging SurrealQL errors. Triggers on: "SurrealQL", "surql", "SurrealDB query", "schema change", "DEFINE TABLE", "DEFINE FIELD", "DEFINE INDEX", "UPSERT", "RELATE", or any SurrealDB DDL.