@dsh-pi/fff
pi-style frecency-ranked search tools for DeepSeek Harness (dsh-pi).
Registers two tools on ctx.tools, powered by the FFF engine (@ff-labs/fff-node, native Rust core):
ffgrep — grep file contents. Smart-case, auto-detects regex vs literal. Results ranked by frecency (most-accessed files first); matches within a file stay in source order.fffind — fuzzy, typo-resistant file search by name pattern. Frecency-ranked.
The FFF engine's frecency DB is persisted per workspace under $DSH_HOME/dsh-pi/fff-<workspace>.db, so access rankings build up across sessions — same behavior as pi's ffgrep/fffind (from @ff-labs/pi-fff).
Install into a profile
dsh plugin --profile web add @dsh-pi/fff # published, or:
dsh plugin --profile web add file:/abs/path/to/dsh-pi-fff
The bundle auto-registers in the profile manifest (adds a dsh-pi-tools row mounting the plugin). Restart the profile (dsh web / dsh --profile <name>).
Requirements
- dsh ≥ 0.1.0-rc.6 (provides
@deepseek-ai/dsh-tools in the profile's module tree)
- The plugin resolves
@deepseek-ai/dsh-tools from the profile node_modules; @ff-labs/fff-node (+ its platform binary) is installed as a dependency.
Tool parameters
ffgrep: pattern (required) · path (default: session workspace) · limit (default 20)
fffind: pattern (required) · path (default: session workspace) · limit (default 30)
Output matches pi-fff's format: per-file blocks in frecency order, path:line: content,
with [VERY often touched file] / [often touched file] annotations for hot files.
Layout
| File | Role |
|---|
index.js | Cordis plugin (registers ffgrep + fffind via defineTool) |
cordis.patch.yml | bundle patch — inserts the dsh-pi-tools row |
package.json | declares dsh.bundle.patch + @ff-labs/fff-node dependency |
License
MIT
