38 lines
1.4 KiB
Markdown
38 lines
1.4 KiB
Markdown
---
|
|
name: opty
|
|
description: Semantic code search using HDC (Hyperdimensional Computing). Finds functions, types, imports, and variables in the indexed codebase by meaning. Use when searching for code by concept — e.g. "error handling functions", "database types", "authentication flow".
|
|
compatibility: Requires opty CLI and a running daemon. Install from source or binary.
|
|
allowed-tools: Bash(opty:*)
|
|
---
|
|
|
|
# Opty — HDC Code Search
|
|
|
|
Semantic code search via Hyperdimensional Computing. Indexes the codebase and finds relevant functions, types, and imports by meaning rather than exact text. The daemon auto-starts when you run any opty command.
|
|
|
|
## Query
|
|
|
|
```bash
|
|
opty query "natural language description of what you're looking for"
|
|
```
|
|
|
|
Output is TOON format — compact, LLM-optimized:
|
|
```
|
|
functions[N]{name,signature,file,line}:
|
|
functionName,signature,path/to/file.ts,42
|
|
...
|
|
```
|
|
|
|
## Other Commands
|
|
|
|
```bash
|
|
opty status # Show indexed file/unit count and watched directory
|
|
opty reindex # Force re-scan after major file changes or stale results
|
|
```
|
|
|
|
## Tips
|
|
|
|
- Query by concept, not exact names: `"connection pool exhaustion"` not `"ConnectionPoolError"`
|
|
- Results include file + line number — use `read` to get the actual code
|
|
- `opty status` shows which directory is indexed (the daemon is per-project)
|
|
- After large refactors, run `opty reindex` if results seem stale
|