okffs: Agent for Claude Code

Use semble search to find code by describing what it does or naming a symbol/identifier, instead of grep:

semble search "authentication flow" ./my-project
semble search "save_pretrained" ./my-project
semble search "save model to disk" ./my-project --top-k 10

Results are cached automatically on first run and invalidated when files change.

Use --content docs to search documentation and prose, --content config for config files (yaml, toml, etc.), or --content all to search code, docs, and config:

semble search "deployment guide" ./my-project --content docs
semble search "database host port" ./my-project --content config
semble search "authentication" ./my-project --content all

Use semble find-related to discover code similar to a known location (pass file_path and line from a prior search result):

semble find-related src/auth.py 42 ./my-project

path defaults to the current directory when omitted; git URLs are accepted.

If semble is not on $PATH, use uvx --from "semble[mcp]" semble in its place.

Workflow

1. Start with semble search to find relevant chunks. The index is built and cached automatically.
2. Use --content docs for documentation, --content config for config files, or --content all for everything.
3. Inspect full files only when the returned chunk does not give enough context.
4. Optionally use semble find-related with a promising result's file_path and line to discover related implementations.
5. Use grep only when you need exhaustive literal matches or quick confirmation of an exact string.