Paseo: Claude Code, Codex, Copilot, OpenCode 및 Pi 에이전트를 위한 오픈소스 인터페이스

Paseo는 오픈소스 코딩 에이전트 인터페이스로, Claude Code, Codex, GitHub Copilot, OpenCode, Pi 에이전트를 하나의 대시보드에서 실행할 수 있습니다. 휴대폰, 데스크톱, CLI 어디서든 사용 가능하며, 자체 호스팅, 프라이버시 중심, 음성 제어를 지원합니다.

작동 방식

Paseo는 로컬 데몬을 실행하여 에이전트 프로세스를 관리합니다. 클라이언트(데스크톱 앱, 모바일 앱, 웹 앱, CLI)는 WebSocket으로 데몬에 연결됩니다. 에이전트는 여러분의 머신에서 전체 개발 환경, 도구, 설정, 스킬을 그대로 사용하며 작업을 수행합니다.

주요 기능

• 멀티 프로바이더: 동일한 인터페이스로 Claude Code, Codex, Copilot, OpenCode, Pi 사용. 작업에 적합한 모델 선택 가능.
• 음성 제어: 작업을 말로 지시하거나 문제를 핸즈프리로 논의.
• 크로스 디바이스: iOS, Android, 데스크톱, 웹, CLI 지원. 책상에서 시작하고, 휴대폰으로 확인하며, 터미널에서 스크립트 작성.
• 프라이버시 우선: 텔레메트리, 추적, 강제 로그인 없음.
• 병렬 에이전트: 여러 에이전트를 동시에 실행 가능.

시작하기

필수 조건: 최소 하나의 에이전트 CLI가 설치 및 설정되어 있어야 합니다. 데스크톱 앱을 권장합니다. paseo.sh/download 또는 GitHub 릴리스 페이지에서 다운로드하세요. 앱을 열면 데몬이 자동으로 시작됩니다. 휴대폰에서 연결하려면 설정에서 QR 코드를 스캔하세요.

CLI / 헤드리스 설정:

npm install -g @getpaseo/cli
paseo

터미널에 QR 코드가 표시됩니다. 클라이언트에서 연결하세요.

CLI 명령어 (출처에서 재현)

에이전트 실행, 리스트, 실시간 출력 연결, 후속 작업 전송:

paseo run --provider claude/opus-4.6 "implement user authentication"
paseo run --provider codex/gpt-5.4 --worktree feature-x "implement feature X"
paseo ls
paseo attach abc123
paseo send abc123 "also add tests"

--host로 원격 데몬 연결:

paseo --host workstation.local:6767 run "run the full test suite"

스킬 (에이전트 오케스트레이션)

스킬을 설치하여 에이전트가 다른 에이전트를 오케스트레이션하도록 학습:

npx skills add getpaseo/paseo

에이전트 대화에서 사용:

• /paseo-handoff — 에이전트 간 작업 인계 (예: Claude로 계획, Codex로 구현)
• /paseo-loop — 에이전트를 승인 기준에 대해 반복 (Ralph 루프), 선택적으로 검증기
• /paseo-advisor — 단일 에이전트를 조언자로 실행하여 두 번째 의견
• /paseo-committee — 두 가지 대조 에이전트로 위원회 구성, 근본 원인 분석 및 계획

개발

모노레포 패키지:

• packages/server — 데몬 (에이전트 오케스트레이션, WebSocket API, MCP 서버)
• packages/app — Expo 클라이언트 (iOS, Android, 웹)
• packages/cli — 데몬 및 에이전트 워크플로 CLI
• packages/desktop — Electron 데스크톱 앱
• packages/relay — 원격 연결
• packages/website — 마케팅 사이트 및 문서

공통 명령어:

npm run dev
npm run dev:server
npm run dev:app
npm run dev:desktop
npm run dev:website
npm run build:server
npm run typecheck

자체 호스팅 릴레이

원격 데몬 접근을 위해 자체 호스팅 Go 릴레이 사용. 참고: 자체 호스팅 릴레이는 TLS를 선택하지 않으면 ws://를 사용합니다. 환경 변수로 설정:

PASEO_RELAY_ENDPOINT=127.0.0.1:8080
PASEO_RELAY_PUBLIC_ENDPOINT=relay.example.com