fzf-git.sh, tmux에 PR 번호 입력 기능 추가…AI 코딩 도구서 활용

터미널 검색 도구 fzf의 개발자가 제공하는 Git 보조 스크립트 ‘fzf-git.sh’에 tmux에서 GitHub 풀 리퀘스트(PR) 번호를 골라 입력하는 기능이 추가됐다. 개발자 공식 GitHub 변경 이력에 따르면 17일(한국시간) 반영된 기능은 별도 스크립트 pr.fzf가 실행 경로에 있을 때 작동한다.

개발자가 공개한 AI 코딩 에이전트 활용 문서는 Claude Code나 Codex에 파일 경로나 커밋 해시를 입력할 때 생기는 불편을 출발점으로 삼았다. 셸에서 쓰던 fzf 단축키는 다른 프로그램이 키 입력을 받는 동안에는 그대로 사용할 수 없다. tmux에 단축키를 등록하면 실행 중인 프로그램과 관계없이 검색 창을 띄우고, 선택한 값을 원래 창에 키 입력처럼 전달할 수 있다.

이번 변경은 이 방식의 입력 대상을 PR 번호로 넓힌 것이다. pr.fzf를 실행 경로인 PATH에 둔 상태에서 tmux 접두키와 g, p를 차례로 누르면 PR을 선택할 수 있다. 선택한 PR로 브랜치를 전환하는 대신 번호를 입력하도록 구현됐으며, 여러 건을 고르는 것도 가능하다. AI 코딩 도구에 검토할 PR을 지정하는 상황 등에 쓸 수 있다.

fzf-git.sh의 기존 tmux 단축키로는 파일, 브랜치, 태그, 커밋 해시, 워크트리 등 Git 관련 항목을 고를 수 있다. 공식 문서는 커밋별 변경 내용을 미리 살펴본 뒤 해시를 프롬프트에 넣어 변경 검토를 요청하는 사용법도 소개했다.

파일 경로 외에 에이전트 화면에 표시된 URL이나 문장을 다시 입력할 때는 별도 플러그인 tmux-fzf-complete를 활용한다. 검색 대상을 파일, 디렉터리, 화면 속 URL·경로·문장으로 바꿀 수 있고, 줄바꿈된 문장을 이어 붙여 선택하는 기능도 제공한다. 이 플러그인은 fzf 0.74.0 이상과 Ruby가 필요하다.

검색 창을 부동 패널로 여는 기능에는 tmux 3.7 이상이 필요하며, 이전 버전에서는 팝업을 사용한다. 에이전트가 별도 전체 화면으로 동작하면 tmux에 과거 출력이 남지 않아 현재 화면 밖의 문장이나 경로를 찾는 데 제한이 있다. 공식 문서는 Claude Code와 Codex에서 출력 기록을 남기는 화면 설정을 함께 안내했다.

이 기능은 AI 모델이나 에이전트의 API를 확장하는 방식이 아니라 터미널 입력을 돕는 보조 도구다. PR 선택 단축키는 pr.fzf가 있을 때만 등록되므로, fzf 본체만 설치해 바로 사용할 수 있는 기능과는 구분된다.

출처: fzf-git.sh 공식 변경 이력 https://github.com/junegunn/fzf-git.sh/commit/57ef995e245923ae05721e876c42100a1896ad6c / fzf 개발자 공식 문서 https://junegunn.github.io/fzf/tips/using-fzf-with-ai-agents/ / fzf-git.sh 공식 저장소 https://github.com/junegunn/fzf-git.sh / tmux-fzf-complete 공식 저장소 https://github.com/junegunn/tmux-fzf-complete