서버 재시작 후에도 세션이 유지되는, 휴대폰이나 브라우저에서 Pi 코딩 에이전트를 실행하는 셀프 호스팅 모바일 우선 웹 앱입니다.
Xpropel/Pi-Remote
pi 터미널 코딩 에이전트를 원격으로 제어합니다. 실시간 세션을 브라우저나 휴대폰에 미러링하고, 자체 호스팅 릴레이를 통해 메시지나 명령을 보낼 수 있습니다.
- 스타
- 307
- 포크
- 10
- 열린 이슈
- 0
- 마지막 커밋
- 그저께
어떤 프로젝트인가요?
Pi-Remote는 pi의 공식 extension API를 통해 실행 중인 pi 터미널 세션에 연결하며, pi 소스를 수정하거나 터미널을 가로채지 않습니다. 세션은 로컬 pi 프로세스에서 계속 실행되고, 브라우저에는 실시간으로 미러링됩니다. 브라우저에서 메시지를 보내고, 모델과 thinking level을 전환하고, 컨텍스트를 압축하고, 세션을 생성하거나 포크하고, 세션 트리를 탐색할 수 있습니다.
시스템은 pi 내부에서 실행되는 sync extension, 인증과 메시지 전달을 처리하는 Node 릴레이 서비스, 릴레이가 제공하는 웹 UI의 세 부분으로 구성됩니다. 여러 머신이 하나의 릴레이에 연결할 수 있으며, 각 기기는 attach 창이 열려 있는 동안에만 연결할 수 있습니다. serverless 모드에서는 릴레이를 자신의 컴퓨터에서 실행하고, 휴대폰은 같은 Wi-Fi를 사용하거나 임시 Cloudflare Tunnel을 통해 연결합니다.
이 프로젝트는 개인이 혼자 사용하는 용도로 설계되었습니다. 원격 bash는 기본적으로 비활성화되어 있으며, extension과 viewer는 서로 다른 토큰을 사용합니다. persistence를 활성화하지 않으면 대화 내용은 저장되지 않습니다.
핵심 기능
- 01pi 터미널 출력, 도구 호출, 상태를 브라우저에 실시간 미러링
- 02pi가 작업 중일 때 메시지를 대기열에 넣거나 작업 방향을 조정하며 원격으로 메시지 전송
- 03원격으로 모델과 thinking level 전환, 수동 압축, 세션 트리 탐색
- 04QR 코드로 기기 연결 및 여러 머신 연결 지원
- 05선택적으로 필요할 때 Cloudflare Tunnel을 사용하는 serverless LAN 모드
- 06여러 시각적 스킨을 제공하는 데스크톱 및 모바일 레이아웃
활용 사례
- 장시간 실행되는 코딩 에이전트 작업을 휴대폰으로 확인
- 자리를 비운 동안 pi의 프롬프트에 응답
- 하나의 브라우저 대시보드에서 여러 머신의 pi 세션 제어
빠른 시작
- 1
pi 터미널 코딩 에이전트를 설치합니다(Node 22.18 이상 필요).
npm install -g @earendil-works/pi-coding-agent - 2
프로젝트 폴더에 Pi-Remote 종속 항목을 설치합니다.
npm install - 3
컴퓨터에서 relay를 시작합니다(웹 UI 포트: 7002).
npm run relay
사용 전 알아둘 점
- pi 코딩 에이전트는 별도로 설치해야 하며 Pi-Remote에 포함되어 있지 않습니다.
- 로컬 루프 모드를 제외하고 relay를 통해 여러 기기에서 사용하려면 직접 관리하는 서버가 필요합니다.
- 개인용 단일 사용자 사용을 위해 설계되었으며 다중 사용자 권한 시스템은 제공하지 않습니다.
- viewer token을 가진 사람은 누구나 pi에 메시지와 명령을 보낼 수 있으므로 token을 안전하게 보호해야 합니다.
포함된 컬렉션
토픽
자주 묻는 질문
- Pi-Remote은(는) 무엇인가요?
- pi 터미널 코딩 에이전트를 원격으로 제어합니다. 실시간 세션을 브라우저나 휴대폰에 미러링하고, 자체 호스팅 릴레이를 통해 메시지나 명령을 보낼 수 있습니다. Pi-Remote는 pi의 공식 extension API를 통해 실행 중인 pi 터미널 세션에 연결하며, pi 소스를 수정하거나 터미널을 가로채지 않습니다. 세션은 로컬 pi 프로세스에서 계속 실행되고, 브라우저에는 실시간으로 미러링됩니다. 브라우저에서 메시지를 보내고, 모델과 thinking level을 전환하고, 컨텍스트를 압축하고, 세션을 생성하거나 포크하고, 세션 트리를 탐색할 수 있습니다.
- Pi-Remote은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- Pi-Remote은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- Pi-Remote은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. Pi-Remote의 마지막 커밋은 2026년 11월 5일입니다.
- Pi-Remote은(는) 어디에 사용할 수 있나요?
- 장시간 실행되는 코딩 에이전트 작업을 휴대폰으로 확인 자리를 비운 동안 pi의 프롬프트에 응답 하나의 브라우저 대시보드에서 여러 머신의 pi 세션 제어
- Pi-Remote는 어떻게 설치하나요?
- pi 터미널 코딩 에이전트를 설치합니다(Node 22.18 이상 필요).: npm install -g @earendil-works/pi-coding-agent 프로젝트 폴더에 Pi-Remote 종속 항목을 설치합니다.: npm install 컴퓨터에서 relay를 시작합니다(웹 UI 포트: 7002).: npm run relay
- Pi-Remote은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Xpropel/Pi-Remote
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
HTTP/HTTPS로 제공되며 xterm.js와 WebSockets를 기반으로 하는 브라우저용 터미널 에뮬레이터입니다.
학습과 실험을 위해 작은 코드베이스로 구현한, Claude Code와 비슷한 도구 루프와 TUI를 갖춘 경량 터미널 코딩 도우미입니다.
Pi AI 코딩 에이전트를 내장 채팅 창과 함께 설치형 앱으로 제공하는 macOS, Windows, Linux용 데스크톱 앱입니다.
파일 읽기, 코드 편집, 명령 실행이 가능한 최소한의 TypeScript 코딩 에이전트를 처음부터 만드는 단계별 튜토리얼입니다.
Pi Coding Agent 터미널 하네스의 설치부터 Skills, Extensions, Subagents, 장기 실행 워크플로까지 다루는 비공식 중국어 가이드입니다.