> ## Documentation Index
> Fetch the complete documentation index at: https://gitquarry.micr.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Recipes

> Copy-paste search patterns for native GitHub-like search, discover mode, structured filters, and scripting.

# Search Recipes

These are practical starting points for common search jobs.

## Plain Native Search

```bash theme={null}
gitquarry search "rust cli"
gitquarry search "vector database"
```

This keeps search behavior close to native GitHub repository search.

## Native Search With Structured Filters

```bash theme={null}
gitquarry search "vector database" --language rust --sort stars
gitquarry search "release automation" --topic cli --updated-within 30d
gitquarry search "sdk" --org vercel --min-stars 100
```

## Discover Mode For Better Coverage

```bash theme={null}
gitquarry search "release automation" --mode discover
gitquarry search "graphql client" --mode discover --rank activity
gitquarry search --mode discover --topic cli --updated-within 30d --limit 5
```

## README-Aware Discovery

```bash theme={null}
gitquarry search "developer portal" \
  --mode discover \
  --rank blended \
  --readme \
  --explain
```

Use this when naming and repo metadata are not enough to separate candidates.

## Quality-Oriented Ranking

```bash theme={null}
gitquarry search "rust orm" --mode discover --rank quality --limit 10
```

## Activity-Oriented Ranking

```bash theme={null}
gitquarry search "rust lsp" --mode discover --rank activity --updated-within 90d
```

## Explicit Blended Weights

```bash theme={null}
gitquarry search "graphql client" \
  --mode discover \
  --rank blended \
  --weight-query 1.5 \
  --weight-activity 0.8 \
  --weight-quality 1.2
```

## Host-Specific Search

```bash theme={null}
gitquarry --host https://ghe.example.com search "internal platform"
```

## JSON And CSV Recipes

```bash theme={null}
gitquarry search "rust cli" --format json
gitquarry search "rust cli" --format compact
gitquarry search "rust cli" --format csv
```

## Checked-In TOML Recipes

Use `recipe run` when a search should be reviewed and reused from a repo, docs page, CI job, or runbook.

```toml theme={null}
# .gitquarry/recipes/rust-cli.toml
query = "rust cli"
language = ["rust"]
topic = ["cli"]
sort = "stars"
limit = 20
format = "json"
progress = "off"
```

```bash theme={null}
gitquarry recipe run .gitquarry/recipes/rust-cli.toml
```

## Conflict Example To Avoid

This fails because the raw query qualifier overlaps a structured flag:

```bash theme={null}
gitquarry search "language:rust" --language go
```

If you want structured filtering, keep the qualifier out of the free-text query.