AgentDeck은 코딩 에이전트(Claude Code, Codex, Cursor, pi)를 휴대폰에서 접속할 수 있는 원격 서비스로 만들어 줍니다. Tauri 2, Gem, Tap UI, Tailwind CSS, Rsbuild로 개발된 모바일 ACP(Agent Client Protocol) 클라이언트입니다.
작동 방식
AgentDeck(휴대폰) ⇄ 릴레이 ⇄ browser4agent(데스크톱) ⇄ Claude Code / Codex / Cursor / pi
1. 에이전트가 설치된 컴퓨터에서 browser4agent를 실행합니다. browser4agent의 에이전트 패널은 AgentDeck에서 사용하는 것과 동일한 ACP 에이전트와 통신합니다.
2. browser4agent 확장 프로그램 설정 페이지에서 릴레이 ID를 확인합니다. 이 UUID는 AgentDeck과 데스크톱을 연결하는 데 사용되며, 안전하고 안정적인 WebSocket 채널의 자격 증명 역할을 합니다.
3. AgentDeck 설정 페이지에 릴레이 ID를 입력합니다. AgentDeck은 릴레이에 연결하여 선택한 에이전트의 세션 목록을 작업 디렉터리별로 표시합니다.
4. 세션을 열어 기록을 재생하거나, 바닥글의 [새 세션 생성]을 탭하고 상담원 컴퓨터에서 작업 디렉터리를 선택하세요.
릴레이는 프로토콜에 구애받지 않고 영구적으로 작동합니다. 휴대폰이 오프라인 상태가 되더라도 상대방에서 전송된 메시지는 기록이 유지되며 앱이 다시 연결될 때 업데이트됩니다.
AgentDeck과 상담원 연결하기
1. browser4agent를 설치하고 네이티브 호스트를 등록합니다.
2. 확장 프로그램 설정 페이지를 열고 릴레이 ID를 복사합니다.
3. AgentDeck에서 [설정]을 열고 릴레이 ID를 붙여넣은 다음 상담원을 선택합니다.
4. 저장하면 앱이 릴레이(프로덕션 빌드에서는 wss://agent-deck.xianqiao.wang/ws)에 연결되고 세션 목록이 표시됩니다.
AgentDeck은 코딩 에이전트를 휴대폰에서 접속할 수 있는 원격 서비스로 전환해 줍니다.