| name | bm25-search |
| description | 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.
|
BM25 Keyword Search Skill
Fast full-text keyword search using BM25 scoring in the agent-memory system.
When to Use
| Use Case | Best Search Type |
|---|
| Exact keyword match | BM25 (teleport search) |
| Function/variable names | BM25 (exact terms) |
| Error messages | BM25 (specific phrases) |
| Technical identifiers | BM25 (case-sensitive) |
| Conceptual similarity | Vector search instead |
When Not to Use
- Conceptual/semantic queries (use vector search)
- Synonym-heavy queries (use hybrid search)
- Current session context (already in memory)
- Time-based navigation (use TOC directly)
Quick Start
| Command | Purpose | Example |
|---|
teleport search | BM25 keyword search | teleport search "ConnectionTimeout" |
teleport stats | BM25 index status | teleport stats |
teleport rebuild | Rebuild index | teleport rebuild --force |
Prerequisites
memory-daemon status
memory-daemon start
BM25 Search
Basic Usage
memory-daemon teleport search "JWT token"
memory-daemon teleport search "authentication" \
--top-k 10 \
--target toc
memory-daemon teleport search "\"connection refused\""
Query Syntax
| Pattern | Example | Matches |
|---|
| Single term | JWT | All docs containing "JWT" |
| Multiple terms | JWT token | Docs with "JWT" AND "token" |
| Phrase | "JWT token" | Exact phrase "JWT token" |
| Prefix | auth* | Terms starting with "auth" |
Error Handling
| Error | Resolution |
|---|
| Connection refused | memory-daemon start |
| BM25 index unavailable | teleport rebuild or wait for build |
| No results | Check spelling, try broader terms |
| Slow response | Rebuild index or check disk |
See Command Reference for full CLI options.
