코딩 에이전트 세션을 브라우저에서 직접 다루는 방법
터미널을 벗어나 브라우저 탭에서 코딩 에이전트의 대화 기록을 넘보고, 필요한 부분에서 새 세션을 갈라 실행을 이어가는 장면을 상상해 보세요. Pi Web은 pi 코딩 에이전트가 사용하는 로컬 설정과 세션 파일을 그대로 읽어와 웹 인터페이스로 보여주는 도구입니다. 설치 과정은 간단하며, 기존 pi 환경과 완전히 호환되어 별도의 데이터 이주가 필요 없습니다.
세션 분기와 파일 관리
Pi Web은 프로젝트별로 그룹화된 대화 목록을 제공하며, 각 세션의 실행 상태, 컨텍스트 사용량, 비용, 압축 상세 정보를 한눈에 볼 수 있습니다. 대화 중 특정 지점에서 '여기서 편집'을 선택하면 현재 세션 안에서 분기를 만들 수 있고, '새 세션'을 만들면 이전 메시지에서 독립적인 세션 파일을 생성합니다. 이러한 분기 기능은 실험적인 코딩을 원본 세션에 영향을 주지 않고 진행할 때 유용합니다. 또한 파일 업로드, Git diff 검사, 소스 코드 및 문서 미리보기 기능을 제공하여 코드 검토와 파일 관리를 브라우저 안에서 처리할 수 있습니다.
모델 설정과 원격 접근 관리
웹 기반 설정 패널을 통해 프로바이더 로그인, API 키, 모델, 플러그인, 스킬을 관리할 수 있어 터미널 명령어를 입력하지 않고도 환경을 구성할 수 있습니다. 기본값은 로컬호스트(127.0.0.1)에만 리스닝하도록 설정되어 있어 보안이 강화되어 있습니다. 만약 LAN이나 인터넷으로 접근해야 한다면, 긴 랜덤 비밀번호를 설정하고 HTTPS를 통한 역프록시나 VPN 사용을 권장합니다. 평문 HTTP로 인터넷에 노출하는 것은 금지되며, 이 경우 인증만 되고 연결 암호화는 되지 않기 때문입니다. 또한 표준 HTTP 프록시 환경 변수를 지원하여 기업 네트워크 환경에서도 모델 API 요청을 처리할 수 있습니다.
실행 환경과 데이터 경계
Pi Web은 Node.js 22.19.0 이상을 요구하며, npx @agegr/pi-web@latest 명령으로 즉시 실행할 수 있습니다. 에이전트 데이터는 기본적으로 ~/.pi/agent 디렉터리를 읽으며, 세션 파일은 해당 경로 아래에 저장됩니다. 파일 브라우저는 Pi Web에서 선택한 작업 디렉터리와 프로젝트 루트 경로로만 접근 범위가 제한되어 일반적인 파일 탐색기가 아닙니다. 이는 보안상 중요한 경계이며, pi 에이전트와 동일한 파일 시스템 환경에서 실행해야 기존 세션을 공유할 수 있습니다. Electron 래퍼나 다른 통합 앱은 브라우저 이벤트를 통해 세션 컨텍스트 메뉴를 확장할 수 있는 훅도 제공합니다.
사용 전 확인 사항
이 도구는 pi 코딩 에이전트를 이미 사용 중이거나, 로컬에서 에이전트 세션을 관리하는 개발자에게 적합합니다. 브라우저 기반 UI를 선호하지만 로컬 데이터 프라이버시를 유지하고 싶은 사용자에게 특히 잘 맞습니다. 원격으로 접근할 계획이라면 반드시 HTTPS와 비밀번호 인증을 함께 설정해야 하며, 평문 HTTP 노출은 피해야 합니다. MIT 라이선스로 배포되어 자유롭게 사용할 수 있습니다.
