agentdb query
- Repo stars 54,444
- Author repo ruflo
- Domain
- AI
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @ruvnet · no license declared
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- macOS · Linux · Windows
- Runtime requirements
- Node.js
- Detected file/system behavior
-
- Read-only
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# AgentDB Query
Query and manage AgentDB through the controller bridge. AgentDB exposes 15 `agentdb_*` MCP tools; this skill enumerates the standard usage path.
## When to use
When you need to store, retrieve, or search knowledge across agent sessions. AgentDB provides hierarchical storage, causal knowledge graphs, semantic routing, and context synthesis.
## Steps
1. **Check health** — `mcp__claude-flow__agentdb_health`. Sanity-check `available: true`.
2. **Start session** — `mcp__claude-flow__agentdb_session-start` if not already active.
3. **Store knowledge** — `mcp__claude-flow__agentdb_hierarchical-store` for structured tier-keyed data (tiers: `working|episodic|semantic`).
4. **Recall knowledge** — `mcp__claude-flow__agentdb_hierarchical-recall` with a query.
5. **Search patterns** — `mcp__claude-flow__agentdb_pattern-search` for learned patterns (ReasoningBank-routed).
6. **Synthesize context** — `mcp__claude-flow__agentdb_context-synthesize` to combine multiple memories.
7. **Build causal graph** — `mcp__claude-flow__agentdb_causal-edge` to link related knowledge.
## Available controller groups
Call `mcp__claude-flow__agentdb_controllers` to list the runtime registry. Functional categories surfaced via the 15 MCP tools:
- **Hierarchical** — `agentdb_hierarchical-store`, `_recall` (tier-routed)
- **Pattern** — `agentdb_pattern-store`, `_search` (ReasoningBank-routed)
- **Semantic** — `agentdb_semantic-route`, `_context-synthesize`
- **Causal** — `agentdb_causal-edge` (graph-node backend with bridge fallback)
- **Lifecycle** — `agentdb_health`, `_controllers`, `_session-start`, `_session-end`
- **Bulk** — `agentdb_batch` (≤500 entries), `_consolidate`
- **Quality** — `agentdb_feedback`
## Important: namespace handling
Namespace strings apply to `memory_*` and `embeddings_search` only. The `agentdb_hierarchical-*`, `agentdb_pattern-*`, and `agentdb_causal-edge` tools route by **tier** or **controller**, not namespace. Don't pass `namespace: 'foo'` to those tools — it will be silently ignored. See plugin README "Namespace convention".
## Operational fallbacks (branch on these)
- `controller: 'memory-store-fallback'` — pattern persisted via `memory_store --namespace pattern`. NOT a failure.
- `_graphNodeBackend: true` — causal-edge handled by `@ruvector/graph-node`.
- `success: false, error: '...Use memory_store/memory_search instead.'` — bridge unavailable; switch to `memory_*` tools per the README replacement table.
## CLI alternative
```bash
npx @claude-flow/cli@latest memory search --query "your query" --namespace patterns
npx @claude-flow/cli@latest memory store --key "key" --value "value" --namespace patterns
npx @claude-flow/cli@latest memory list --namespace patterns
```
Sections and files
Listed in source order.
sections -> When to use → Steps → Available controller groups → Important: namespace handling → Operational fallbacks (branch on these) → CLI alternative
terms -> Check health · Start session · Store knowledge · Recall knowledge · Search patterns · Synthesize context · Build causal graph · Hierarchical
files/cmd -> agentdb_* · mcp__claude-flow__agentdb_health · available: true · mcp__claude-flow__agentdb_session-start · mcp__claude-flow__agentdb_hierarchical-store · working|episodic|semantic · mcp__claude-flow__agentdb_hierarchical-recall · mcp__claude-flow__agentdb_pattern-search
body sha256 -> 72f5f3035f1f
When to use
When you need to store, retrieve, or search knowledge across agent sessions. AgentDB provides hierarchical storage, causal knowledge graphs, semantic routing, and context synthesis.
Steps
Check health —
mcp__claude-flow__agentdb_health. Sanity-checkavailable: true. Start session —mcp__claude-flow__agentdb_session-startif not already active. Store knowledge —mcp__claude-flow__agentdb_hierarchical-storefor structured tier-keyed data (tiers:working|episodic|semantic). Recall knowledge —mcp__claude-flow__agentdb_hierarchical-recallwith a query. Search patterns —mcp__claude-flow__agentdb_pattern-searchfor learned patterns (ReasoningBank-routed).Available controller groups
Call
mcp__claude-flow__agentdb_controllersto list the runtime registry. Functional categories surfaced via the 15 MCP tools: Hierarchical —agentdb_hierarchical-store,_recall(tier-routed) Pattern —agentdb_pattern-store,_search(ReasoningBank-routed) Semantic —agentdb_semantic-route,_context-synthesizeCausal —agentdb_causal-edge(graph-node backend with bridge fallback)Important: namespace handling
Namespace strings apply to
memory_*andembeddings_searchonly. Theagentdb_hierarchical-*,agentdb_pattern-*, andagentdb_causal-edgetools route by tier or controller, not namespace. Don't passnamespace: 'foo'to those tools — it will be silently ignored. See plugin README "Namespace convention".Operational fallbacks (branch on these)
controller: 'memory-store-fallback'— pattern persisted viamemory_store --namespace pattern. NOT a failure._graphNodeBackend: true— causal-edge handled by@ruvector/graph-node.success: false, error: '...Use memory_store/memory_search instead.'— bridge unavailable; switch tomemory_*tools per the README replacement table.