---
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