주요 특징

• CLI를 매번 포크하지 않는 것이 성능의 핵심입니다. FileFinder.create()를 한 번 호출해 파일 트리를 걷고 .gitignore를 파싱해 두면 이후 모든 검색이 따뜻한 메모리에 바로 적중합니다. 대가는 상주 메모리로, 콘텐츠 색인이 파일당 약 360바이트라 10만 파일 저장소에서 약 36MB, 1.4만 파일 저장소에서 약 26MB를 씁니다. 이 정도도 부담이면 익명 RAM 대신 메모리 맵 파일로 색인을 옮길 수 있습니다.
• 퍼지 매칭 알고리즘이 fzf보다 오타에 관대합니다. 경로 점수는 Smith-Waterman 방식으로 매기고 SIMD로 가속하며, 스마트 케이스 검색이 0건을 반환하면 자동으로 퍼지로 재시도합니다. 제약 조건을 붙이는 질의 언어도 있어 '*.rs !test/ shcema' 처럼 확장자와 제외 경로에 오타 섞인 단어를 함께 던져도 결과가 나옵니다. 여기에 실제로 자주 여는 파일을 위로 올리는 frecency 랭킹이 겹칩니다.
• MCP 서버를 내장해 Claude Code, Codex, OpenCode, Cursor, Cline 등 MCP를 지원하는 클라이언트에 ffgrep, fffind, fff-multi-grep 도구로 붙습니다. 코드 정의처럼 보이는 줄은 Rust 쪽에서 미리 분류해 넘겨 주므로 프롬프트에 정규식 부담을 얹지 않고, 수정·스테이징·미추적 상태가 결과에 태그로 달려 에이전트가 지금 건드리는 파일을 먼저 집습니다. 설치는 원라인 스크립트나 brew install dmtrKovalenko/fff/fff-mcp로 끝납니다.
• 같은 Rust 코어를 네 가지 얇은 층으로 노출합니다. 네이티브 크레이트 fff-search, ABI가 고정된 C 공유 라이브러리 libfff_c, TypeScript Result 패턴을 쓰는 Node/Bun SDK @ff-labs/fff-node, PyO3 기반에 abi3 휠로 배포되는 파이썬 패키지 fff-search가 그것입니다. 여기에 Neovim 플러그인 fff.nvim과 Pi 에이전트 확장 @ff-labs/pi-fff가 얹히며, Pi 확장은 도구만 주입할지 기본 grep·find를 대체할지 /fff-mode로 실행 중에 바꿉니다.
• 내부 구현은 반복 검색에 맞춰 설계돼 있습니다. OR 다중 패턴은 Aho-Corasick으로 처리하고, grep은 SIMD memmem 기반 평문·정규식·퍼지 세 모드로 나뉘며 정확 매치가 없을 때만 퍼지로 내려갑니다. libgit2를 물린 백그라운드 워처가 변경분만 재색인하고, git touch 이력에서 워밍업하기 때문에 전체 재스캔 없이 바로 순위가 잡힙니다. 커서 페이지네이션이 호출 사이에도 유지되는 점은 ripgrep에 없는 부분입니다.