pi-web
무엇인가
PI WEB은 Pi Coding Agent를 원격에서 조종하는 브라우저 기반 제어면이다. 에이전트 실행은 서버·워크스테이션·원격 개발 장비에 남고, 브라우저는 프로젝트·워크스페이스·파일·터미널·세션·원격 머신을 조작하는 창구 역할만 한다. 코딩 에이전트 자체를 대체하지 않고, 그 위에 얹히는 세션 감독 계층에 속한다.
어떻게 동작하나
구성은 브라우저에 노출되는 게이트웨이 인스턴스와 세션을 유지하는 세션 데몬으로 나뉜다. 프로젝트를 등록하고 그 안에서 워크스페이스나 git worktree를 고르면 세션이 해당 디렉터리에서 실행된다. 세션 수명은 브라우저 연결과 분리되어 데몬이 계속 붙잡으므로 탭을 닫아도 살아 있다. 다른 PI WEB 런타임을 원격 머신으로 등록하면 한 인스턴스가 프로젝트, 파일, git 상태, 세션, 터미널, 활동, Pi 패키지 관리, 선택된 머신 설정을 프록시한다. 설정은 전역 설정 파일과 프로젝트 로컬 설정 파일로 나뉘고, 호스트·포트·허용 호스트·원격 머신 등록·토큰·키보드 단축키는 게이트웨이에 남는다.
무엇과 다른가
터미널 에뮬레이터나 IDE에 붙은 에이전트 세션은 그 프로세스를 띄운 셸과 함께 종료된다. PI WEB은 세션 수명을 브라우저 세션에서 떼어내 데몬 쪽에 둔다. 샌드박스형 에이전트 런타임과도 다르다. 격리나 권한 모델을 제공하지 않고, 코드·도구·자격 증명·빌드 캐시가 이미 있는 실제 작업 디렉터리에서 그대로 실행한다. 여러 세션을 병렬로 띄우고 노트북·휴대폰·태블릿·데스크톱에서 같은 인스턴스에 접속하는 것이 기본 사용 형태다.
어떻게 쓰나
설치 후 사용자 단위 서비스로 실행하고 브라우저에서 해당 주소를 연다. 흐름은 프로젝트 추가, 워크스페이스나 git worktree 선택, 세션 시작, 이후 임의 브라우저에서 재접속이다. PI WEB 플러그인은 Settings → PI WEB plugins에서 선택된 머신 기준으로 켜고 끄며, 서버 쪽 변경은 세션 데몬 재시작을 요구한다. Pi 패키지 설치는 PI WEB 플러그인 활성화와 별개의 동작이다.
전제와 한계
Node.js 22.19.0 이상, npm, 사용자 계정에 설정된 Pi Coding Agent 0.87.0 이상, git과 에이전트가 필요로 하는 개발 도구가 전제다. 신뢰된 사용자·저장소·서버 경로를 가정하며 샌드박스나 권한 시스템, 멀티테넌트 플랫폼이 아니다. 공인 인터넷에 직접 노출하지 말고 사설망, SSH 터널, 인증 리버스 프록시, 또는 연합 머신 구성으로 접근한다.