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