dotfiles/pi/.pi/agent/skills/opty/SKILL.md

name, description, compatibility, allowed-tools

name	description	compatibility	allowed-tools
opty	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".	Requires opty CLI and a running daemon. Install from source or binary.	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

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

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