agegr/pi-web

Pi Web – Pi coding-agent용 브라우저 UI

개요 – Pi Web은 Pi coding-agent(코드용 명령줄 AI 어시스턴트)와 함께 작업할 수 있는 로컬 웹 기반 인터페이스입니다. Pi CLI가 사용하는 것과 동일한 구성 및 세션 파일을 읽으므로 브라우저 창에서 세션을 탐색, 재개 및 분기하고, 모델 자격 증명을 관리하며, 프로젝트 파일을 검사할 수 있습니다.

주요 기능

• 세션 워크스페이스 – 프로젝트별로 세션을 나열하고, 사용 통계(토큰, 비용, 압축)를 확인하며, 이름을 변경, 내보내기 또는 삭제하고, 모든 메시지에서 새 분기를 생성할 수 있습니다.
• 파일 탐색기 – 세션이 인식하는 파일을 탐색하고, 새 파일을 업로드하며, Git diff를 보고, 많은 형식(Markdown, 소스 코드, 이미지, 오디오, PDF, DOCX)을 실시간 새로 고침으로 미리 볼 수 있습니다.
• Git 워크트리 지원 – 세션을 리포지토리별로 그룹화하면서 서로 다른 워크트리 체크아웃 간에 전환할 수 있습니다.
• 구성 패널 – UI를 떠나지 않고도 모델 공급자, API 키, 플러그인 및 기술을 추가하거나 편집할 수 있습니다.
• 다국어 UI – 영어, 간체 및 번체 중국어를 지원하며 브라우저 언어에 따라 자동으로 선택됩니다.

실행 방법

1. Node 22.19 이상을 설치합니다.
2. npx @agegr/pi-web@latest 한 줄 명령어로 시작합니다(또는 npm i -g @agegr/pi-web으로 전역 설치).
3. 로컬 서버가 127.0.0.1:30141에서 시작되고 기본 브라우저가 열립니다.
4. 아직 모델 공급자를 구성하지 않았다면 Models 패널을 열고 API 키를 추가하십시오.

구성 및 보안

• 포트, 호스트 이름, 유휴 시간 초과 및 암호 보호는 CLI 플래그 또는 환경 변수(PI_WEB_PASSWORD, PI_WEB_IDLE_TIMEOUT_MS 등)를 통해 제어할 수 있습니다.
• 기본적으로 localhost에만 바인딩됩니다. 네트워크에 노출하려면 강력한 암호와 TLS용 리버스 프록시가 필요합니다.
• UI는 전체 파일 시스템이 아닌 Pi agent가 알고 있는 작업 디렉토리 내의 파일에만 액세스합니다.

개발 – 이 리포지토리는 TypeScript로 작성된 Next.js + React 앱입니다. npm install && npm run dev를 실행하여 핫 리로딩 개발 서버를 시작하십시오. 테스트, 유형 검사 및 린팅이 제공됩니다.

대상 사용자 – Pi coding-agent를 사용하며 명령줄을 떠나지 않고 세션, 파일 및 모델 설정을 관리할 수 있는 더 풍부하고 시각적인 방법을 원하는 모든 사용자.

라이선스 – MIT.