Repolode
baoyudu

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

    Homebrew로 perch 설치(macOS)

    brew install --cask baoyudu/tap/perch
  2. 2

    또는 Go로 소스에서 설치

    go install github.com/baoyudu/perch/cmd/perch@latest
  3. 3

    shell rc 파일에 shell integration 줄 추가(zsh 예시)

    eval "$(perch init zsh)"
  4. 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 통계는 매일 갱신됩니다.

관련 프로젝트