Repolode
junegunn

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. 1

    Homebrew로 fzf 설치하기

    brew install fzf
  2. 2

    셸 설정 파일에 다음을 추가해 bash용 셸 통합(키 바인딩 및 퍼지 완성)을 설정하기

    eval "$(fzf --bash)"
  3. 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 통계는 매일 갱신됩니다.

관련 프로젝트