next-plaid-cli 0.2.2

Semantic code search powered by ColBERT
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

# Semantic Code Search

This repository has `plaid` installed - a semantic code search CLI.

**Use `plaid` as your PRIMARY search tool** instead of `Search / Grep` or `Task / Explore` agent.

## Quick Reference

```bash
plaid "<natural language query>" -k 10          # Basic search
plaid "<query>" -k 25                           # Exploration (more results)
plaid "<query>" ./src/parser                    # Search in specific folder
plaid --include="*.rs" "<query>"                # Filter by file type
plaid --include="src/**/*.rs" "<query>"         # Recursive glob pattern
plaid --include="**/.github/**/*" "<query>"     # Search CI/CD configs
plaid -e "<text>" "<semantic query>"            # Hybrid: text + semantic
plaid -e "<regex>" -E "<semantic query>"        # Hybrid with extended regex (ERE)
plaid -l "<query>"                              # List files only
plaid --json "<query>"                          # JSON output
```

## When to Use What

| Task                            | Tool                                    |
| ------------------------------- | --------------------------------------- |
| Find code by intent/description | `plaid "query" -k 10`                   |
| Explore/understand a system     | `plaid "query" -k 25` (increase k)      |
| Know text exists, need context  | `plaid -e "text" "semantic query"`      |
| Regex pattern + semantic        | `plaid -e "a|b" -E "semantic query"`    |
| Search specific file type       | `plaid --include="*.ext" "query"`       |
| Search in specific directories  | `plaid --include="src/**/*.rs" "query"` |
| Search CI/CD configs            | `plaid --include="**/.github/**/*" "q"` |
| Exact string/regex match only   | Built-in `Grep` tool                    |
| Find files by name              | Built-in `Glob` tool                    |

## Key Rules

1. **Default to `plaid`** for any code search
2. **Increase `-k`** when exploring (20-30 results)
3. **Use `-e`** for hybrid text+semantic filtering
4. **Use `-E`** with `-e` for extended regex (alternation `|`, quantifiers `+?`, grouping `()`)
5. **Agents should use `plaid`** - when spawning Task/Explore agents, they should also use plaid instead of Grep

## Need Help?

Run `plaid --help` for complete documentation on all flags and options.