TL;DR

Pi Web은 로컬의 pi 에이전트 JSONL 세션 파일을 직접 파싱해 브라우저에서 세션 트리, 실시간 채팅, 포크 및 브랜치 관리를 제공하는 경량 웹 인터페이스이다. 서버는 AgentSession을 인프로세스로 실행하고 Server-Sent Events로 브라우저에 출력을 스트리밍하므로 별도 중계 서비스 없이 실시간 상호작용이 가능하다. models.json을 통해 웹에서 모델 인증과 기본 설정을 제어할 수 있고 Git 워크트리 전환을 통합해 브랜치별 코드 컨텍스트에 맞춘 세션 관리를 지원한다. 이 설계는 터미널 기반 탐색의 비효율을 줄이고 파일 컨텍스트를 함께 보면서 에이전트와 실험을 반복하려는 워크플로우에 적합하지만 원본 세션 파일과 서버에 대한 로컬 접근 권한이 전제 조건이다. 사용 시작은 npx 한 줄 실행 또는 글로벌 설치 후 pi-web 명령으로 가능하며 개발 모드는 npm run dev로 띄운다.

핵심 포인트

• 세션 데이터를 직접 JSONL 파일에서 읽어오는 구조로 외부 데이터 동기화가 필요 없고 로컬 저장소 상태를 그대로 반영한다.
• AgentSession을 서버 프로세스 내에서 실행하고 SSE로 브라우저에 스트리밍하는 방식은 별도 중간 서비스 없이 실시간 상호작용을 제공한다.
• Git 워크트리 전환을 사이드바에 통합해 브랜치별 코드 컨텍스트에 따라 새로운 세션과 탐색 상태가 자동으로 맞춰지게 한다.
• 웹 UI에서 models.json을 편집하고 모델 인증을 테스트할 수 있어 터미널 기반 설정보다 더 쉬운 모델 관리 경로를 제공한다.

이미지 분석