Which fff frontend(s)?
Core or Rust crate
What problem are you trying to solve?
Right now fff has several useful entry points and packages, but the repo structure does not yet make the larger shape obvious or usable enough.
This is mostly about structure, atomicity, maintainability, distribution, and discoverability, a clearer monorepo shape would make those features and sub-crates easier to reuse as fff adds richer features, document, package, and find.
Proposed solution
Suggested shape:
crates/
fff-core/
fff-query-parser/
fff-grep/
fff-mcp/
fff-nvim/
fff-c/
packages/
fff-node/
pi-fff/
fff-bin-*/ platform binary packages
lua/
fff/
docs/
agent/
neovim/
sdk/
distribution/
query-language/
capabilities/
examples/ (optional, but good for SDK inspirations)
node-agent-tool/
rust-cli/
c-ffi-minimal/
mcp-client/
neovim-programmatic-search/
....
schemas/ (later on...)
capabilities.json
query.schema.json
result.schema.json
distribution/
homebrew/
winget/
nix/
install-scripts/
checksums/
Which fff frontend(s)?
Core or Rust crate
What problem are you trying to solve?
Right now fff has several useful entry points and packages, but the repo structure does not yet make the larger shape obvious or usable enough.
This is mostly about structure, atomicity, maintainability, distribution, and discoverability, a clearer monorepo shape would make those features and sub-crates easier to reuse as fff adds richer features, document, package, and find.
Proposed solution
Suggested shape: