Paseo는 Claude·Codex·Hermes 등 여러 에이전트를 병렬 실행하고, 한 에이전트가 다른 에이전트에 일을 맡기도록 만드는 로컬 퍼스트 오케스트레이션 플랫폼입니다.
도입 가치가 가장 큰 경우는 이미 여러 코딩 에이전트를 쓰면서 터미널·브랜치·작업 상태가 흩어져 있는 개인 개발자와 소규모 팀입니다. 반면 일반 문서 업무 자동화나 전사형 권한·감사 체계가 목적이라면 Paseo만으로는 부족합니다.
Paseo는 Claude Code·Codex·OpenCode·Pi·Hermes 등 서로 다른 코딩 에이전트를 로컬 환경에서 실행하고, 데스크톱·모바일·CLI로 감독하는 오픈소스 컨트롤 레이어입니다. 핵심은 단순한 멀티 채팅이 아니라, 한 에이전트가 다른 에이전트에 일을 나누는 교차 공급자 오케스트레이션입니다.
다만 “모든 AI를 자동으로 섞어 쓰는 범용 플랫폼”이라기보다, 이미 설치한 코딩 에이전트 CLI를 하나의 데몬에서 실행·분담·감독하는 개발자용 운영 도구로 이해하는 것이 정확합니다.
도입 가치가 가장 큰 경우는 이미 여러 코딩 에이전트를 쓰면서 터미널·브랜치·작업 상태가 흩어져 있는 개인 개발자와 소규모 팀입니다. 반면 일반 문서 업무 자동화나 전사형 권한·감사 체계가 목적이라면 Paseo만으로는 부족합니다.
여러 공급자의 코딩 에이전트를 같은 화면에서 동시에 실행하고 상태를 추적할 수 있습니다.
Claude가 계획하고 Codex가 구현하며 다른 에이전트가 리뷰하는 식의 계층형 흐름을 만들 수 있습니다.
에이전트는 내 Mac·PC·서버에서 실행되고, Paseo는 기존 CLI와 인증 정보를 그대로 사용합니다.
모델 API를 자동 라우팅하는 서비스가 아니라, 실행 가능한 코딩 에이전트 프로세스를 관리하는 도구입니다.
내 컴퓨터에 설치된 Claude Code·Codex·OpenCode·Pi·ACP 에이전트를 Paseo 데몬이 실행하고, 데스크톱·웹·모바일·CLI가 그 데몬에 연결되는 구조입니다.
프로젝트·워크스페이스·에이전트·터미널·브라우저·Diff를 한 화면에서 여는 운영 UI입니다.
내 Mac·Windows PC·서버에서 에이전트 프로세스를 시작하고 중지하며 상태와 작업 수명을 관리합니다.
Paseo가 모델을 대신 제공하지 않고, 이미 설치·로그인된 각 공급자의 CLI와 설정·Skill·MCP를 그대로 사용합니다.
OpenAI·Anthropic 등의 계정, 구독 또는 API 키는 별도로 준비해야 합니다.
코드 편집기 자체보다는 에이전트·워크스페이스·터미널·Diff를 관리하는 관제 도구에 가깝습니다.
메일·회계·CRM을 기본 제공하는 도구가 아니라 소프트웨어 개발 에이전트 운영에 초점이 있습니다.
Paseo의 차별점은 한 공급자 내부의 Subagent를 넘어서 서로 다른 공급자·모델·워크스페이스 사이로 작업을 넘길 수 있다는 점입니다.
사용자가 여러 에이전트 세션을 직접 열어 각 작업을 동시에 진행합니다.
메인 에이전트가 Paseo Tool·MCP·CLI를 통해 다른 공급자의 Worker를 생성하고 후속 업무를 전달합니다.
Loop·Heartbeat·Schedule을 이용해 CI 감시, 일일 이슈 정리, 재시도 작업을 지속합니다.
Hub를 통해 GitHub·Slack·Discord 멘션으로 에이전트를 시작하는 구성이 가능하지만 현재 Private Beta입니다.
| 구분 | Native Subagent | Paseo Subagent |
|---|---|---|
| 공급자 범위 | 부모와 같은 공급자 안에서 동작 | 설정된 다른 공급자·모델까지 선택 가능 |
| 작업 위치 | 부모 에이전트가 관리하는 현재 환경 | 현재 Workspace 또는 별도 Worktree Workspace 지정 |
| 수명 관리 | 부모 공급자에 종속 | Paseo 데몬이 관리하며 후속 메시지·중지·분리 가능 |
| 적합한 용도 | 같은 모델군 안의 빠른 분업 | 계획·구현·검증을 서로 다른 모델에 맡기는 교차 검증 |
요구사항·수용 기준·작업 순서를 정의
Reasoning Agent별도 Worktree에서 코드 수정과 테스트
Codex / Claude관련 코드·문서·회귀 위험을 독립 조사
Hermes / GeminiDiff·테스트·복잡도·누락을 평가하고 반환
Different Provider메인 채팅은 설계와 통합을 담당하고, 구현 Worker와 독립 Reviewer를 별도로 생성합니다.
너는 메인 오케스트레이터로 남아 있어. Paseo에서 사용 가능한 구현용 모델을 확인한 뒤, main에서 분기한 별도 worktree를 만들고 첫 번째 에이전트에게 기능 구현과 테스트를 맡겨줘. 완료되면 같은 workspace에 다른 공급자의 리뷰 에이전트를 생성해 정확성, 누락 테스트, 불필요한 복잡도를 검토하게 해줘. 두 결과를 여기에서 하나의 최종 보고로 통합해줘.
같은 Workspace에서 여러 에이전트가 서로 다른 관점으로 조사하고, 파일 수정 없이 결과만 모읍니다.
이 workspace에 Paseo subagent 3개를 만들어줘. 1번은 요청 처리 경로를 추적하고, 2번은 관련 테스트와 누락된 경계 조건을 찾고, 3번은 비슷한 회귀 이력을 조사해줘. 모두 파일을 수정하지 말고 읽기 전용으로 작업한 뒤, 세 결과의 공통점과 충돌점을 종합해줘.
서로 다른 파일을 수정하더라도 안전하게 병렬화하려면 이슈마다 Git Worktree를 분리합니다.
이 두 이슈를 두 개의 Paseo subagent에 나눠줘. 각 이슈마다 main에서 분기한 별도 worktree workspace를 만들고, 가장 적합한 구현 모델을 선택해 수정과 집중 테스트를 실행하게 해줘. 완료 후 두 브랜치의 diff, 테스트 결과, 병합 순서를 비교해서 알려줘.
Heartbeat는 같은 에이전트 대화에 주기적으로 다시 프롬프트를 보내 상태를 확인하고 계속 작업하게 합니다.
Paseo heartbeat를 10분 간격으로 만들어줘. 이 PR의 CI를 계속 확인하고 새 실패가 생기면 원인을 분석해 수정해줘. 모든 체크가 통과하면 heartbeat를 중지하고, 2시간이 지나도 해결되지 않으면 현재 상태와 차단 요인을 보고해줘.
/paseo-handoff현재 맥락과 수용 기준을 다른 공급자의 에이전트에 넘깁니다.
/paseo-loop검증 조건이 충족될 때까지 Worker와 Verifier 흐름을 반복합니다.
/paseo-advisor파일을 수정하지 않는 조언자 에이전트를 호출해 판단을 보완합니다.
/paseo-committee서로 다른 관점의 고추론 에이전트가 원인과 계획을 독립 검토합니다.
가능합니다. Hermes Agent는 Paseo의 공식 ACP Provider Catalog에 포함되어 동일 UI에서 실행할 수 있습니다. 다만 Hermes를 메인 Orchestrator로 사용할 때는 선택한 버전과 ACP/MCP 노출 범위에서 Enable Paseo tools가 정상 제공되는지 먼저 확인하고, 초기에는 Hermes를 조사·문서 Worker로 배치해 검증하는 방식이 안전합니다.
단순한 에이전트 채팅 UI를 넘어, 병렬 개발에 필요한 Workspace·Git·터미널·브라우저·모바일 감독·자동 실행 기능을 하나로 묶습니다.
Claude Code·Codex·OpenCode·Pi의 First-class 지원과 ACP Catalog를 통해 다양한 에이전트를 같은 인터페이스에 배치합니다.
Bring your own account에이전트마다 별도 디렉터리와 브랜치를 만들어 동시에 수정해도 서로의 작업 파일을 덮어쓰지 않게 합니다.
병렬 개발 핵심에이전트 대화, 터미널, 파일, Diff, 브라우저, 로그를 같은 Workspace에서 나란히 열 수 있습니다.
관제 집중도 향상변경 Diff를 인라인 검토하고 브랜치 Commit, PR 생성, Checks 확인과 Merge까지 앱 안에서 이어갈 수 있습니다.
GitHub CLI 권장내 컴퓨터의 데몬에 iOS·Android 앱이 연결되어 외출 중에도 진행 상황, Diff, 터미널과 에이전트를 확인할 수 있습니다.
E2E Relay 선택음성 입력·읽기를 로컬 ONNX 모델로 처리하거나 OpenAI 음성 Provider를 선택할 수 있습니다.
한국어 로컬 STT 주의앱 기능을 터미널 명령으로 자동화하고, JSON Schema 출력으로 다른 스크립트나 CI 파이프라인에 연결할 수 있습니다.
paseo run · ls · send정해진 Cron에 새 에이전트를 시작하거나 기존 에이전트에게 주기적으로 상태를 재평가하도록 할 수 있습니다.
일일 triage · CI 감시GitHub Issue·PR, Slack·Discord 멘션으로 에이전트를 시작하는 팀용 상위 서비스가 제공되지만 현재 Private Beta입니다.
Self-hosted firstDesktop 앱은 데몬을 포함하므로 가장 간단합니다. 공통 전제는 Paseo가 사용할 코딩 에이전트 CLI를 먼저 설치하고 로그인해 두는 것입니다.
Apple Silicon·Intel DMG 또는 Homebrew Cask 지원
brew install --cask paseo # 예시 Provider: Codex CLI npm install -g @openai/codex codex login # Paseo orchestration skills npx skills add getpaseo/paseo
Dock·Finder에서 실행한 앱은 터미널과 PATH가 다를 수 있습니다. Paseo는 로그인 셸 환경을 읽으므로 nvm·mise·asdf 초기화가 새 로그인 셸에서도 동작하도록 .zprofile / .zshrc를 점검하고 앱을 재시작하세요.
Apple Silicon Mac mini를 상시 데몬으로 두고, 노트북·아이폰에서 Relay로 연결하면 이동 중 감독과 야간 Schedule 운영에 유리합니다.
공식 x64·ARM64 Setup EXE 제공, 데몬·CLI 네이티브 지원
# Paseo는 공식 x64 또는 ARM64 Setup EXE 설치 # 예시 Provider: Codex CLI npm install -g @openai/codex codex login # 경로 확인 where.exe codex # Paseo orchestration skills npx skills add getpaseo/paseo
터미널에서는 실행되지만 Paseo가 못 찾으면 앱을 완전히 종료 후 다시 열고 Provider Diagnostic을 확인하세요. 필요하면 config.json에 실행 파일의 절대 경로를 지정할 수 있습니다.
Paseo 자체는 Windows 네이티브 빌드를 제공합니다. 다만 연결할 개별 Agent CLI·빌드 도구가 Windows를 완전히 지원하지 않으면 WSL 또는 별도 Linux Dev Box를 실행 Host로 쓰는 편이 안정적일 수 있습니다.
| 항목 | macOS | Windows |
|---|---|---|
| 공식 Desktop | Apple Silicon ARM64·Intel x64 DMG, Homebrew Cask | x64·ARM64 Setup EXE |
| 환경 변수 처리 | 앱 시작 시 로그인 셸을 읽어 터미널 PATH를 보완 | 앱이 실행될 때 전달된 Windows 환경을 사용 |
| 일반 점검 명령 | which -a codex · 새 Terminal에서 실행 확인 | where.exe codex · 앱 완전 재시작 |
| 로그 위치 | ~/Library/Logs/Paseo/main.log | %APPDATA%\Paseo\logs\main.log |
| Worktree 명령 | zsh/bash 기반 예제가 자연스럽게 동작 | PowerShell·cmd·Git Bash 중 팀 표준에 맞춰 setup script 검증 필요 |
| 권장 선택 | 상시 실행 Mac mini·Apple Silicon 개발 환경과 높은 궁합 | Windows 네이티브 개발이 중심이면 적합, 일부 CLI는 WSL 필요 여부 별도 확인 |
Claude·Codex·Hermes 등 최소 하나를 설치하고 자체 로그인까지 완료
작업할 저장소나 일반 폴더를 Paseo의 Project로 등록
같은 폴더 공유 또는 Git Worktree 격리를 업무 특성에 맞게 선택
Provider·모델·모드·권한과 Prompt를 선택해 실행
Paseo Tool과 Skill로 Subagent, Loop, Advisor를 구성
Diff·테스트·PR·Checks를 확인하고 Commit·Merge 또는 Archive
Paseo가 코드를 중앙 서버로 프록시하지 않는다는 점과, 에이전트가 내 사용자 권한으로 파일·터미널·자격 증명에 접근할 수 있다는 점을 동시에 봐야 합니다.
Paseo의 가치는 에이전트 수가 늘고 병렬 작업이 복잡해질수록 커집니다. 처음부터 많은 Provider를 연결하기보다 한 저장소에서 2개 역할을 분리해 생산성과 안전성을 검증하는 것이 좋습니다.
“여러 코딩 Agent의 병렬 개발과 감독”이 핵심인지, 일반 업무 자동화가 핵심인지 먼저 구분합니다.
계획·구현 또는 구현·리뷰처럼 역할이 명확한 두 Agent만 연결해 품질 차이를 측정합니다.
paseo.json의 setup·test·service 명령을 정리해 어느 OS에서도 동일한 작업 환경을 재현합니다.
Paseo 비용은 0원이지만 각 Provider 구독·API 비용과 실행 Host·보안 운영 비용은 별도 관리합니다.
Mac 또는 Windows 한 대에 안정판 설치, Provider 1~2개 연결, PATH와 기본 Prompt 확인
작은 기능을 구현 Agent와 Reviewer로 분리하고 Diff·테스트·Merge 흐름 측정
E2E Relay Pairing, Schedule·Heartbeat로 CI 감시와 일일 Triaging 시험
허용 Provider, 승인 수준, Repo 접근 범위, 비용 상한, 로그·업데이트 절차 문서화
| 사용 환경 | 판단 | 이유 | 권장 방식 |
|---|---|---|---|
| 개인 개발자·1인 창업 | 도입 추천 | 여러 Agent·프로젝트·모바일 감독의 효율이 즉시 체감될 가능성 | Stable Desktop + 2 Provider + Worktree |
| 2~10명 개발팀 | 통제된 Pilot | 분업·리뷰 자동화 가치가 크지만 Repo 권한·비용·표준 Script 합의 필요 | 팀 공용 Dev Box보다 개인 Host Pilot부터 |
| 대기업·규제 산업 | 보안 검증 후 | Hub·RBAC·Sandbox·감사 요구를 현재 기능만으로 충족하기 어려울 수 있음 | 격리된 PoC, 보안 심사, Provider Enterprise 정책 병행 |
| 비개발 업무 자동화 | 주력 도구 아님 | 메일·CRM·보고서 자동화보다 Coding Agent 실행과 Git 흐름에 초점 | Hermes·n8n·업무형 Agent 플랫폼을 별도 검토 |
Paseo는 여러 AI 모델의 답을 단순 비교하는 앱이 아니라, 로컬 개발 환경과 Git Worktree 위에서 Agent를 실제로 병렬 실행하고 서로 위임시키는 운영층입니다. Mac과 Windows 모두 공식 지원하지만, 성공적인 도입 여부는 Provider CLI의 안정성, PATH·Shell 구성, Repository 격리와 승인 정책에 달려 있습니다.
업데이트 속도가 빠른 프로젝트이므로 Stable과 Beta를 분리해 운영하고, Provider·Worktree·Windows 회귀 여부를 업데이트 때마다 확인해야 합니다.
Commit history·Command Center 모델 전환·Service port 관리 등 0.2 계열 기반 기능 확장.
공식 Download 페이지의 기본 안정판. macOS ARM64·x64, Windows x64·ARM64 등 정식 빌드 제공.
실행 중 Agent Fork, HTML Preview, Mobile Terminal 개선, Skill 선택 설치 등 차기 기능을 대거 추가.
앱을 벗어났다가 돌아와도 Terminal 출력이 계속 갱신되도록 Beta 안정성을 보완.
실무 도입은 v0.2.5 Stable, 별도 테스트 Host에서만 v0.3.0-beta.2를 검증하는 방식을 권장.
본 보고서는 Paseo 공식 웹사이트·공식 문서·GitHub 저장소와 Release 정보 중심으로 작성했습니다. 기능과 버전은 빠르게 바뀔 수 있으므로 설치 직전 공식 페이지를 다시 확인하세요.