search-memory

name	search-memory
description	Search semantic memory across all embedded content (memory, posts, issues, audit). Use when the user says "what do I know about", "search memory for", "recall", "find references to", or asks open-ended questions about prior context.

Search Memory

Vector-search across the unified embeddings table (poindexter_brain.embeddings — ~25K rows spanning posts, memory files, issues, audit log, brain decisions, claude_sessions). Returns the top hits with similarity scores so the agent can decide how confidently to surface them.

Backed by the worker's /api/memory/search endpoint, which fronts MemoryClient.search (pgvector cosine similarity over nomic-embed-text:768 embeddings).

Usage

scripts/run.sh "<query>" [limit] [min_similarity]

Parameters

• query (string, required): natural-language search query
• limit (int, optional, default 5): top-N results to return
• min_similarity (float, optional, default 0.5): drop hits below this threshold (0..1)

Output

Plain-text summary of hits, one per line, prefixed with [similarity] [source_table] source_id. Suitable for direct TTS readback in voice contexts.

Example

> scripts/run.sh "backup strategy" 3 0.5
Memory search: "backup strategy" (3 results)

1. [0.7821] [memory] feedback_backup_strategy
   Tier 1 in-stack hourly+daily, Tier 2 off-machine via restic...
2. [0.6547] [post] post_142
   Why solo founders need ruthless backup discipline...
3. [0.5912] [memory] project_disaster_recovery
   2026-05-05 incident: postgres-local volume wiped during Docker Desktop reinstall...