semsearch 1.1.2

Search your filesystem semantically.
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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

# semsearch

Semantic code search that just works. Ask questions in plain English, get ranked file locations.

## Usage

```bash
semsearch "find the authentication handler"
```

Auto-indexes on first run, caches for instant subsequent searches.

## Options

```
semsearch [OPTIONS] [QUERY]

Arguments:
  [QUERY]  Natural language search query

Options:
  -n, --limit <N>   Max results (default: 10)
  -p, --path <DIR>  Project path (default: walks up to .git)
      --json        Output as JSON
      --reindex     Force full reindex
      --stats       Show index statistics
  -v, --verbose     Show progress even when cached
  -h, --help        Print help
```

## Examples

```bash
# Search current project
semsearch "error handling logic"

# JSON output for scripting
semsearch --json "database queries" | jq '.[] | .path'

# Search specific directory
semsearch -p /path/to/project "API endpoints"

# Check index status
semsearch --stats
```

## Output

Human-readable (default):
```
src/auth.rs:42                     0.89  pub async fn validate_token...
src/handlers/login.rs:1            0.82  //! Login and authentication...
```

JSON (`--json`):
```json
[
  {"path": "src/auth.rs", "line": 42, "score": 0.89, "snippet": "..."},
  ...
]
```

## How It Works

1. Detects project root (walks up to `.git`)
2. Indexes all text files via [fsindex](https://crates.io/crates/fsindex)
3. Chunks content, embeds with BGE-small-en-v1.5 via [fastembed](https://crates.io/crates/fastembed)
4. Stores vectors in [usearch](https://crates.io/crates/usearch) index
5. Caches at `~/.cache/semsearch/<project-hash>/`
6. Incremental updates on file changes

## Install

```bash
cargo install --path .
```

## License

None (unpublished)