Recon without floods
fs, ftree, fsearch, fcontent return ranked, capped, structured results. No 10,000-line grep dumps. No walking entire directory trees to find one file.
fsuite
Deploy the drones. Map the terrain. Return with intel.
What is fsuite?
Section titled “What is fsuite?”fsuite is fourteen command-line tools built for AI coding agents. It is the answer to one question: what would you give an LLM if you actually wanted it to find, read, and edit code without burning its context on irrelevant junk?
The tools replace the native filesystem and shell primitives every agent reaches for by default — grep, find, cat, sed, bash — with bounded, structured, token-budgeted alternatives that know how to cap their output, rank their results, and hand back exactly the slice of the repo that matters.
The four things it fixes
Section titled “The four things it fixes”Reading without guessing
fread --symbol NAME reads exactly one function by name. fread --lines 120:150 reads an exact range. fmap extracts the symbol skeleton before you even open a file.
Editing without ambiguity
fedit --lines 120:124 replaces exact line ranges. fedit --function_name foo scopes edits to a symbol without needing huge unique context strings. No more failed matches on whitespace drift.
Continuity across sessions
fcase is an investigation ledger. Track findings, evidence, and handoff state so the next agent (or the next you) starts with context, not from zero.
The fourteen tools
Section titled “The fourteen tools”| Tool | Purpose |
|---|---|
fs | Universal search orchestrator — auto-routes your query to the right tool |
ftree | Territory scout — full tree + recon data in one call |
fls | Structured directory listing with recon mode |
fsearch | File / glob discovery |
fcontent | Bounded content search (token-capped ripgrep) |
fmap | Symbol cartography — functions, classes, imports |
fread | Budgeted reading with symbol & line-range resolution |
fedit | Surgical editing (line-range, symbol-scoped, anchor-based) |
fwrite | Atomic file creation |
fbash | Token-budgeted shell with classification + session state |
fcase | Investigation continuity ledger |
freplay | Derivation chain replay |
fprobe | Binary / bundle inspection + patching |
fmetrics | Telemetry analytics + tool-chain prediction |
Why it exists
Section titled “Why it exists”fsuite was always supposed to be CLI-first. The MCP server came later, the hooks came later, and the whole thing is still catching up to the lightbulb moment that probably should have come first.