Repolode
minghinmatthewlam

minghinmatthewlam/pi-gui

git worktree를 활용해 에이전트 스레드를 병렬로 실행하고, diff 검토 탭과 통합 터미널을 제공하는 pi 코딩 에이전트용 Electron 데스크톱 앱입니다.

스타
1,411
포크
203
열린 이슈
27
마지막 커밋
5일 전

어떤 프로젝트인가요?

pi-gui는 pi 코딩 에이전트용 데스크톱 셸입니다. 세션, 모델, 인증, 도구는 모두 pi를 통해 실행되므로 pi CLI에 설정한 내용을 그대로 사용할 수 있습니다. 각 작업은 별도의 스레드에서 진행되며, 현재 체크아웃이나 새 git worktree에서 시작할 수 있어 여러 에이전트를 병렬로 실행할 수 있습니다.

창에는 대화와 함께 실제 터미널, 파일 탐색기와 에디터, 커밋하지 않은 작업·브랜치·개별 턴을 비교하는 Review 탭, 데스크톱 확장 프로그램의 탭을 제공하는 작업 공간이 있습니다. 검색, 파일 열기, 스레드 전환, 실행 중인 에이전트에 작업을 대기열에 추가하거나 방향을 제시하는 키보드 단축키도 지원합니다. 예약 프롬프트, skills와 extensions, OAuth 또는 API key를 통한 제공업체 로그인도 사용할 수 있습니다.

앱은 macOS(Apple Silicon), Linux(x64), Windows(x64)에서 실행되며, 릴리스나 macOS용 Homebrew로 설치할 수 있습니다. Electron, React, TypeScript로 제작되었으며 pi의 JSONL 세션 파일을 직접 읽습니다.

핵심 기능

  • 01여러 에이전트 스레드를 병렬로 실행하며, 각 스레드는 선택적으로 별도의 git worktree를 사용할 수 있습니다.
  • 02Review 탭에서 커밋하지 않은 작업, 브랜치, 개별 턴의 diff를 확인하고 파일별로 스테이징할 수 있습니다.
  • 03대화 옆에 통합 터미널, 파일 탐색기, 에디터가 표시됩니다.
  • 04세션, 인증 정보, skills를 pi CLI와 공유합니다.
  • 05예약 작업, 알림, 키보드 단축키를 지원하는 명령 팔레트를 제공합니다.
  • 06모델 제공업체의 OAuth, API key, 사용자 지정 엔드포인트를 지원합니다.

활용 사례

  • 여러 코딩 에이전트가 각자 다른 기능이나 버그 수정을 동시에 진행하도록 할 때.
  • 커밋하기 전에 에이전트의 변경 사항을 파일별로 검토할 때.
  • 창을 전환하지 않고 에이전트 대화 옆 터미널에서 테스트를 실행할 때.
  • 앱을 열어 둔 상태에서 매주 실행하는 의존성 점검 같은 반복 프롬프트를 예약할 때.

빠른 시작

  1. 1

    Homebrew로 pi-gui 설치: 저장소를 tap에 추가합니다

    brew tap minghinmatthewlam/tap
  2. 2

    tap을 신뢰합니다(최초 설치 시 필요).

    brew trust minghinmatthewlam/tap
  3. 3

    pi-gui cask를 설치합니다

    brew install --cask pi-gui
  4. 4

    pi-gui를 열고 Settings → Providers에서 모델 제공업체에 연결한 다음, 워크스페이스를 추가하고 첫 프롬프트를 보냅니다

사용 전 알아둘 점

  • 네이티브 빌드는 macOS(Apple Silicon), Linux(x64), Windows(x64)만 지원합니다.
  • Windows 빌드는 아직 코드 서명되지 않아 SmartScreen 경고가 표시될 수 있습니다.
  • 유용한 작업을 하려면 pi 코딩 에이전트와 모델 제공업체 또는 API 키가 필요한 데스크톱 셸입니다.

포함된 컬렉션

토픽

자주 묻는 질문

pi-gui은(는) 무엇인가요?
git worktree를 활용해 에이전트 스레드를 병렬로 실행하고, diff 검토 탭과 통합 터미널을 제공하는 pi 코딩 에이전트용 Electron 데스크톱 앱입니다. pi-gui는 pi 코딩 에이전트용 데스크톱 셸입니다. 세션, 모델, 인증, 도구는 모두 pi를 통해 실행되므로 pi CLI에 설정한 내용을 그대로 사용할 수 있습니다. 각 작업은 별도의 스레드에서 진행되며, 현재 체크아웃이나 새 git worktree에서 시작할 수 있어 여러 에이전트를 병렬로 실행할 수 있습니다.
pi-gui은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
pi-gui은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
pi-gui은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. pi-gui의 마지막 커밋은 2026년 11월 2일입니다.
pi-gui은(는) 어디에 사용할 수 있나요?
여러 코딩 에이전트가 각자 다른 기능이나 버그 수정을 동시에 진행하도록 할 때. 커밋하기 전에 에이전트의 변경 사항을 파일별로 검토할 때. 창을 전환하지 않고 에이전트 대화 옆 터미널에서 테스트를 실행할 때. 앱을 열어 둔 상태에서 매주 실행하는 의존성 점검 같은 반복 프롬프트를 예약할 때.
pi-gui는 어떻게 설치하나요?
Homebrew로 pi-gui 설치: 저장소를 tap에 추가합니다: brew tap minghinmatthewlam/tap tap을 신뢰합니다(최초 설치 시 필요).: brew trust minghinmatthewlam/tap pi-gui cask를 설치합니다: brew install --cask pi-gui pi-gui를 열고 Settings → Providers에서 모델 제공업체에 연결한 다음, 워크스페이스를 추가하고 첫 프롬프트를 보냅니다
pi-gui은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/minghinmatthewlam/pi-gui

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트