Durable agent memory, semantic search, and graph relationships through one API. Push JSON once; query it by meaning, structure, or connection.
Website • Documentation • Cloud • Agent setup • Examples
RushDB supports automatic runtime memory, model-directed tools, and application-controlled memory without forcing them into one abstraction.
| What you need | Use |
|---|---|
| Automatic recall and completed-turn persistence in OpenClaw | @rushdb/openclaw-memory |
| Native lifecycle memory in Hermes Agent | rushdb-hermes-memory |
| Explicit graph queries and intentional memory writes from an agent | @rushdb/mcp-server |
| Reusable modeling, query, and memory guidance for coding agents | RushDB Agent Skills |
| Application-controlled agent lifecycle | @rushdb/agent-memory-contract with a RushDB SDK |
| Records, relationships, semantic search, and application data | TypeScript, Python, or REST |
Native memory owns automatic recall and completed-turn capture. MCP remains the explicit knowledge plane for records such as DECISION, TASK, ENTITY, and ARTIFACT, so the same turn is not written twice.
openclaw plugins install @rushdb/openclaw-memory
export RUSHDB_API_KEY="your-project-api-key"The additive plugin recalls before prompt construction and durably captures successful completed turns while leaving OpenClaw's Markdown and SQLite memory active.
pip install rushdb-hermes-memory
export RUSHDB_API_KEY="your-project-api-key"
hermes memory setupThe native MemoryProvider participates in prefetch, completed-turn sync, pre-compression, session changes, session end, and shutdown. Supported explicit Hermes memory writes become scoped memory facts.
Both connectors:
- apply trusted agent, profile, privacy, participant, and sandbox scope before semantic ranking;
- capture bounded user/assistant content instead of complete transcripts or tool output;
- fail open when remote recall is slow or unavailable;
- write through a local durable outbox and replay after restart;
- use deterministic identities and idempotent RushDB upserts;
- keep a recent-write fallback while managed embeddings become visible.
AgentMemoryEvent v1 gives native connectors and custom harnesses the same provider-neutral memory model.
| Record | Purpose | Semantic property |
|---|---|---|
EPISODE |
One bounded completed turn or lifecycle observation | summary |
MEMORY_FACT |
A curated preference, rule, or fact | text |
The @rushdb/agent-memory-contract package publishes TypeScript primitives, deterministic identity helpers, the JSON Schema, and a language-neutral conformance fixture.
pnpm add @rushdb/agent-memory-contractFor ChatGPT, Claude.ai, and other remote clients, connect directly to:
https://mcp.rushdb.com/mcp
For local MCP clients such as Claude Desktop, Cursor, Windsurf, and VS Code:
{
"mcpServers": {
"rushdb": {
"command": "npx",
"args": ["@rushdb/mcp-server"],
"env": {
"RUSHDB_API_KEY": "your-project-api-key"
}
}
}
}MCP installation and OAuth setup →
Get an API key at app.rushdb.com, then install a RushDB SDK:
pnpm add @rushdb/javascript-sdk
# or
pip install rushdbimport RushDB from '@rushdb/javascript-sdk'
const db = new RushDB('RUSHDB_API_KEY')
await db.ai.indexes.create({
label: 'MEMORY',
propertyName: 'text'
})
await db.records.create({
label: 'MEMORY',
data: {
agentId: 'agent-42',
topic: 'authentication',
text: 'Use passkeys for the new account flow.'
}
})
const memories = await db.records.vectorSearch({
labels: ['MEMORY'],
propertyName: 'text',
query: 'What did we decide about authentication?',
where: { agentId: 'agent-42' },
limit: 10
})RushDB manages embeddings server-side. The same query can combine semantic ranking with structured filters and graph traversal.
| Without RushDB | With RushDB |
|---|---|
| Separate vector, graph, and application stores | One graph + vector API |
| Manual embedding pipeline | Managed embeddings on every indexed write |
| Schema and migration work before ingestion | Push arbitrary nested JSON |
| Relationships reconstructed in application code | Native traversal and relationship discovery |
| Runtime-specific memory formats | Shared event contract for native and custom adapters |
You also get filtering, aggregation, transactions, CSV and JSON import, cloud and self-hosted deployment, TypeScript and Python SDKs, REST, MCP, and agent skills.
| Project | What it contains |
|---|---|
| rushdb | Core API, dashboard, TypeScript SDK, MCP server, agent contract, skills, and deployment templates |
| rushdb-python | Python SDK |
| rushdb-openclaw-memory | Additive OpenClaw native memory plugin |
| rushdb-hermes-memory | Hermes Agent native memory provider |
| docs | Source for docs.rushdb.com |
| examples | Runnable integrations and use cases |
| Topic | Link |
|---|---|
| Give an agent the setup guide | rushdb.com/agent-setup |
| Agent integrations | Connect agents |
| Agent skills | Install RushDB skills |
| Agent memory quickstart | Build persistent memory |
| TypeScript SDK | SDK documentation |
| Python SDK | SDK documentation |
| Self-hosting | Deployment guide |