tapes search
Search the span projection using semantic similarity: hits are individual main-conversation LLM spans with their trace and turn context ("find the turn where X happened"). Requires a running tapes API server with span embeddings written.
Span embedding is on by default in tapes serve (disable with --embed-spans=false). To embed spans captured while embedding was off, run the embed worker (tapes serve embed-worker) or the one-shot tapes dev embed-spans backfill. Without embeddings, search returns a "span embeddings not initialized" error.
Usage
tapes search "how to deploy to production"
# Pipe the best-matching session into skill generation
tapes skill generate $(tapes search "charm CLI" --quiet --top 1) --name charm-patternsFlags
| Flag | Description |
|---|---|
-k, --top | Number of results to return (default: 5) |
--api-target | tapes API server URL (default: http://localhost:8081) |
-q, --quiet | Output only session IDs, one per line, deduplicated in score order (for piping) |
--org | Tenant org UUID sent as X-Tapes-Org-Id (default: the nil org) |
Search queries the API server. Embeddings are configured on the server, not the client.