Terminal
Terminal/Skill
Read-only lookup of official SurrealDB Agent Memory docs from surrealdb.com, for building with it or answering questions about it.
By SurrealDB
Works with
npx skills add surrealdb/agent-skills --skill surrealdb-agent-memory-docsFetch the official SurrealDB Agent Memory docs, published at surrealdb.com/docs/agent-memory. Every page is available as markdown over HTTPS.
Agent Memory was developed as Spectron, and the rename is only partly done. Some pages still say "Spectron", so search for both names.
agent-memory CLI and MCP server, and the SDKs (@surrealdb/memory, surrealdb-memory, …)SPECTRON_* env vars, X-Spectron-* headers, and the ~/.config/spectron/ config directoryhttps://surrealdb.com/docs/agent-memory/reference/agents.md: a condensed guide written for coding agentshttps://surrealdb.com/docs/agent-memory.md: the hub, which links every sectionAll paths are relative to https://surrealdb.com/docs/agent-memory/. Append .md.
| Path | Use for |
|---|---|
welcome/, quickstarts/ | What it is; hosted, SurrealDB Cloud, and embedded setup |
architecture/, mental-model/ | Principles, tri-temporal model, contexts and scope, sessions, categories, provenance |
memory-and-knowledge (hub) | Index of the sections below |
ingest/authoritative/, ingest/experiential/ | Uploading documents, bulk import, knowledge nodes, multimodal content, remember |
sessions/ | Creating sessions, adding turns, chat sessions, state and diffs |
retrieve/ | recall, hybrid search, BM25, graph traversal |
reasoning/ | Extraction, reconciliation and supersession, authority, temporal validity |
operations/, tuning/ | reflect, forget, profiles; models per stage, caching, ontology |
integrations/ | sdks/, mcp-server/ (per coding assistant), frameworks/, ai-sdks/, surfaces/ (REST, embedded, filesystem view), voice, automation, observability |
cookbooks/ | build/ end-to-end agents, migrate/ (from mem0, Zep, LangMem, vector stores), patterns/ |
reference/ | REST and management API, SDK methods, MCP tools, CLI, configuration, data model, errors |
Section hubs are integrations.md, cookbooks.md, and reference.md. The full
site index, including every Agent Memory page, is
https://surrealdb.com/docs/llms.txt.
curl -s https://surrealdb.com/docs/agent-memory.md
curl -s https://surrealdb.com/docs/agent-memory/retrieve/recall.md
surrealdb.sh is a read-only mirror of the same markdown source, operated by
SurrealDB (source:
github.com/surrealdb/surrealdb-ssh).
It is a sandboxed, simulated shell with no database, no network, and no login.
The Agent Memory docs live under /surrealdb/docs/agent-memory.
ssh surrealdb.sh ls -R /surrealdb/docs/agent-memory/index
ssh surrealdb.sh grep -rl 'recall' /surrealdb/docs/agent-memory/reference
ssh surrealdb.sh cat /surrealdb/docs/agent-memory/index/retrieve/recall.mdx
To turn an SSH path into a web URL, strip /surrealdb/docs/agent-memory/ and
any leading index/, drop .mdx (and a trailing /index), then append .md:
…/agent-memory/index/retrieve/recall.mdx → /docs/agent-memory/retrieve/recall.md…/agent-memory/reference/cli.mdx → /docs/agent-memory/reference/cli.md…/agent-memory/cookbooks/index.mdx → /docs/agent-memory/cookbooks.md…/agent-memory/index/index.mdx → /docs/agent-memory.mdHost key: SHA256:UiD3SB6O1RCQxx8DZGfuVCE2rp//lugjYLM6spQNVgs (RSA). If it
differs, or SSH is unavailable, use HTTPS.
/surrealdb/docs/agent-memory. An
unscoped grep -r can hit the 10s exec timeout.