93 lines
2.3 KiB
Markdown
93 lines
2.3 KiB
Markdown
---
|
|
description: Search across collections
|
|
argument-hint: <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:**
|
|
|
|
```text
|
|
# 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:**
|
|
|
|
```bash
|
|
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
|