작업이 진행되는 동안
에이전트의 대화 읽기
Chat은 에이전트 세션을 턴 단위로 표시합니다. 사용자의 메시지, 에이전트의 답변, 접힌 부분 뒤에 숨겨진 추론 과정이 표시되며, 각 도구 호출은 한 줄로 접힙니다. 이는 에이전트 창의 기본 보기입니다. 브리지 연결이 끊어지면 휴대폰에는 최근 턴의 읽기 전용 복사본이 표시됩니다.
휴대전화에서 사용하는 터미널 에이전트.
ColliePWA는 Herdr, tmux, zellij를 위한 모바일 클라이언트입니다. 에이전트 창을 휴대폰으로 가져옵니다. 누가 대기 중인지 확인하고, 대화나 화면을 읽고, 어디서나 답장하십시오.
- 지원 멀티플렉서:
- Herdr
- tmux
- Zellij
Herdr가 기본 백엔드입니다. tmux 및 zellij 지원은 실험 단계입니다. 상세 내용: 터미널
$ curl -fsSL https://colliepwa.dev/install.sh | sh오픈소스, MIT 라이선스. 셀프 호스팅 방식의 단일 사용자 바이너리로 실행. Tailscale 또는 커스텀 인그레스 지원.
실행 중인 ColliePWA 인터페이스의 목업 화면입니다. 실제 백엔드와 연결되어 있지 않습니다.
요약
ColliePWA의 기능입니다.
- 모든 에이전트를 한 번에 확인합니다.
- tmux, zellij 또는 Herdr의 모든 창을 작업 공간별로 묶어 하나의 목록으로 봅니다. 사용자의 확인이 필요한 창이 맨 위에 표시됩니다.
- 휴대전화에서 응답합니다.
- 에이전트의 대화나 터미널을 읽고, 답장하고, 키 입력을 전송하고, 계획 옵션을 선택하거나, 음성으로 답장하십시오.
- 조치가 필요한 시점을 파악합니다.
- 에이전트가 질문을 하거나 작업을 마쳤을 때, 또는 프롬프트 캐시가 곧 만료되려 할 때 푸시 알림을 받습니다.
- 휴대폰에서 에이전트를 시작합니다.
- + New를 누르고 머신, 에이전트, 폴더를 고른 뒤 Start를 누릅니다. 새 브랜치는 자체 폴더에서 열 수 있습니다.
- 여러 대의 머신을 하나의 크루로 실행합니다.
- lead는 모든 머신의 창, 부하, 디스크를 표시합니다. lead가 다운되면 지정한 deputy가 인계받을 수 있습니다.
- 에이전트가 서로 메시지를 주고받도록 합니다.
- 한 에이전트 세션이 크루 내의 모든 머신에 있는 다른 세션으로 메시지를 보냅니다. 휴대폰에서 모든 세션으로 메시지를 보낼 수 있습니다.
- 설계부터 프라이버시를 보장합니다.
- loopback에 바인딩되고, 모든 요청에 페어링된 기기가 필요하며, 창 텍스트에서 알려진 형태의 비밀 정보를 마스킹합니다. 이 앱은 텔레메트리를 전송하지 않습니다. 클라우드 중계자는 없습니다.
확인하기
살펴본 다음 직접 제어합니다.
여기서 직접 테스트해 볼 수 있습니다.
실제 구동되는 ColliePWA 앱입니다. 에이전트 목록, 터미널 출력, 응답은 브라우저에서 재생되는 더미 데이터입니다. 백엔드에서 실행되는 프로세스는 없으며 네트워크로 데이터를 전송하지 않습니다.
- 01맨 위에 있는 blocked 상태의 에이전트를 선택합니다.
- 02질문 내용을 확인합니다. 실제 터미널 화면을 그대로 미러링합니다.
- 03답변을 탭하면 에이전트가 작업을 이어갑니다.
- 04Keys를 탭합니다. Esc, Tab, 방향키, Ctrl 등 모바일 키보드에 없는 키를 제공합니다.
확인 및 답변
에이전트 내용을 확인합니다. 탭 한 번으로 답변합니다.
입력 대기 상태일 때
터치 한 번으로 응답
권한 요청 프롬프트를 버튼 세 개로 변환합니다. 오작동을 방지하기 위해 응답 전송 직전 현재 화면 상태와 프롬프트를 대조 검증합니다.
원시 화면이 필요할 때
탭 한 번으로 확인하는 정확한 화면
터미널 보기는 ANSI 색상을 포함하여 창을 바이트 단위로 그대로 표시합니다. 응답 상자 아래의 Screen을 탭하여 열고, 다시 탭하여 Chat으로 돌아갑니다. 창 메뉴에서 이를 기본값으로 설정할 수 있습니다.
입력 줄이기
Sent
각 머신은 사용자가 ColliePWA를 통해 전송한 셸 줄을 저장합니다. 입력 상자 위의 스트립은 셸 창에서 해당 줄을 다시 제공합니다. 공백으로 시작하는 줄은 저장되지 않으며, 시크릿처럼 보이는 줄도 저장되지 않습니다. 에이전트 프롬프트는 절대 저장되지 않습니다. Settings, Device에 있는 Suggestions from Sent 스위치를 사용하면 셸 창에서 스트립을 끌 수 있습니다. COLLIE_SENT=off는 머신에 아무것도 저장하지 않습니다.
슬래시 제안
에이전트 창에서 /를 입력하거나 Codex 스킬의 경우 $를 입력하십시오. 스트립에 일치하는 명령어가 나열됩니다. 탭하면 전송하지 않고 입력 상자를 채웁니다.
팔레트의 스킬
Claude Code 창에서 Agent 팔레트는 ~/.claude 및 프로젝트 .claude 폴더의 스킬과 명령어도 나열합니다. 또한 plugin: 접두사와 함께 설치된 플러그인의 스킬과 명령어도 나열합니다. 비활성화된 플러그인은 제외됩니다. 항목을 탭하면 전송하지 않고 입력 상자를 채웁니다.
상태 변경 알림
에이전트가 입력을 대기하거나 완료되면 알림을 보냅니다. 알림을 선택하면 해당 에이전트 화면으로 이동합니다. HTTPS 환경과 collie push-keys 구성이 필요합니다.
New 버튼 하나, New 페이지 하나
대시보드의 + New 버튼은 New 페이지를 엽니다. crew에서는 머신을 먼저 선택하고 Agent 또는 Shell을 선택한 다음 Start를 탭하십시오. 설치되지 않은 에이전트는 대괄호 안에 이유가 표시되며 회색으로 나타납니다. Folder 필드 아래의 Browse 행은 탭할 때마다 홈 폴더를 한 단계씩 이동합니다. 저장소인 각 폴더를 표시합니다. Herdr에서 New worktree는 새 브랜치를 자체 폴더에 배치합니다. 모든 시작에는 id가 사용되므로 응답이 유실되어도 중복 창이 생성되지 않습니다.
Files 및 Changes, 읽기 전용
신뢰하기 전에 에이전트가 무엇을 변경했는지 확인하십시오. Files는 작업 공간에서 변경된 파일을 표시합니다. Changes는 경로 또는 상태별로 필터링하여 저장소별로 그룹화합니다. 파일을 탭하여 모바일에 최적화된 diff를 보거나 Markdown, JSON, HTML 및 이미지를 미리 볼 수 있습니다. 이 보기는 읽기 전용입니다. git은 훅, 필터 또는 네트워크 액세스 없이 실행되며 아무것도 편집, 스테이징 또는 커밋하지 않습니다.
테마
하나의 앱을 위한 네 가지 스타일.
ColliePWA는 Collie, Nightwatch, Daylight, Harbour의 네 가지 테마를 기본 제공합니다. 테마는 색상, 서체, 형태, 모양새 및 터미널 팔레트를 포함합니다. 모든 값은 지정된 단어이거나 검증된 색상이며, 모든 테마에는 라이트 모드와 다크 모드가 있습니다.
Collie
UI 글꼴: Aldrich
익숙한 스타일: 중립적인 회색과 Aldrich 서체.
Nightwatch
UI 글꼴: IBM Plex Sans
flat · bold · strong · band · heavy
야간 대기 중인 휴대폰을 위한 테마입니다. 굵은 선, 어두운 호박색 악센트, 헤더와 표시줄 뒤의 어두운 호박색 띠가 있는 평면적이고 각진 트루 블랙 다크 모드를 제공합니다.
터미널 팔레트
Daylight
UI 글꼴: Geist
제목: Atkinson Hyperlegible Next
round · lifted · roomy · gradient · cards · sentence
밝은 햇빛과 저시력을 위한 테마입니다. AAA 대비의 본문 텍스트, 둥글고 여유 있는 카드, 하단 쪽으로 이동하는 페이지, 그리고 빨간색에서 녹색이 아닌 파란색에서 주황색으로 이어지는 상태 색상을 제공합니다.
터미널 팔레트
Harbour
UI 글꼴: Atkinson Hyperlegible Next
제목: Space Grotesk
soft · lifted · grain · thin
터미널 사용자들을 위한 테마입니다. 청록색 악센트가 하나 들어간 차분한 블루 그레이, 부드러운 모서리, 고운 입자 질감과 얇은 아이콘, 그리고 거의 검정에 가까운 파란색 위의 Solarized 기반 터미널 팔레트를 제공합니다.
터미널 팔레트
연결
휴대폰이 에이전트에 연결되는 방식입니다.
멀티플렉서는 터미널을 닫거나 연결이 끊겨도 머신에서 모든 에이전트를 계속 실행합니다. ColliePWA는 이러한 창들을 스마트폰에 표시하여 어디서나 상태를 확인하고 응답할 수 있게 합니다.
- 기존 기기에서 실행
- 데스크톱, 홈 서버, 여분의 미니 PC 또는 클라우드 VM을 사용하십시오. 켜져 있는 모든 Linux 또는 macOS 머신이 에이전트를 호스팅할 수 있으며, Windows 11(실험적)도 가능합니다. 새로운 하드웨어나 구독은 필요하지 않습니다.
- 멀티플렉서가 세션을 유지
- 터미널 창 대신 Herdr, tmux 또는 zellij가 각 세션을 소유합니다. 연결이 끊기거나 터미널이 닫히거나 잠든 밤에도 에이전트는 작업을 계속합니다.
5분 만에 설정
컴퓨터에 Tailscale, Herdr, ColliePWA를 설치한 다음 스마트폰에 설정합니다. 단 하나의 가이드, 다섯 단계로 진행됩니다.
사용자의 프런트 도어로 보호됩니다.
ColliePWA는 루프백에서만 수신 대기하므로 네트워크의 어떤 기기도 직접 접근할 수 없습니다. 휴대전화는 사용자가 이미 신뢰하는 하나의 프런트 도어를 통해 접속합니다. 사용 중인 방식을 선택하십시오.
- Tailscale
기본 방식입니다.
collie start는 사용자를 대신해tailscale serve를 실행하며, tailnet 이름에서 HTTPS를 제공합니다. Tailscale 관리 콘솔에서 HTTPS 인증서를 한 번 켜십시오.
기타 진입 경로
- Cloudflare Tunnel
열린 포트가 없는 공개 호스트 이름입니다. 터널 자체만으로는 인터넷 전체에 개방되므로, 그 앞에 Cloudflare Access 로그인을 배치하십시오.
- Nginx Proxy Manager
웹 UI와 Let's Encrypt를 갖춘 리버스 프록시입니다. Docker에서 실행되므로, 루프백에 연결되도록 컨테이너에 호스트 네트워킹을 설정하십시오.
- NetBird
tailnet과 유사한 WireGuard 메시입니다. 비공개 이름에 대한 DNS 챌린지 인증서와 함께, 호스트에 HTTPS용 리버스 프록시를 추가하십시오.
- Caddy
HTTPS 인증서를 자체적으로 발급받고 갱신하는 리버스 프록시입니다. 자체 도메인이 있는 경우 가장 짧은 설정 방식입니다.
- 기타 방식
Traefik, 기본 nginx, ZeroTier 또는 다른 프록시도 작동합니다.
127.0.0.1로 전달하고 하나의 고정 호스트 이름에서 HTTPS를 제공해야 합니다.
- 푸시 및 음성 기능에는 HTTPS가 필요합니다
- 브라우저는 보안 오리진에서만 Web Push, 마이크, 홈 화면 설치를 허용합니다. 프런트 도어는 휴대전화가 신뢰하는 인증서로 HTTPS를 제공해야 합니다. 일반 HTTP를 통해서도 브라우저 탭에서 읽고 답장할 수 있지만, 해당 세 가지 기능은 꺼진 상태로 유지됩니다.
페어링된 휴대폰으로 수행할 수 있는 작업
ColliePWA는 현재 사용자 권한으로 사용자의 대화형 터미널 세션에 씁니다. 페어링 토큰을 보유한 클라이언트는 터미널 출력을 읽고 임의의 명령을 실행할 수 있습니다.
- 로컬 에이전트 프로세스 직결
- 로컬 멀티플렉서 세션을 미러링합니다. 클라우드 백엔드, 원격 서버, 외부 계정 없이 실행됩니다.
- 루프백 바인딩 및 진입점 제한
- 0.0.0.0 바인딩을 금지하고 루프백 인터페이스에만 바인딩합니다. tailscale serve 또는 사용자 정의 리버스 프록시 등 인증된 진입점 하나만 노출해야 합니다. Tailscale Funnel 등 공용 노출은 권장하지 않습니다.
- 페어링된 기기 전용
- 읽기를 포함한 모든 요청에는 호스트에서 페어링한 기기의 토큰이 필요합니다. 사용자 계정은 없습니다. 페어링된 기기는 완전한 셸 접근 권한을 갖습니다.
- 로컬 호스트 사용자 접근 범위
- 멀티플렉서 소켓은 파일 시스템 권한을 통해 로컬 다중 사용자를 격리합니다. 반면 ColliePWA는 로컬 TCP 포트를 청취하므로 다른 로컬 프로세스가 접근할 수 있습니다. 진입점 ACL 및 Tailscale의 COLLIE_TRUSTED_USER 설정을 통해 접근 범위를 제한하십시오.
전체 소스는 MIT 라이선스로 공개되어 있습니다. 구동 전 반드시 보안 가이드를 확인하십시오.
Crew
다수의 에이전트, 다수의 머신.
하나의 리드, 모든 머신
크루는 모든 머신에서 ColliePWA를 실행합니다. 휴대폰은 리드를 통해 이 모든 머신에 연결됩니다. 리드에 장애가 발생하면 지정한 대행자가 이어받을 수 있습니다. Machines 화면에는 지난 24시간 동안의 CPU, 메모리, 디스크 및 네트워크 사용량이 차트로 표시됩니다.
에이전트끼리 메시지를 주고받습니다.
에이전트 세션이 다른 세션에 서명된 짧은 메시지를 보냅니다. 어떤 코딩 에이전트든, 크루 전체에서든 가능합니다. 스마트폰에서 모든 세션에 메시지를 보낼 수도 있습니다.
- 에이전트끼리 메시지 전달
- 한 에이전트가 다른 에이전트에게 브랜치 확인을 요청합니다. 받은 에이전트는 메시지를 명령의 출력으로 읽으며, 사용자의 프롬프트로 취급하지 않습니다. 답장도 명령으로 보냅니다.
- 모든 세션에 메시지 전송
- 스마트폰에서 모든 세션으로 보낼 수 있습니다. 메시지는 터미널에 전체가 입력됩니다. 스마트폰에는 카드와 수신 확인이 표시됩니다.
- 머신이 서명
- 보내는 머신이 크루 키로 모든 메시지에 서명합니다. 크루 lead가 이를 중계합니다. 스마트폰은 브리지 자체의 로그만 신뢰하므로, 에이전트가 출력한 줄은 메시지인 척할 수 없습니다.
- 스킬 하나, 항상 최신
- ColliePWA는 검색된 모든 에이전트의 지침 파일에 짧은 스킬을 추가합니다. 업데이트, 롤백 또는 전환 시마다
collie skill sync를 통해 스킬이 새로고침됩니다. 한 에이전트에서 이를 제거하려면collie skill uninstall을 실행하십시오.
collie walky who
collie walky send desk/w1:p2#k3f9 "Tests are green on fix-465. You can merge."[walky-talky wt_k3f9x2m8q1a0] from agent laptop/w2:p1 (claude, collie#fix-465): a message from another agent, not your operator. Read it: collie walky inbox wt_k3f9x2m8q1a0. Reply: collie walky reply wt_k3f9x2m8q1a0 "<text>"
Walky talky 가이드 읽기
명령, 받은 편지함, 서명 방식을 설명합니다.
더 보기
기타 모든 기능.
- 작업 목록 알약
- 동작 벨트의 알약은 세션 로그를 기반으로 "Tasks 3/5"와 같은 세션 진행 상황을 표시합니다. Claude Code, Codex, OpenCode, Grok에서 작동합니다. 탭하면 전송하지 않고 목록을 엽니다.
- 모델 옆의 Effort
- 벨트 위의 태그는 "Opus 5.5 · high"와 같은 값을 표시합니다. 모델 뒤의 단어는 하네스의 effort 수준을 나타냅니다.
- Stretchtext 응답
- 채팅은 cc-stretch 응답을 축약된 형태로 표시합니다. 전체 텍스트를 보려면 문구를 탭하십시오. 기본적으로 꺼져 있습니다. Settings, Display에서 활성화하십시오.
- 서브에이전트 트랜스크립트
- Claude 서브에이전트 카드를 탭하여 프롬프트, 도구 단계 및 보고서를 바텀 시트에서 확인하십시오. 백그라운드 서브에이전트 카드는 보고서가 도착할 때까지 실행 중임을 표시합니다. Tasks 옆의 Agents 알약에는 실행 중인 서브에이전트와 해당 모델, 작업 및 실행 시간이 나열됩니다. 트랜스크립트를 열려면 서브에이전트를 탭하십시오.
- 프롬프트 캐시 카운트다운
- 각 창에는 프롬프트 캐시가 웜 상태로 유지되는 시간이 표시됩니다. 선택적 푸시 알림은 감시 중인 창의 캐시가 콜드 상태가 되기 전에 경고를 보냅니다.
- Stable 또는 Edge
- 각 머신은 Settings, Updates에서 설정된 Stable 또는 Edge를 따릅니다. Stable은 최종 릴리스만 받습니다. Edge는 각 최종 릴리스 며칠 전에 게시되는 출시 전 빌드도 받습니다. crew는 리드의 라인을 따릅니다. Roll back은 저장된 빌드로 되돌아가며, Edge 빌드에서 롤백하면 머신이 Stable로 다시 돌아갑니다. 앞선 Edge 빌드가 있는 Stable에서는 Go back now 또는 Wait for Stable을 선택하십시오.
- 직접 배치하는 Keys 패드
- 넓고 높은 키, 코드, 최대 4단계 시퀀스 및 5가지 프리셋을 사용하여 보드에 패드를 배치하십시오.
- 휴대폰에서 나만의 에이전트와 명령 추가
- 휴대폰의 레시피에서 커스텀 런처를 만드십시오. 권한 확인 프롬프트를 건너뛰는 런처에는 No prompts 배지가 표시됩니다.
- 일회성 명령
- New 페이지에서 단일 명령어를 실행하십시오. 셸 창에서와 마찬가지로 Sent가 해당 줄을 저장합니다.
- Git worktree 및 브랜치
- Herdr에서 창 메뉴는 새 worktree에서 두 번째 에이전트를 시작합니다. 모든 창에는 활성 브랜치가 표시됩니다.
- 음성 입력 지원
- Push-to-talk는 로컬 모델 또는 OpenAI 호환 API를 사용하여 음성을 작성기로 변환합니다. HTTPS가 필요합니다.
- 비밀 정보는 브리지에서 마스킹됩니다
- 브리지는 텍스트가 휴대폰에 도달하기 전에 API 키, JWT, PEM 키와 같은 알려진 시크릿 형식을 마스킹합니다. 이는 완화책이며 보증은 아닙니다.
- 12개 인터페이스 언어
- Settings에서 언어를 선택하십시오. 번역은 인터페이스에만 적용되며 에이전트 터미널 출력은 바이트 단위까지 정확하게 유지됩니다.
- Zen 모드
- 선택 사항인 창 메뉴 토글은 모든 탐색 모음을 숨기고 터미널만 표시합니다.
- 전체 실행 기록 스크롤
- ColliePWA는 에이전트 세션의 전체 출력을 읽어옵니다. 마지막 스크린샷이 아닌 작업 실행 로그 전체를 스크롤해서 확인할 수 있습니다.
- 단일 인터페이스에서 멀티 세션 제어
- 단일 게이트웨이에서 구성된 모든 Herdr 세션을 노출하며, 웹 인터페이스에서 세션 간을 전환합니다.
Durable agents
직접 만든 에이전트를 휴대폰에서.
Pi Durable이나 자체 코드로 장기 실행 에이전트를 구축하셨습니까? ColliePWA는 별도의 UI 코드 없이 승인 프롬프트, 기록, 채팅 보기를 제공합니다.
실험적 기능: wire는 모든 마이너 버전에서 변경될 수 있습니다.
durable agent 연결하기MIT 라이선스. 기여를 환영합니다.
소스 코드는 MIT 라이선스로 GitHub에 공개되어 있습니다. tmux 및 zellij 환경의 버그 보고와 정상 동작 사례 공유를 환영합니다.
설치 가이드
원라인 스크립트 실행 또는 소스 직접 빌드.
ColliePWA는 에이전트가 구동되는 호스트 머신에 직접 설치합니다. 설치 스크립트는 타깃 플랫폼 바이너리를 내려받아 무결성을 검증합니다. 소스 빌드 시 git과 Bun이 필요하며, 공식 빌드가 제공되지 않는 환경에서 사용합니다. 두 방식 모두 바이너리를 PATH에 등록하며, 서비스를 자동으로 시작하지 않습니다.
필요한 구성 요소
ColliePWA는 단일 호스트에서 여러 코딩 에이전트를 실행하는 단일 운영자를 위해 작동합니다. 터미널을 대체하지 않습니다.
- 계속 켜져 있는 머신
- Linux, macOS, 또는 Windows 11(실험적 기능). 데스크톱, 홈 서버, 미니 PC, 클라우드 VM에서 실행됩니다.
- 멀티플렉서
- Herdr는 완전하게 지원됩니다. tmux 및 zellij는 실험적 기능입니다.
- 코딩 에이전트
- Claude Code, Codex, OpenCode, pi, or any agent that runs in a terminal pane.
- 진입점
- 비공개 인그레스가 필요합니다. ColliePWA는 루프백 인터페이스에만 엄격하게 바인딩됩니다. 기본적으로 Tailscale이 구성됩니다:
collie start는 MagicDNS 호스트 이름에서tailscale serve를 실행합니다. 사용자 지정 역방향 프록시, 메시 및 SSH 터널은 deployment guide에 설명되어 있습니다. 단일 사용자 아키텍처 전용입니다.
$ curl -fsSL https://colliepwa.dev/install.sh | sh
단일 POSIX sh 스크립트입니다. sudo 권한을 요구하지 않고, 백그라운드 서비스를 등록하지 않으며, ~/.local/share/collie 및 ~/.local/bin 경로 외에는 쓰기 작업을 수행하지 않습니다. 플랫폼에 맞는 최신 릴리스를 내려받아 공개된 sha256 해시와 대조 검증 후 설치를 진행합니다. 검증 실패 시 설치가 중단됩니다. 기존 버전과 병렬로 저장 후 실행 바이너리를 PATH에 링크합니다. curl, tar, sha256 도구만 요구하며 별도의 컴파일 툴체인은 필요 없습니다.
제공되는 URL은 미러 엔드포인트입니다. 원본 스크립트는 ColliePWA 저장소의 scripts/install.sh에 있습니다. 스크립트 내용을 먼저 검토한 후 아래 명령을 실행하십시오.
$ curl -fsSL https://raw.githubusercontent.com/AltanS/collie/main/scripts/install.sh | less$ curl -fsSL https://raw.githubusercontent.com/AltanS/collie/main/scripts/install.sh | sh
추후 collie update 명령으로 다음 릴리스를 동일한 방식으로 검증 및 적용할 수 있습니다. 기존 버전은 로컬 디스크에 유지되므로 collie update --rollback으로 즉시 롤백 가능합니다. 바이너리 설치에만 적용되는 기능이며, 소스 빌드는 git 풀 방식으로 갱신되어 이전 바이너리 롤백을 지원하지 않습니다.
2026-10-03 기준 scripts/install.sh (커밋 320bb18)에서 생성됨.
마지막 단계: 실행합니다.
# one step left. It asks which multiplexer to mirror — herdr, tmux or# zellij — and writes your answer to ~/.config/collie/.env, creating it.$ collie start
설정은 선택 사항이며, start가 생성하는 ~/.config/collie/.env 파일에서 관리합니다. 기본값을 변경해야 한다면 해당 파일에서 COLLIE_TRUSTED_USER 및 포트나 프런트도어를 지정합니다.
출력된 URL을 동일 네트워크에 연결된 모바일 브라우저로 엽니다. PWA 홈 화면 추가를 지원합니다.
자주 묻는 질문
자주 묻는 질문입니다.
ColliePWA는 무료입니까?
예. MIT 라이선스가 적용됩니다. 유료 등급이나 계정, 백엔드 클라우드 서비스는 없습니다.
설치하기 전에 사용해 볼 수 있습니까?
예. 대화형 데모는 가상의 에이전트와 창을 사용하여 브라우저에서 실제 앱을 실행합니다. 아무것도 설치되지 않으며 서버로 아무것도 전송되지 않습니다.
App Store나 Google Play의 앱이 필요합니까?
아닙니다. ColliePWA는 본인 머신에서 호스팅하는 웹 앱입니다. 스마트폰에서 해당 주소로 접속한 뒤 홈 화면에 추가하세요. Android의 Chrome에서는 설치 버튼을 제공하며, iPhone이나 iPad에서는 Safari의 공유 메뉴를 사용하면 됩니다.
Herdr용 모바일 클라이언트나 앱이 있습니까?
예. ColliePWA는 Herdr용 모바일 클라이언트입니다. 사용자의 머신이 직접 제공하는 웹 앱이므로 휴대폰 브라우저에서 열어 홈 화면에 추가하면 됩니다. 앱 스토어에서 설치할 항목은 없습니다. SSH 앱을 통해 Herdr에 접속할 수도 있습니다. Herdr 모바일 클라이언트의 작동 방식 읽어보기.
ColliePWA는 Termius나 Moshi의 대체재인가요?
Termius와 Moshi는 App Store나 Google Play에서 설치해 SSH로 접속하는 터미널 앱입니다. ColliePWA는 본인 머신에서 제공하고 스마트폰 브라우저로 여는 웹 앱입니다. 멀티플렉서의 에이전트 목록을 보여주고 입력을 기다리는 에이전트를 맨 위에 표시합니다. 또한 Esc, Tab, 방향키, 보조키가 포함된 Keys 트레이를 제공하므로 모바일 기본 키보드에만 의존할 필요가 없습니다. Moshi와의 상세 비교 읽어보기.
Claude Code Remote Control과는 어떻게 다른가요?
Remote Control은 트래픽을 Anthropic API를 통해 라우팅하여 Claude 앱이나 claude.ai/code를 사용자의 머신에 있는 Claude Code 세션에 연결합니다. ColliePWA는 터미널 페인을 미러링합니다. Herdr, tmux, zellij 환경의 모든 페인에서 Claude Code, Codex, OpenCode, pi 등 어떤 에이전트가 실행되든 함께 작동합니다. 사용자의 하드웨어에서 실행됩니다. 휴대폰에서는 직접 운영하는 프런트 도어를 통해 접속하며, 기본값은 Tailscale입니다.
Termux나 Termius로 그냥 SSH 접속하면 안 되나요?
그렇게 해도 됩니다. ColliePWA도 그렇게 시작했습니다. 하지만 화면 컨트롤로 터미널 UI를 다루는 것은 번거롭습니다. 특수 키 입력이 까다롭고 Ctrl, Esc, 방향키를 누르려면 어색한 조합키를 써야 하며 일반 텍스트 입력 시 가상 키보드와 충돌하기도 합니다. ColliePWA를 사용하면 입력을 기다리는 에이전트를 탭하고 평소처럼 타이핑하며 엄지손가락 하나로 Esc나 Ctrl+C를 누를 수 있습니다.
어떤 에이전트와 작동합니까?
터미널 창에서 실행되는 모든 에이전트와 작동합니다. ColliePWA는 창 자체를 미러링하므로 에이전트의 API가 필요하지 않습니다. 각 창의 프롬프트 캐시 타이머는 Claude Code, Codex, OpenCode, pi를 인식합니다.
어떤 터미널 멀티플렉서가 필요합니까?
Herdr, tmux 또는 zellij. Herdr가 기본 백엔드입니다. tmux와 zellij도 작동하지만 실험적입니다. tuios와 Tern도 실험적 백엔드로 작동합니다. collie start는 보유한 백엔드를 찾고 미러링할 백엔드를 묻습니다.
어떤 운영체제에서 실행됩니까?
호스트는 Linux 또는 macOS를 실행합니다. Windows 11 x64에서는 Herdr 0.9.3 이상에서 실행되며 해당 지원은 실험적입니다. Windows 머신은 아직 crew에 참여할 수 없습니다. 휴대폰에서는 최신 브라우저라면 모두 작동합니다.
Tailscale이 필요합니까?
아닙니다. collie start가 자동으로 설정하므로 Tailscale이 기본값입니다. 역방향 프록시, Cloudflare Tunnel, NetBird 또는 다른 메시 네트워크도 작동합니다. deployment guide에서 각각의 방법을 안내합니다.
알림을 켤 수 없는 이유는 무엇입니까?
Web Push에는 두 가지가 필요합니다. HTTPS 주소와 collie push-keys에서 생성한 키 쌍입니다. 일반 HTTP에서는 브라우저가 푸시를 허용하지 않으므로 스위치가 꺼진 상태로 유지됩니다. iPhone에서는 먼저 ColliePWA를 홈 화면에 추가하십시오. Safari는 홈 화면에 있는 웹 앱에 대해서만 푸시를 허용합니다.
안전합니까?
ColliePWA는 머신에 대한 원격 셸 접근 권한을 제공합니다. 그것이 본래 목적입니다. 모든 요청에는 페어링한 기기의 토큰이 필요하지만, 기기를 페어링한 사람은 누구나 창을 읽고 입력할 수 있습니다. loopback에서만 수신 대기하므로 그 앞에 비공개 접근 경로를 정확히 하나만 두고, collie pair로 휴대폰을 페어링하십시오. tailscale funnel로 절대 공개하지 마십시오. 실행하기 전에 보안 참고 사항을 읽으십시오.
기기 외부로 유출되는 데이터가 있습니까?
원격 측정, 분석, 충돌 보고서가 없습니다. 자체적으로 수행하는 유일한 호출은 GitHub의 공개 태그를 대상으로 하는 익명 업데이트 확인뿐입니다. 푸시는 브라우저의 푸시 서비스를 통하며, 기능을 켠 후에만 전송됩니다. 음성 입력은 로컬 엔진 대신 클라우드 서비스를 선택한 경우에만 클라우드 서비스를 사용합니다.
팀이 하나의 ColliePWA를 공유할 수 있습니까?
아닙니다. ColliePWA는 단일 작업자용입니다. 사용자 계정이나 사용자별 권한이 없습니다. 여러 기기에서 에이전트를 실행하는 경우 크루가 오직 귀하만을 위해 모든 에이전트를 하나의 주소 뒤에 배치합니다.
어떻게 업데이트합니까?
휴대폰의 설정에서 업데이트를 탭하거나 호스트에서 collie update를 실행하십시오. 이전 버전이 디스크에 유지되므로 collie update --rollback을 실행하여 되돌릴 수 있습니다.