baoyudu/perch
최근 Claude Code 또는 Codex 프로젝트로 빠르게 돌아가는 터미널 피커로, 에이전트를 다시 실행하거나 마지막 세션을 이어서 진행할 수 있습니다.
- 스타
- 89
- 포크
- 0
- 열린 이슈
- 0
- 마지막 커밋
- 2개월 전
어떤 프로젝트인가요?
perch는 Claude Code나 Codex로 마지막에 작업하던 프로젝트로 돌아가도록 도와주는 Go 기반 터미널 도구입니다. 두 에이전트가 디스크에 이미 저장해 둔 세션 기록을 읽으므로 별도 설정이 필요 없습니다. 에이전트를 한 번이라도 실행한 프로젝트라면 설치 직후 퍼지 검색 목록에 표시됩니다.
피커에서 키 한 번으로 디렉터리만 이동하거나 claude 또는 codex를 실행하거나 마지막 대화를 이어갈 수 있습니다. 각 프로젝트 행에는 마지막으로 사용한 에이전트, 상대 시간, git 브랜치와 변경된 파일 수가 표시되고, 미리보기 창에서는 마지막 대화의 끝부분을 확인할 수 있습니다. 프로젝트를 목록 상단에 고정할 수 있으며, 선택 사항인 TOML 설정 파일에서 프로젝트별 기본 동작과 추가 인자를 지정할 수 있습니다.
자식 프로세스는 부모 셸의 디렉터리를 바꿀 수 없으므로 perch는 터미널에 UI를 표시하고, 선택한 경로와 명령을 출력합니다. `perch init`으로 설정하는 작은 셸 함수가 이를 실행합니다. zsh, bash, fish 설정을 지원하며, Codex 데스크톱 앱 모드에서는 codex:// 링크를 통해 프로젝트를 앱으로 전달합니다.
핵심 기능
- 01설정 없이 기존 Claude Code 및 Codex 세션 기록을 읽습니다.
- 02이름과 경로로 프로젝트를 퍼지 필터링합니다.
- 03키 한 번으로 디렉터리 이동, claude 또는 codex 실행, 마지막 세션 이어가기를 할 수 있습니다.
- 04각 프로젝트의 마지막 사용 에이전트, git 브랜치와 변경된 파일 수를 표시합니다.
- 05마지막 대화의 끝부분을 미리 볼 수 있습니다.
- 06프로젝트를 고정하고 TOML에서 프로젝트별 기본 동작과 인자를 설정할 수 있습니다.
활용 사례
- 코딩 에이전트를 사용하는 여러 저장소 사이를 오갈 때.
- 새 터미널을 연 뒤 어제 나눈 Claude Code 또는 Codex 대화를 이어갈 때.
- 키 한 번으로 특정 프로젝트에서 사용자 지정 플래그를 사용해 에이전트를 실행할 때.
빠른 시작
- 1
Homebrew로 perch 설치(macOS)
brew install --cask baoyudu/tap/perch - 2
또는 Go로 소스에서 설치
go install github.com/baoyudu/perch/cmd/perch@latest - 3
shell rc 파일에 shell integration 줄 추가(zsh 예시)
eval "$(perch init zsh)" - 4
새 터미널을 열고 p를 입력해 picker 시작
사용 전 알아둘 점
- 프로젝트를 나열하려면 디스크에 저장된 Claude Code 및 Codex 세션 기록이 필요합니다.
- Nerd Font 아이콘과 같은 일부 기능에는 패치된 터미널 글꼴이 필요하지만, 일반 모드도 사용할 수 있습니다.
포함된 컬렉션
토픽
자주 묻는 질문
- perch은(는) 무엇인가요?
- 최근 Claude Code 또는 Codex 프로젝트로 빠르게 돌아가는 터미널 피커로, 에이전트를 다시 실행하거나 마지막 세션을 이어서 진행할 수 있습니다. perch는 Claude Code나 Codex로 마지막에 작업하던 프로젝트로 돌아가도록 도와주는 Go 기반 터미널 도구입니다. 두 에이전트가 디스크에 이미 저장해 둔 세션 기록을 읽으므로 별도 설정이 필요 없습니다. 에이전트를 한 번이라도 실행한 프로젝트라면 설치 직후 퍼지 검색 목록에 표시됩니다.
- perch은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- perch은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- perch은(는) 아직 유지보수되고 있나요?
- 6개월 이내 업데이트. perch의 마지막 커밋은 2026년 9월 14일입니다.
- perch은(는) 어디에 사용할 수 있나요?
- 코딩 에이전트를 사용하는 여러 저장소 사이를 오갈 때. 새 터미널을 연 뒤 어제 나눈 Claude Code 또는 Codex 대화를 이어갈 때. 키 한 번으로 특정 프로젝트에서 사용자 지정 플래그를 사용해 에이전트를 실행할 때.
- perch는 어떻게 설치하나요?
- Homebrew로 perch 설치(macOS): brew install --cask baoyudu/tap/perch 또는 Go로 소스에서 설치: go install github.com/baoyudu/perch/cmd/perch@latest shell rc 파일에 shell integration 줄 추가(zsh 예시): eval "$(perch init zsh)" 새 터미널을 열고 p를 입력해 picker 시작
- perch은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/baoyudu/perch
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
Bubble Tea로 만든 Go 기반의 현대적인 터미널 파일 관리자. 명령줄에서 파일을 탐색하고 관리할 수 있습니다.
Go와 Bubble Tea로 만든 터미널 이메일 클라이언트로, 여러 계정과 풍부한 콘텐츠, 플러그인 시스템을 지원합니다.
타일형 창, 워크스페이스, 세션 유지 기능과 각 창에서 실행 중인 코딩 에이전트를 위한 Inbox를 갖춘 Go 기반 터미널 멀티플렉서 겸 창 관리자입니다.
tmux 없이 Git worktree와 여러 프로젝트에서 여러 AI 코딩 에이전트 세션을 실행하고 전환하는 CLI 앱입니다.