Paseo는 Claude Code, Codex, Copilot, OpenCode, Pi 등 여러 코딩 에이전트를 하나의 인터페이스에서 실행하고 관리할 수 있는 오픈소스 오케스트레이션 도구다. 데스크탑 앱(Electron)과 모바일 앱(iOS/Android)을 모두 지원해 어디서든 에이전트 작업을 시작하고 추적할 수 있다. 2026년 6월 기준 GitHub ★8K를 넘어섰다.
왜 Paseo인가
AI 코딩 에이전트는 빠르게 늘어나고 있지만 각 도구마다 별도 CLI·UI를 써야 해 관리 부담이 크다. Paseo는 “One interface for Claude Code, Codex, Copilot, OpenCode, and Pi agents”를 슬로건으로 내세우며, 에이전트별 인터페이스를 전환하는 번거로움을 없앤다.
실무 사용 시나리오:
- 이동 중 모바일로 에이전트 작업 시작 → 귀가 후 데스크탑에서 이어받기
- 여러 에이전트를 같은 뷰에서 비교하며 실행
- 로컬 데몬이 에이전트 프로세스를 유지하므로 화면을 닫아도 작업 지속
아키텍처
Paseo는 데몬(daemon) 중심 구조를 취한다. 로컬에서 돌아가는 서버 프로세스가 에이전트를 관리하고, 다양한 클라이언트가 WebSocket으로 이에 접속한다.
| 패키지 | 역할 |
|---|---|
packages/server | Paseo 데몬 — 에이전트 프로세스 오케스트레이션, WebSocket API, MCP 서버 |
packages/desktop | Electron 데스크탑 앱 |
packages/app | Expo 모바일 앱 (iOS, Android, 웹) |
packages/cli | paseo CLI — 데몬 및 에이전트 워크플로 제어 |
packages/relay | 원격 접속용 릴레이 (셀프호스팅 TLS 지원) |
데몬이 실행되는 동안은 클라이언트를 닫아도 에이전트 작업이 계속 진행된다. 릴레이를 통해 외부 네트워크에서도 로컬 데몬에 접속할 수 있다.
MCP 서버 내장
packages/server에 MCP 서버가 포함되어 있어 Paseo를 MCP 도구로 활용하는 것도 가능하다. Claude Code나 다른 MCP 지원 클라이언트에서 Paseo 데몬에 명령을 보낼 수 있다.
설치
데스크탑 앱 (권장)
# paseo.sh에서 최신 릴리스 다운로드CLI (헤드리스/서버 환경)
npm install -g paseo
paseo daemon start데몬을 먼저 시작한 뒤, 모바일 앱이나 데스크탑 앱에서 접속한다.
Skills 지원
Paseo는 에이전트 스킬을 지원한다. Claude Code Routines처럼 반복 작업을 스킬로 저장해두면 어느 클라이언트에서든 호출할 수 있다.
라이선스
MIT — getpaseo/paseo
관련 문서
- claude-code — Paseo가 지원하는 주요 에이전트
- cc-switch — Claude Code·Codex·Gemini CLI를 단일 앱으로 관리하는 대안 도구
- open-agents — Vercel의 백그라운드 코딩 에이전트 플랫폼