Mohamed Boudra
3dbbbb535e
* feat(website): rework sponsorship with homepage sponsor spots The founder note now states how the project is funded (sponsorship and Paseo Hub) instead of describing the product, and the same note and backing links render on the homepage and /sponsor from one module so the two cannot drift. Companies can sponsor one of four homepage logo spots at $500 a month through Stripe rather than GitHub Sponsors, because they need invoices and a vendor relationship. The spots render as placeholders until sold; approving a sponsor is an entry in src/data/sponsors.ts. The checkout URL is a placeholder until the Stripe Payment Link exists. * feat(website): point sponsor spot checkout at the Stripe payment link * docs(readme): add a sponsors section * docs(readme): add the sponsors section to the translated READMEs * docs(website): document the sponsor approval and Stripe cap workflow
7.5 KiB
Paseo
Claude Code, Codex, Copilot, OpenCode, Pi 에이전트를 위한 하나의 인터페이스
내 컴퓨터에서 에이전트를 병렬로 실행하세요. 데스크톱이나 휴대폰에서 배포하세요.
- 셀프 호스팅: 에이전트는 완전한 개발 환경이 갖춰진 내 컴퓨터에서 실행됩니다. 평소 쓰던 도구, 설정, 스킬을 그대로 쓸 수 있습니다.
- 여러 제공자 지원: Claude Code, Codex, Copilot, OpenCode, Pi를 하나의 인터페이스에서 사용할 수 있습니다. 작업마다 알맞은 모델을 고를 수 있습니다.
- 음성 제어: 음성 모드에서 작업을 말로 지시하거나 문제를 음성으로 함께 검토할 수 있습니다. 손을 쓰지 않고 작업해야 할 때 유용합니다.
- 여러 기기 지원: iOS, Android, 데스크톱, 웹, CLI를 지원합니다. 데스크톱에서 시작해 휴대폰으로 확인하고 터미널에서 자동화할 수 있습니다.
- 개인정보 보호 우선: Paseo는 텔레메트리, 추적, 강제 로그인을 사용하지 않습니다.
시작하기
Paseo는 코딩 에이전트를 관리하는 로컬 서버인 데몬을 실행합니다. 데스크톱 앱, 모바일 앱, 웹 앱, CLI 같은 클라이언트가 이 데몬에 연결합니다.
준비 사항
아래 에이전트 CLI 중 하나 이상을 설치하고 인증 정보를 설정해야 합니다.
데스크톱 앱(권장)
paseo.sh/download 또는 GitHub 릴리스 페이지에서 다운로드하세요. 앱을 열면 데몬이 자동으로 시작됩니다. 별도로 설치할 것은 없습니다.
휴대폰에서 연결하려면 설정 → 호스트 → 기기 페어링을 여세요.
CLI / 헤드리스 환경
CLI를 설치하고 Paseo를 시작하세요.
npm install -g @getpaseo/cli
paseo
Paseo가 로컬에서 시작된 뒤 기기 페어링을 위한 종단 간 암호화 릴레이를 켤지 묻습니다. 거절하면 TCP, Tailscale 또는 다른 VPN으로 직접 연결할 수 있습니다. 이 방식은 서버나 원격 머신에서 유용합니다.
자세한 설치와 설정은 아래 문서를 참고하세요.
Docker
Docker에서 Paseo 데몬과 셀프 호스팅 웹 UI를 실행하세요:
docker run -d --name paseo \
-p 6767:6767 \
-e PASEO_PASSWORD=change-me \
-v "$PWD/paseo-home:/home/paseo" \
-v "$PWD:/workspace" \
ghcr.io/getpaseo/paseo:latest
컨테이너가 시작되면 http://localhost:6767을 여세요. 사용하는 에이전트 CLI를 기본 이미지에 추가한 뒤, 환경 변수나 영구 /home/paseo 볼륨으로 인증 정보를 설정하세요. 자세한 내용은 Docker 문서를 참고하세요.
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" # 후속 작업 전송
# 원격 데몬에서 실행
paseo --host workstation.local:6767 run "run the full test suite"
자세한 내용은 전체 CLI 레퍼런스를 참고하세요.
스킬
스킬은 에이전트가 Paseo를 통해 다른 에이전트를 오케스트레이션하는 방법을 알려 줍니다.
npx skills add getpaseo/paseo
그런 다음 어떤 에이전트 대화에서든 아래 명령을 사용할 수 있습니다.
/paseo-handoff— 에이전트 간에 작업을 넘깁니다. Claude로 계획을 세운 뒤 Codex에 구현을 넘길 때 이 기능을 씁니다./paseo-advisor— 작업 자체를 넘기지 않고, 에이전트 하나를 조언자로 띄워 두 번째 의견을 받습니다./paseo-committee— 서로 다른 관점의 에이전트 두 개로 위원회를 구성해, 한 발 물러나 근본 원인을 분석하고 계획을 세웁니다.
개발
모노레포 패키지 구성은 다음과 같습니다.
packages/server: Paseo 데몬(에이전트 프로세스 오케스트레이션, WebSocket API, MCP 서버 제공)packages/app: Expo 클라이언트(iOS, Android, 웹)packages/cli:paseoCLI(데몬과 에이전트 워크플로)packages/desktop: Electron 데스크톱 앱packages/relay: 데몬과 클라이언트가 쓰는 릴레이 전송 및 암호화 패키지packages/website: 마케팅 사이트 및 문서(paseo.sh)
자주 쓰는 명령:
# 모든 로컬 개발 서비스 실행
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
스폰서
Paseo는 한 사람이 개발하며, 사용하는 분들의 후원으로 운영됩니다. GitHub Sponsors로 후원하거나, 월 500달러에 스폰서 자리를 구매하여 회사 로고를 이곳과 paseo.sh 홈페이지에 게재할 수 있습니다.
관련 프로젝트
- getpaseo/paseo-relay — Elixir로 작성한 공식 분산형 릴레이
- paseo-skins — 커뮤니티 테마와 Agent Skill을 제공하고, 코드 수정 없이 쓸 수 있는 데스크톱 테마 로더
- paseo-vscode — VS Code 확장 프로그램
라이선스
Apache-2.0