// Semantic vector search for agent-memory. Use when asked to "find similar discussions", "semantic search", "find related topics", "what's conceptually related to X", or when keyword search returns poor results. Provides vector similarity search and hybrid BM25+vector fusion.
| name | vector-search |
| description | Semantic vector search for agent-memory. Use when asked to "find similar discussions", "semantic search", "find related topics", "what's conceptually related to X", or when keyword search returns poor results. Provides vector similarity search and hybrid BM25+vector fusion. |
Semantic similarity search using vector embeddings in the agent-memory system.
| Use Case | Best Search Type |
|---|---|
| Exact keyword match | BM25 (teleport search) |
| Conceptual similarity | Vector (teleport vector-search) |
| Best of both worlds | Hybrid (teleport hybrid-search) |
| Typos/synonyms | Vector or Hybrid |
| Technical terms | BM25 or Hybrid |
| Command | Purpose | Example |
|---|---|---|
teleport vector-search | Semantic search | teleport vector-search -q "authentication patterns" |
teleport hybrid-search | BM25 + Vector | teleport hybrid-search -q "JWT token handling" |
teleport vector-stats | Index status | teleport vector-stats |
memory-daemon status # Check daemon
memory-daemon start # Start if needed
# Simple semantic search
memory-daemon teleport vector-search -q "authentication patterns"
# With filtering
memory-daemon teleport vector-search -q "debugging strategies" \
--top-k 5 \
--min-score 0.6 \
--target toc
Combines BM25 keyword matching with vector semantic similarity using Reciprocal Rank Fusion (RRF).
# Default hybrid mode (50/50 weights)
memory-daemon teleport hybrid-search -q "JWT authentication"
# Favor vector semantics
memory-daemon teleport hybrid-search -q "similar topics" \
--bm25-weight 0.3 \
--vector-weight 0.7
# Favor keyword matching
memory-daemon teleport hybrid-search -q "exact_function_name" \
--bm25-weight 0.8 \
--vector-weight 0.2
User Query
|
v
+-- Contains exact terms/function names? --> BM25 Search
|
+-- Conceptual/semantic query? --> Vector Search
|
+-- Mixed or unsure? --> Hybrid Search (default)
| Error | Resolution |
|---|---|
| Connection refused | memory-daemon start |
| Vector index unavailable | Wait for index build or check disk space |
| No results | Lower --min-score, try hybrid mode, broaden query |
| Slow response | Reduce --top-k, check index size |
See Command Reference for full CLI options.
BM25 keyword search for agent-memory. Use when asked to "find exact terms", "keyword search", "search for specific function names", "locate exact phrase", or when semantic search returns too many results. Provides fast BM25 full-text search via Tantivy index.
Query past conversations from the agent-memory system. Use when asked to "recall what we discussed", "search conversation history", "find previous session", "what did we talk about last week", or "get context from earlier". Provides tier-aware retrieval with automatic fallback chains, intent-based routing, and full explainability. Includes command-equivalent instructions for search, recent, and context operations.
Agent retrieval policy for intelligent memory search. Use when implementing memory queries to detect capabilities, classify intent, route through optimal layers, and handle fallbacks. Provides tier detection, intent classification, fallback chains, and full explainability for all retrieval operations.
Topic graph exploration for agent-memory. Use when asked to "explore topics", "show related concepts", "what themes have I discussed", "find topic connections", or "discover patterns in conversations". Provides semantic topic extraction with time-decayed importance scoring.
Wizard-style configuration guidance for a single-agent agent-memory setup. Shows defaults inline, provides a full sample config, and includes a dry-run config check step. Always confirm before creating or editing files.
Wizard-style installation guide for agent-memory (macOS/Linux). Helps users choose an install path, check prerequisites, and set PATH. Always confirm before any file edits or copying binaries. Provide verification commands only.