Fff

이 프로그램의 특징

Fff는 파일 검색을위한 강력한 SDK 및 라이브러리입니다. 단순한 CLI 도구가 아니라, 여러 프로세스가 오랜 시간 동안 실행될 때 성능을 극대화하도록 설계된 시스템입니다. 특히 AI 코딩 에이전트와 같이 수백 번의 검색을 반복하는 환경에서 유용합니다.

• 고속 인메모리 검색: 파일 인덱스와 캐시를 프로세스 메모리에 상주시켜 불필요한 디스크 I/O를 제거합니다.
• 주파수 기반 랭킹: 실제로 자주 사용되는 파일을 상단에 표시하는 frecency(빈도+최근성) 기능을 포함합니다.
• 병렬 처리 및 정밀 검색: 오타에 강한 경로 및 콘텐츠 검색, 정의 탐지(Detection), 백그라운드 감시자(Watcher) 기능을 제공합니다.

Neovim 플러그인 및 확장 기능

Fff는 Neovim을 위한 강력한 파일 탐색 플러그인으로도 잘 알려져 있습니다. 기본 제공되는 도구보다 더 빠르고 직관적인 쿼리를 제공하며, Git 상태에 따른 파일 색상 태깅이나 콘텐츠 미리보기 같은 고급 기능을 지원합니다.

• 빈번한 파일 탐색: 자주 쓰는 파일이 상단에 랭크됩니다.
• 다양한 검색 모드: 일반(Plain), 정규식(Regex), 퍼지(Fuzzy) 모드를 제공하며, 대소문자를 자동으로 감지합니다.
• Git 통합: 수정된 파일, 추적되지 않은 파일, staged 파일을 표시합니다.

AI 에이전트 및 개발 환경 통합

이 프로젝트는 AI 코딩 에이전트용 MCP 서버와 같은 고급 통합 기능을 제공합니다. 이를 통해 Claude Code, Codex, OpenCode 등 다양한 AI 클라이언트와 원활하게 협업할 수 있습니다.

• MCP 서버 지원: AI 에이전트가 토큰 효율적이고 빠르게 파일 검색을 수행할 수 있게 돕습니다.
• 다양한 언어 바인딩: Rust, C, Python, NodeJS(Bun), Lua(Neovim) 등 다양한 환경에서 라이브러리로 사용할 수 있습니다.

설치 및 기본 사용법

Fff는 여러 환경에서 쉽게 설치하고 사용할 수 있도록 설계되었습니다. 각 환경에 맞는 패키지 관리자나 빌드 도구를 지원합니다.

• MCP 서버 설치: Linux/macOS에서는 curl 명령어를, Windows PowerShell에서는 irm 명령어를 사용하여 간단히 설치할 수 있습니다.
• Neovim 플러그인 설치: lazy.nvim 패키지 매니저를 사용하여 ‘dmtrKovalenko/fff’ 패키지를 설치하면 자동으로 바이너리가 다운로드됩니다.
• Python 사용법: ‘pip install fff-search’로 설치 후, FileFinder 클래스를 통해 동기 또는 비동기 방식으로 검색을 실행할 수 있습니다.

이런 경우에 유용합니다

• AI 코딩 에이전트 개발: Claude Code나 Codex 같은 AI 도구의 파일 검색 성능을 향상시키고 토큰 사용량을 줄이고 싶을 때.
• 대규모 코드베이스 작업: 리눅스 커널이나 대규모 프로젝트에서 수만 개의 파일을 빠르게 탐색해야 할 때.
• Neovim 사용자: 기존 파일 탐색기보다 더 빠르고 직관적인 검색 환경을 원할 때.
• 커스텀 도구 개발: Rust, C, Python 등 다양한 언어에서 파일 검색 기능을 자신의 앱이나 스크립트에 통합해야 할 때.

화면으로 보는 주요 기능

Opus 4.6 성능 비교 그래프

Wall time(초)에 따른 토큰 입력 및 출력 수를 보여주는 그래프입니다. 파란색 선은 'Claude Code native tools'를, 갈색 선은 'fff tools with memory'를 나타내며, fff 도구 사용 시 토큰 소비가 현저히 줄어드는 것을 보여줍니다.