gh-cwensel-arcaneum/commands/search.md

description, argument-hint

description	argument-hint
Search across collections	<semantic|text> <query> [options]

Search your indexed content using vector-based semantic search or keyword-based full-text search.

Subcommands:

• semantic: Vector-based semantic search (Qdrant)
• text: Keyword-based full-text search (MeiliSearch)

Common Options:

• --limit: Number of results to return (default: 10)
• --offset: Number of results to skip for pagination (default: 0)
• --filter: Metadata filter (key=value or JSON)
• --json: Output in JSON format
• --verbose: Show detailed information

Semantic Search Options:

• --collection: Collection to search (required)
• --vector-name: Vector name (auto-detected if not specified)
• --score-threshold: Minimum similarity score

Full-Text Search Options:

• --index: MeiliSearch index name (required)

Examples:

# Basic semantic search
/search semantic "authentication logic" --collection MyCode --limit 5

# Full-text keyword search
/search text "def authenticate" --index MyCode-fulltext

# Search with score threshold
/search semantic "fraud detection patterns" --collection PDFs --score-threshold 0.7

# Pagination: Get second page of results
/search semantic "machine learning" --collection Papers --limit 10 --offset 10

# Pagination: Get third page with JSON output
/search semantic "neural networks" --collection Papers --limit 10 --offset 20 --json

Execution:

cd ${CLAUDE_PLUGIN_ROOT}
arc search $ARGUMENTS

When to Use Each:

Semantic Search (vector-based):

• Finding conceptually similar code/documents
• Cross-language semantic matching
• "What does this" or "How to" questions
• Fuzzy concept matching

Full-Text Search (keyword-based):

• Exact keyword or phrase matching
• Function/variable name search
• Quoted phrase search
• Boolean operators (AND, OR, NOT)

Result Format:

Both commands show:

• Relevance score (similarity for semantic, rank for text)
• Source file path
• Matching content snippet
• Metadata (git info for code, page numbers for PDFs)

Related Commands:

• /collection list - See available collections
• /index pdf - Index PDFs for searching
• /index code - Index code for searching

Implementation:

• RDR-007: Semantic search via Qdrant
• RDR-012: Full-text search via MeiliSearch
• RDR-006: Claude Code integration