junegunn/fzf
입력 목록을 대화형으로 필터링하고, 셸 스크립트를 인터랙티브한 터미널 선택기로 바꿔 주는 범용 CLI 퍼지 파인더입니다.
- 스타
- 83,703
- 포크
- 5,336
- 열린 이슈
- 336
- 마지막 커밋
- 12시간 전
어떤 프로젝트인가요?
fzf는 표준 입력에서 목록을 읽고, 퍼지 검색어를 입력해 대화형으로 범위를 좁히면 선택한 항목을 표준 출력으로 내보냅니다. 어떤 텍스트 스트림이든 처리할 수 있어 파일, 명령어 기록, 프로세스 목록, git 브랜치 등 파이프로 전달할 수 있는 모든 출력에 사용할 수 있습니다.
단순한 선택 기능 외에도 포커스된 항목을 대상으로 명령어를 실행하는 미리보기 창, 다중 선택 모드, 키 바인딩 설정 기능을 제공합니다. 전체 화면, 커서 아래의 높이 제한 영역, tmux/Zellij 팝업 같은 표시 모드도 지원합니다. 단일 바이너리로 제공되며 Bash, Zsh, Fish, Nushell용 셸 통합 기능을 통해 CTRL-T와 CTRL-R 같은 키 바인딩 및 퍼지 탭 완성을 사용할 수 있습니다.
목록 새로 고침, 외부 프로그램 실행, 다른 프로세스로 교체 등의 작업을 수행하는 이벤트 기반 액션 시스템도 제공해 맞춤형 터미널 인터페이스를 만들 수 있습니다. Vim과 Neovim 통합 기능은 별도 플러그인으로 제공됩니다.
핵심 기능
- 01표준 입력에서 줄 단위로 된 모든 입력을 읽고 퍼지 매칭으로 필터링합니다.
- 02정확 일치, 접두사, 접미사, 역방향 매칭을 지원하는 확장 검색 문법을 제공합니다.
- 03포커스된 항목을 대상으로 명령어를 실행하는 미리보기 창을 제공합니다.
- 04전체 화면, 높이 제한, tmux/Zellij 팝업 표시 모드를 지원합니다.
- 05Bash, Zsh, Fish, Nushell과 통합해 명령어 기록 검색과 경로 자동 완성을 지원합니다.
- 06Linux, macOS, Windows 패키지 관리자에서 단일 바이너리로 배포됩니다.
활용 사례
- 퍼지 선택기로 터미널에서 파일을 빠르게 찾아 엽니다.
- 기록을 스크롤하는 대신 CTRL-R로 셸 명령어 기록을 검색합니다.
- 셸 스크립트 안에 대화형 선택 메뉴를 만듭니다.
- 실시간 미리보기를 보며 git 브랜치, 프로세스 또는 로그 출력을 탐색합니다.
빠른 시작
- 1
Homebrew로 fzf 설치하기
brew install fzf - 2
셸 설정 파일에 다음을 추가해 bash용 셸 통합(키 바인딩 및 퍼지 완성)을 설정하기
eval "$(fzf --bash)" - 3
fzf를 실행해 대화형 검색기 시작하기
fzf
토픽
자주 묻는 질문
- fzf은(는) 무엇인가요?
- 입력 목록을 대화형으로 필터링하고, 셸 스크립트를 인터랙티브한 터미널 선택기로 바꿔 주는 범용 CLI 퍼지 파인더입니다. fzf는 표준 입력에서 목록을 읽고, 퍼지 검색어를 입력해 대화형으로 범위를 좁히면 선택한 항목을 표준 출력으로 내보냅니다. 어떤 텍스트 스트림이든 처리할 수 있어 파일, 명령어 기록, 프로세스 목록, git 브랜치 등 파이프로 전달할 수 있는 모든 출력에 사용할 수 있습니다.
- fzf은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- fzf은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- fzf은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. fzf의 마지막 커밋은 2026년 10월 20일입니다.
- fzf은(는) 어디에 사용할 수 있나요?
- 퍼지 선택기로 터미널에서 파일을 빠르게 찾아 엽니다. 기록을 스크롤하는 대신 CTRL-R로 셸 명령어 기록을 검색합니다. 셸 스크립트 안에 대화형 선택 메뉴를 만듭니다. 실시간 미리보기를 보며 git 브랜치, 프로세스 또는 로그 출력을 탐색합니다.
- fzf는 어떻게 설치하나요?
- Homebrew로 fzf 설치하기: brew install fzf 셸 설정 파일에 다음을 추가해 bash용 셸 통합(키 바인딩 및 퍼지 완성)을 설정하기: eval "$(fzf --bash)" fzf를 실행해 대화형 검색기 시작하기: fzf
- fzf은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/junegunn/fzf
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
자주 찾는 디렉터리를 학습해 몇 번의 키 입력으로 이동하는 더 똑똑한 cd 명령어
사용자별·셸별로 여러 Node.js 버전을 설치하고 전환할 수 있는 POSIX 호환 bash 스크립트입니다.
Warp는 내장 코딩 에이전트나 직접 선택한 CLI 에이전트를 지원하는, 터미널 기반의 에이전트형 개발 환경입니다.
안전한 인자 이스케이프와 크로스 플랫폼 헬퍼를 제공하는, 셸 스타일 스크립트 작성용 JavaScript 기반 도구입니다.