dmtrKovalenko/fff

어떤 프로젝트인가요?

핵심 기능

• 01파일 경로와 파일 콘텐츠 모두에 적용되는 오타 허용 퍼지 매칭.
• 02최근에 자주 연 파일을 상위에 표시하는 frecency 순위 지정.
• 03반복 검색을 위한 백그라운드 파일 감시기 및 인메모리 콘텐츠 인덱스.
• 04컨텍스트 줄과 커서 페이지네이션을 지원하는 glob, regex, 리터럴 검색 모드.
• 05수정됨, 스테이징됨, 추적되지 않음 파일 등의 Git 기반 필터.

활용 사례

• MCP를 통해 AI 코딩 에이전트에 빠르고 정확한 파일 및 코드 검색 기능 제공.
• Neovim의 파일 및 grep picker를 더 빠르고 순위가 적용되는 대안으로 교체.
• Node.js, Bun 또는 Rust 애플리케이션에 사용자 지정 파일 검색 기능 구축.

빠른 시작

1. 1

   Homebrew로 fff-mcp 서버를 설치합니다(macOS/Linux).

   brew install dmtrKovalenko/fff/fff-mcp
2. 2

   설치된 바이너리의 절대 경로를 사용해 Codex에 등록합니다.

   codex mcp add fff -- "$(brew --prefix)/bin/fff-mcp"
3. 3

   또는 npm에서 Pi 에이전트 확장 프로그램을 설치합니다.

   pi install npm:@ff-labs/pi-fff

사용 전 알아둘 점

• !Neovim 플러그인의 빌드 단계에서는 사전 빌드된 바이너리를 다운로드하며, 다운로드할 수 없으면 cargo로 컴파일합니다.
• !공개된 벤치마크 결과는 프로젝트에서 특정 저장소와 모델을 대상으로 측정한 것입니다.

토픽

자주 묻는 질문

fff은(는) 무엇인가요?

Neovim, AI 에이전트와 Rust·Node·Bun·Python·C 애플리케이션을 위한 빠르고 오타에 강한 파일 및 콘텐츠 검색 툴킷입니다. FFF는 오타에 강한 경로 및 콘텐츠 검색, frecency 기반 파일 순위 지정, 백그라운드 파일 감시기, 경량 인메모리 콘텐츠 인덱스를 결합한 파일 검색 툴킷입니다. 반복 검색이 필요한 장시간 실행 프로세스를 대상으로 하며, 인덱스를 메모리에 유지해 매번 검색할 때마다 ripgrep이나 fzf 같은 새 CLI를 시작하는 비용을 줄입니다.

fff은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

fff은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

fff은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. fff의 마지막 커밋은 2026년 10월 20일입니다.

fff은(는) 어디에 사용할 수 있나요?

MCP를 통해 AI 코딩 에이전트에 빠르고 정확한 파일 및 코드 검색 기능 제공. Neovim의 파일 및 grep picker를 더 빠르고 순위가 적용되는 대안으로 교체. Node.js, Bun 또는 Rust 애플리케이션에 사용자 지정 파일 검색 기능 구축.

fff는 어떻게 설치하나요?

Homebrew로 fff-mcp 서버를 설치합니다(macOS/Linux).: brew install dmtrKovalenko/fff/fff-mcp 설치된 바이너리의 절대 경로를 사용해 Codex에 등록합니다.: codex mcp add fff -- "$(brew --prefix)/bin/fff-mcp" 또는 npm에서 Pi 에이전트 확장 프로그램을 설치합니다.: pi install npm:@ff-labs/pi-fff

fff은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/dmtrKovalenko/fff