Skip to content

[Suggestion]: Adjust repository structure #596

@wpenistone

Description

@wpenistone

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/

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions