Paseobility

프로젝트·브라우저·산출물·Paseo로 연결된 PC를 다루는 15개 스킬입니다.

English · 한국어

tools/paseo-bot에 상주형 Paseo bot v1을 추가했습니다. 연결된 모든 프로젝트의 PC·경로·검증 명령을 등록하고 내구성 있는 작업 큐에서 worktree 실행과 독립 검수를 진행합니다. Paseo bot 안내.

시작 전에

현재 패키지: v3.0.1. 기존 스킬 이름이 paseo-<이름>에서 ps-<이름>으로 바뀌고 카탈로그 ps, 명시 호출 기획·작성 스킬 ps-plan·ps-write가 추가되었습니다. 기존 설치본을 옮기는 방법은 릴리스 이력에 있습니다. 플러그인이 Paseo 0.12.x–0.15.x 및 확인한 0.16.0-beta.1를 지원하며, v2.12.11에서 0.14 이상을 거부하던 문제를 수정했습니다. 0.15.2 확인에 재현 결과, 컴파일러·SDK 버전별 검사, 실제 RPC·어댑터 실행과 UI 검증 한계를 기록했습니다. /ps-multi는 Paseo 0.11.2에서 Mac·Windows 조합을 검증했습니다. 전체 패키지의 기존 호환성 기준선은 0.10.2이며, 15개 스킬 전체가 0.11.2에서 검증된 것은 아닙니다. 0.12.0 보고서는 소스·CLI 정적 확인입니다. 0.13.0 보고서는 임시 0.12.0·0.13.0 데몬에서 플러그인 설치와 정리·multi 어댑터를 실제로 실행한 기록이며, 전체 스킬의 런타임 검증을 뜻하지 않습니다. Multi 검증 기록 · 전체 기준선 기록 · 0.12.0 정적 확인 · 0.13.0 확인.

v2.x에서 올라오는 모든 설치본은 아래 작업을 한 번 해야 합니다. v2 플러그인의 업데이트 버튼으로는 v3.0.0을 설치할 수 없습니다. "Invalid skill name"으로 멈추고 옛 스킬을 그대로 둡니다. 이 저장소를 받은 폴더에서 실행하세요.
./scripts/paseobility-init.sh --migrate-skills --with-claude --no-context   # macOS, Linux
.\scripts\paseobility-install.ps1 -MigrateSkills -WithClaude                # Windows
옛 paseo-<이름> 폴더는 설치 스크립트가 알려주는 백업 폴더로 옮겨집니다. 그다음 paseo plugin remove paseobility, paseo plugin add git:wilgon456/Paseobility:plugin 순서로 플러그인을 교체하고, 새 에이전트 세션을 시작하세요. 직접 써 둔 프롬프트나 설정의 스킬 이름도 바꿔야 합니다 (/paseo-god은 이제 /ps-god).

한 줄 요약

Paseobility는 사용자가 이 GitHub repo URL을 Codex, Claude, Paseo agent에게 던져 설치하게 만든 agent-installable Paseo 슬래쉬 스킬팩입니다.

설치되면 Paseo에서 자주 쓰는 browser use(웹 브라우저 조작), 멀티에이전트 오케스트레이션, 에이전트 토너먼트, 세션 브리프, 프로젝트 bootstrap, 설치 전 repo 보안 점검, 비활성 서브에이전트 정리와 기기 간 산출물 공유를 슬래쉬 명령처럼 꺼내 쓸 수 있습니다.

기본 Paseo만으로도 내장 도구를 조합하면 비슷한 일을 할 수 있습니다. 다만 매번 에이전트가 그 조합을 새로 판단하게 두면 느리고 결과가 들쭉날쭉할 수 있어서, 자주 쓰는 패턴을 바로 꺼내 쓰기 쉽게 묶었습니다.

이 repo는 Paseo 내장 도구를 반복 가능하게 조합하기 위한 스킬 패키지입니다. macOS/Linux용 bootstrap helper와 Windows PowerShell 설치 helper를 함께 제공합니다.

/ps <작업>은 여러 에이전트 홈의 로컬 스킬 목록을 읽고 맞는 전문 스킬 하나를 골라 원본 SKILL.md를 읽습니다. /ps list는 목록만 보여줍니다. Node 20+가 필요하며, 캐시·사용 기록을 남기거나 스킬을 복사하지 않습니다.

빠른 시작

먼저 스킬 하나를 설치해 볼 수 있습니다. macOS/Linux에서는 Git과 Bash, Windows에서는 Git과 PowerShell이 필요합니다. 이 예시는 선택 사항인 Cua Driver를 설치하지 않습니다.

git clone https://github.com/wilgon456/Paseobility.git
cd Paseobility
./scripts/paseobility-init.sh --skill ps-research --no-context
test -f ~/.agents/skills/ps-research/SKILL.md && echo '스킬 파일 설치됨'

git clone https://github.com/wilgon456/Paseobility.git
cd Paseobility
.\scripts\paseobility-install.ps1 -Skill ps-research
Test-Path (Join-Path $env:USERPROFILE '.agents\skills\ps-research\SKILL.md')

새 에이전트 세션을 열거나 연동을 다시 불러온 뒤 /ps-research 이 프로젝트가 어떻게 동작하는지 코드를 근거로 설명해줘라고 요청합니다. 파일이 있다는 확인은 현재 세션에서 스킬을 불러왔다는 뜻은 아닙니다. 전체 설치, Claude 지원과 드라이버 조건은 설치, 실제 검증 범위는 검증 상태를 참고하세요.

`/ps-god` — 명시 호출 작업 모드 (v0)

완료 조건을 먼저 정하고 필요한 디버깅·리뷰·실험 절차만 읽습니다. 작업마다 별도 TODO·검증 근거·재개 지점을 남깁니다. 학습 내용은 저장 후보로 제안하며, 기존 메모리나 설치된 스킬을 자동으로 고치지 않습니다. 선택형 Node 도우미는 기록을 만들고 재개할 뿐, 작업을 자동 실행하는 런타임이 아닙니다.

./scripts/paseobility-init.sh --skill ps-god --no-context

.\scripts\paseobility-install.ps1 -Skill ps-god

/ps-god 이 버그를 고치고 원래 증상으로 검증해줘. 막히면 재개 지점을 남겨줘.

범위·로컬 기록·검증 한계는 God 안내를 참고하세요. 기존 버전·플랫폼 검증 기록은 당시 범위를 유지합니다.

릴리스 이력에서 날짜별 변경과 당시 검증 범위를 확인할 수 있습니다.

사용 방식

이 프로젝트의 기본 사용자는 shell에서 직접 설치하는 사람이 아니라, AI 에이전트에게 GitHub URL을 주고 설치와 검증을 맡기는 사람입니다.

ps-share만 설치하려면 Codex 또는 Claude에 아래 문장 그대로 보내면 됩니다.

https://github.com/wilgon456/Paseobility

이 저장소의 지침을 읽고 ps-share만 이 컴퓨터에 설치하고 검증해줘.
기존 설치본은 백업하고 Paseo daemon은 재시작하지 마.
설치가 끝나면 새 세션/reload 방법과 최초 공유 요청 방법을 알려줘.

https://github.com/wilgon456/Paseobility

이 repo를 읽고 AGENTS.md 지침대로 내 로컬 Paseo skills 디렉터리에 설치해줘.
먼저 --target-home/-TargetHome 임시 경로로 설치 테스트하고, 통과하면 실제 skills 디렉터리에 설치해줘.
설치 후 새 Paseo 세션에서 /ps-project가 인식되는지도 확인해줘.

에이전트는 Codex/Paseo에서는 AGENTS.md, Claude Code에서는 CLAUDE.md를 읽고 OS별 경로와 설치 절차를 따라갑니다. 이 Paseobility 저장소는 설치 원본입니다. 실제 공유 artifact는 인증 계정의 private paseo_share 저장소에 보관하며, 설치만으로 저장소를 만들지는 않습니다.

해당 작업을 명시적으로 요청하면 다음 기능을 사용할 수 있습니다:

웹페이지를 열고, 읽고, 클릭하고, 입력하고, 스크린샷으로 검증합니다.
작업을 여러 에이전트에게 나눠 맡기고 결과를 합성합니다.
GPT/Claude/DeepSeek/Grok 같은 여러 모델의 답을 비교해 winner 또는 merged plan을 고릅니다.
GitHub URL이나 로컬 repo를 설치하기 전에 spyware/supply-chain 위험 신호를 읽기 전용으로 점검합니다.
직접 지정했거나 테스트 후 쌓인 disposable 표식이 있는 inactive agent를 archive하고, 일반 idle 세션은 보존하며 workspace는 승인 후 archive합니다.
작업 산출물을 private Git 공유함에 올리고 다른 컴퓨터나 모바일에서 바로 열거나 가져옵니다.
요청 시 repo 맥락, 명령어, 지침, 리스크를 한 장으로 요약합니다.
초기 설정을 요청할 때 README, docs, Claude/Codex/Cursor 계열 지침을 모아 작업 맥락을 만듭니다.
Codex로 구현하고 Claude로 리뷰하는 식의 크로스 프로바이더 협업을 설계합니다.
무한 루프, 위험한 제출, 계정 변경 같은 작업에는 명확한 가드레일을 둡니다.

들어있는 스킬

Skill	역할	이런 요청에 강함
`/ps`	필요할 때 읽는 로컬 스킬 목록	`/ps <작업>`으로 맞는 전문 스킬 선택, `/ps list`로 목록 확인. 여러 에이전트 홈의 원본을 복사·설치 없이 읽기
`/ps-plan`	명시 호출 기획·계획	현황 등급, 대안, 검증 가능한 수용 기준과 단계, 위험 대응을 담은 Markdown 계획서 한 개
`/ps-write`	명시 호출 문서 작성	출처 대조와 처음 읽는 독자 기준 점검. 한국어 초안은 고정 커밋의 `humanize-korean` 규칙집으로 윤문합니다.
`/ps-toss`	토스 미니앱 개발	기획, 구성, 브라우저 디버깅, 휴대폰 테스트와 출시 전 점검. 업로드에는 콘솔 인증이 필요합니다
`/ps-god`	명시 호출 실행·검증·재개	완료 조건, 디버깅·리뷰·실험, 작업별 기록과 학습 후보 제안
`/ps-browser`	브라우저 작업	설치된 Ego Lite의 TaskSpace 하나 또는 지정한 기존 Chrome 탭을 재사용하고, 사용자 탭 보존과 완료 정리를 확인
`/ps-cua`	네이티브 데스크톱 GUI 구동	trycua Cua Driver로 앱 창 조작·스냅샷·검증, 작업에 네이티브 앱 GUI가 필요할 때 동작
`/ps-orchestration`	다중 에이전트 조율과 비교	명시 요청한 조율 또는 토너먼트, 모드별 지침
`/ps-project`	프로젝트 요약과 설정	요청한 brief(없거나 오래된 `.paseobility` context 작성·갱신) 또는 환경·context 설정
`/ps-multi`	연결된 PC 조작	이름 또는 `all`(등록된 모든 호스트를 병렬로)로 대상 선택, 원격 상태·에이전트 확인, 인라인·파일 Bash·PowerShell 실행(`exec --command`, `--wait` 최대 300초), 업데이트 검증, 즉시 재시작을 요청했을 때만 `restart --force`, `import-saved`는 병합
`/ps-design`	웹·앱 프론트 워크플로	프로젝트 디자인 규칙, 기존 컴포넌트 활용과 화면 검토
`/ps-share`	컴퓨터·모바일 산출물 공유	private `paseo_share` 자동 준비, 50 MiB 이하 모든 파일 형식(한 번에 여러 개 게시 가능), 클릭 가능한 미리보기/다운로드 링크, 공유 ID 기반 검증·가져오기
`/ps-research`	근거 있는 조사	고정 커밋의 코드, 변경 이력, 버전별 공식 문서; 주장마다 관측·문서·추론·미확인 등급 표시
`/ps-spyware-check`	설치 전 보안/스파이웨어 정적 점검	GitHub URL, 로컬 repo, install script, secret, exfiltration, supply-chain 위험 확인
`/ps-agent-cleanup`	비활성 agent/workspace 정리	기본은 미리보기, 일반 idle 보존, 지정했거나 테스트 표식이 있는 후보는 바로 archive, 활성 agent 보호, workspace는 `--yes`가 있을 때만 archive

/ps-toss 기획부터 토스 미니앱을 만들어줘로 시작할 수 있습니다. 단일 설치는 ./scripts/paseobility-init.sh --skill ps-toss --no-context를 사용합니다.

설치

권장 설치 방식은 AI 에이전트에게 이 저장소 URL을 주고 설치를 맡기는 것입니다.

https://github.com/wilgon456/Paseobility
이 repo를 읽고 내 로컬 Paseo skills 디렉터리에 설치해줘.
Windows/Mac 환경에 맞춰 skills/*를 복사하고, 설치 후 필요한 reload 방법을 알려줘.

에이전트는 Codex/Paseo에서는 AGENTS.md, Claude Code에서는 CLAUDE.md를 기준으로 Mac/Windows의 skills 경로를 확인해 설치합니다. ps-share 요청은 전체 스킬팩 대신 해당 스킬만 설치합니다.

직접 설치도 가능합니다.

git clone https://github.com/wilgon456/Paseobility.git
cd Paseobility

# Paseo / Codex 계열 스킬만 설치
./scripts/paseobility-init.sh --no-context

# 특정 스킬만 업데이트하고 싶다면
./scripts/paseobility-init.sh --skill ps-agent-cleanup --no-context
./scripts/paseobility-init.sh --skill ps-spyware-check --no-context
./scripts/paseobility-init.sh --skill ps-share --no-context

# Claude Code에서도 같이 쓰고 싶다면
./scripts/paseobility-init.sh --with-claude --no-context

# 특정 프로젝트까지 바로 bootstrap하려면
./scripts/paseobility-init.sh --root /path/to/your/project

Windows PowerShell에서는:

git clone https://github.com/wilgon456/Paseobility.git
cd Paseobility

# Paseo / Codex 계열 스킬 설치
.\scripts\paseobility-install.ps1

# 특정 스킬만 업데이트하고 싶다면
.\scripts\paseobility-install.ps1 -Skill ps-agent-cleanup
.\scripts\paseobility-install.ps1 -Skill ps-spyware-check
.\scripts\paseobility-install.ps1 -Skill ps-share

# 임시 홈에 먼저 테스트 설치하고 싶다면
.\scripts\paseobility-install.ps1 -TargetHome $tmp.FullName

# Claude Code에서도 같이 쓰고 싶다면
.\scripts\paseobility-install.ps1 -WithClaude

Cua Driver 런타임

ps-cua를 선택하거나 전체 패키지를 설치하면 trycua Cua Driver 런타임도 함께 준비합니다. 다른 스킬만 선택하면 드라이버 부수 효과가 없습니다. 런타임 단계는 멱등하며, 이미 동작하는 드라이버는 재사용하고 자동 업그레이드하지 않습니다.

# ps-cua 선택 -> 드라이버 자동 준비
./scripts/paseobility-init.sh --skill ps-cua --no-context

# 스킬만, 런타임 없음 (문서 전용·오프라인)
./scripts/paseobility-init.sh --skill ps-cua --skip-cua-driver --no-context

# 사용자 지정 타깃 홈은 실제 호스트 런타임을 기본적으로 건너뜁니다
./scripts/paseobility-init.sh --target-home "$tmp" --no-context

# 사용자 지정 타깃 홈에서 실제 호스트 런타임 설치를 명시적으로 허용
./scripts/paseobility-init.sh --skill ps-cua --target-home "$tmp" \
  --allow-host-runtime --no-context

.\scripts\paseobility-install.ps1 -Skill ps-cua
.\scripts\paseobility-install.ps1 -Skill ps-cua -SkipCuaDriver
.\scripts\paseobility-install.ps1 -TargetHome $tmp.FullName
.\scripts\paseobility-install.ps1 -Skill ps-cua -TargetHome $tmp.FullName -AllowHostRuntime

드라이버 helper를 직접 실행할 수도 있습니다.

./scripts/paseobility-cua-driver.sh --check       # 존재만 확인 (없으면 exit 3)
./scripts/paseobility-cua-driver.sh --dry-run     # 실행 계획만 출력
./scripts/paseobility-cua-driver.sh               # 고정 드라이버 준비

런타임 단계가 실패하면 installer는 0이 아닌 코드로 종료하고 스킬은 복사되었지만 런타임 설정이 실패했음(설치가 불완전할 수 있음)을 알립니다. 다시 실행하거나 --skip-cua-driver / -SkipCuaDriver로 스킬만 설치하세요.

Doctor와 테스트

doctor는 읽기 전용이고 명령마다 제한 시간이 있으며 크로스플랫폼입니다(Python 3 표준 라이브러리). 텍스트 모드는 사람용이고, --json은 허용 목록 필드(상태, 개수, 검증된 스킬 이름, 정규화된 시맨틱 버전)만 담는 공유용 산출물이며 원시 명령 출력은 담지 않습니다. 종료 코드 0은 "리포트가 생성됨"을 뜻하며 "모두 준비됨"이 아닙니다. --source-root는 스킬 팩을, --target-home은 격리된 설치 루트를 지정합니다.

python3 scripts/paseobility-doctor.py --root /path/to/project
python3 scripts/paseobility-doctor.py --root /path/to/project --json
# 명시 시에만 MCP 프로토콜/도구 탐색 (데몬 실행 중 필요, GUI 테스트 아님):
python3 scripts/paseobility-doctor.py --root /path/to/project --check-mcp
# 임시 홈에 대한 격리 설치 검사:
python3 scripts/paseobility-doctor.py --target-home /tmp/isolated-home --json
# 같은 인자를 전달하는 얇은 래퍼:
./scripts/paseobility-doctor.sh --root /path/to/project

.\scripts\paseobility-doctor.ps1 -Root .
# Python helper와 동일한 플래그(-SourceRoot/-TargetHome/-CuaBin/-CuaBinDir):
.\scripts\paseobility-doctor.ps1 -SourceRoot . -TargetHome $tmp.FullName -Json

오프라인 테스트 스위트:

# macOS/Linux
python3 -m unittest discover -s tests -p "test_*.py" -v

# Windows (네트워크 없음, fixture installer 주입)
pwsh -NoProfile -File tests/test_cua_driver_runtime.ps1

installer는 기존 같은 이름의 skill이 있으면 덮어쓰기 전에 백업합니다.

OS	Backup path
macOS/Linux	`~/.agents/skills-backups/Paseobility-<version>-<timestamp>/`
Windows	`%USERPROFILE%\.agents\skills-backups\Paseobility-<version>-<timestamp>\`

백업 없이 강제로 교체해야 하는 경우 macOS/Linux는 --no-backup, Windows는 -NoBackup을 사용할 수 있습니다.

설치 후 Paseo 앱에서 새 에이전트를 시작하거나, Settings에서 통합/스킬을 다시 로드하세요.

수동 설치를 선호한다면:

mkdir -p ~/.agents/skills
cp -R skills/* ~/.agents/skills/

Windows 수동 설치:

New-Item -ItemType Directory -Force "$env:USERPROFILE\.agents\skills" | Out-Null
Copy-Item -Recurse -Force ".\skills\*" "$env:USERPROFILE\.agents\skills\"

요구사항

Paseo 데스크탑 앱
Paseo Settings -> Agents -> Enable Paseo tools 활성화
1개 이상의 AI 프로바이더
- 예: Codex, Claude Code 등
/ps-share는 Node.js와 Git 필요. 기본 GitHub 자동 온보딩에는 인증된 GitHub CLI(gh)가 필요하며, Forgejo·custom remote는 명시적인 저장소 URL로 연결. GitHub Actions는 사용하지 않음
/ps-cua는 trycua Cua Driver 필요. installer가 ps-cua 또는 전체 패키지 설치 시 자동으로 준비하며, macOS Accessibility·Screen Recording 권한은 수동으로 부여해야 함
오케스트레이션은 Paseo의 list_profiles를 우선 사용합니다. 기존 ~/.paseo/orchestration-preferences.json은 선택형 추가 지침으로만 읽습니다.
설치 대상 skills 경로
- macOS/Linux: ~/.agents/skills
- Windows: %USERPROFILE%\.agents\skills
bootstrap context 생성 스크립트는 macOS/Linux shell 환경 기준
- Windows에서는 scripts/paseobility-install.ps1로 스킬 설치만 보조합니다.

검증 상태

기존 6개 스킬의 CLI·MCP 호환성 기록은 v2.7.0 시점 호환성 보고서에 있으며, 신규 ps-cua는 포함하지 않습니다. 6개 스킬 기록을 7개 전체에 대한 검증으로 해석하면 안 됩니다. 현재 패키지 호환성 기준선은 Paseo 0.10.2이며, 재검증 기록은 docs/compatibility-0.10.2.md입니다.

ps-cua는 preview / 제한 검증 단계로, 넓은 범위의 안정적인 Mac·Windows 지원이 아닙니다. 2026-09-22 기준 현재 상태:

환경	네이티브 GUI (Cua)	브라우저 결과와 제한
Apple Silicon macOS 26.6.2 · Cua 0.28.2 · 직접 로컬	Calculator 입력/재확인 + PNG 통과; `verify_state` unknown	viewport 통과; 내장 `fullPage` 실패
Intel Mac mini 16GiB · macOS 15.8 · Paseo 0.8.0 · Cua 0.28.2	사용자 보고: 네이티브 GUI + PNG 통과; `verify_state` unknown	브라우저 입력·viewport 통과; 내장 `fullPage` 실패; 같은 탭 스크롤+이어붙인 전체 PNG는 DPR 1 두 fixture에서만 통과(범용 helper 아님)
Intel MacBook 8GiB · macOS 15.7.9 · Paseo 0.7.2 · Cua 0.17.0(재사용)	사용자 보고 이전 E2E: 네이티브 GUI/PNG 통과; `verify_state` unknown	브라우저 입력·viewport 통과; 내장 `fullPage` 실패; 설치된 0.9.0-beta.2는 그대로 두었고 재검증하지 않음
MacBook 후속 · 격리된 upstream PR `#3197` 빌드(보고 버전 0.3.1)	—	사용자 보고: 실제 MCP `browser_screenshot(fullPage:true)`가 DPR 2에서 2573px·3511px를 각각 2회 통과, 반복 SHA 동일
Windows 11 25H2 · Paseo 0.9.0-beta.2 · Cua 0.28.2	사용자 보고: MCP 57개 도구 + Calculator 입력/AX/PNG/`verify_state` 통과	viewport·fullpage PNG 실패(`screenshot_no_frame` 후 15초 timeout, 이미지 없음); DOM fixture 입력·클릭·스크롤 통과; localhost HTTP 실패; 물리적 브라우저 호스트 불명

참고:

이번 리뷰에서 직접 확인한 것은 Apple Silicon 행 하나뿐이며, Intel Mac과 Windows 행은 사용자 보고로 독립 재현되지 않았습니다. MacBook 후속은 upstream PR 빌드를 제품 코드 추가 수정 없이 사용한 것으로, Paseobility가 릴리스·설치한 수정이 아닙니다 — 0.9 backport는 충돌로 중단했고, 0.3.1 다운그레이드는 권장하지 않습니다.
네이티브 통과는 좁게 시험한 흐름에 한정되며 플랫폼 전체 지원이 아닙니다. 8GiB는 최소 RAM 보장이 아니고, 메모리는 최대 사용량까지 측정하지 않았습니다.
보고된 호스트에서 Windows 자동 런타임 설치는 코드 수준 충돌이 있었습니다: 공용 비정션(non-junction) .local/bin을 고정 upstream installer보다 먼저 생성해서, 이미 존재하는 비정션 디렉터리를 거부하는 installer와 충돌했습니다. v2.8.1은 사설 스테이징 bin에 설치하고 실행 파일 집합만 게시하며, tests/test_cua_driver_runtime.ps1이 충돌·롤백·공용 bin 보존을 오프라인으로 검증합니다. 이번 릴리스에서 실제 Windows 신규 설치는 재현하지 않았으므로, 이전 수동 하드링크 복구가 마지막 실기기 근거입니다. Windows catalog에서 명시 전용 스킬 2개는 여전히 확인되지 않았습니다.
테스트 수는 보고 기준이며 이번 README 업데이트에서 재실행하지 않았습니다: Intel Mac mini 41개(cleanup 11 + share 15 + scanner 13 + shell 2); Windows 63 passed / 2 failed / 1 skipped, 이전과 동일.
PowerShell wrapper는 이 Mac에서 pwsh가 없어 소스 검토만 했습니다. 제공된 Windows 보고는 스킬 migration과 런타임 수동 복구를 확인했습니다. 임시 경로 설치·이전과 helper 회귀 테스트는 확인했습니다.
v2.7 6개 스킬 호환 문서는 7개 전체의 런타임을 증명하지 않습니다. 이 문서 업데이트는 Paseo 앱이나 캡처 엔진을 수정하지 않습니다. 바이너리 설치를 권한 준비 완료로 오해하면 안 됩니다. 그 밖의 macOS 버전과 Linux는 미검증입니다.

이번 릴리스(v2.8.1) 테스트 — 위 기기 행과 별개

위 행들은 이전 기기 근거입니다. v2.8.1 릴리스는 macOS·Windows CI에서 오프라인 스위트를 실행했고, CI 실행 35708474356 (head 9932ea7590ef137552d8b2b4e065e7fbb1792254)은 macOS·Windows 두 job 모두 SUCCESS입니다. 정확한 범위:

macOS: Python 테스트 49개 발견, 49 통과, 0 skip(Cua Driver 런타임 18, doctor 21, E2E 자산 3, 스킬 migration 7), 그리고 Node cleanup 11, Node share 15, Python scanner 13, shell 2 — 자동 테스트 총 90개.
Windows 공유 Python 스위트: 49개 발견 중 14 통과, 나머지 35개는 POSIX 전용 skip. Windows job은 Node cleanup 11, Node share 15, Python scanner 13도 실행하며 모두 통과합니다.
네이티브 PowerShell fixture 스위트: pwsh와 Windows PowerShell 5.1 양쪽 에서 실행되어 각각 109 assertions, 0 fail, 0 skip을 보고합니다. 이는 테스트 케이스 109개가 아니라 assertion 수이며, 실제 다운로드한 Cua GUI 테스트가 아닌 fixture 스위트입니다.
여전히 미검증: 공식 다운로드 경로로 실제 Windows에 Cua를 새로 설치하는 것은 재현하지 않았습니다. fixture 스위트는 스테이징 설치 / 공용 bin 보존 / 롤백 / 스킬 migration 계약을 증명할 뿐, 실제 다운로드를 증명하지 않습니다.
./scripts/paseobility-doctor.sh --root .를 text와 --json 모드로 이 체크아웃에 대해 실행했고, JSON은 결정적이며 허용 목록 필드만 담습니다. 라이브 호스트는 Cua 0.28.2(권한 부여됨, 데몬 실행 중), Paseo 0.9.0-beta.2 도달 가능으로 보고됩니다.
--check-mcp를 명시하면 라이브 Cua 0.28.2 MCP 프로브가 프로토콜을 협상하고 한 연결에서 도구 56개를 나열한 것으로 관측되었습니다. 이 프로브는 자체 stdio 서버 자식을 띄우며 56개 도구는 그 부모 프로브에서 나온 값입니다. 프로토콜/도구 확인일 뿐 GUI 결과가 아니고, Paseo agent 클라이언트의 MCP 설정·도구 탐색을 증명하지 않습니다.
GUI E2E는 통과가 아니라 차단됨. 이 호스트에서 e2e/ 브라우저 fixture를 수동 구동하려 했으나 browser_new_tab http://127.0.0.1:<port>가 탭 등록을 기다리다 timeout, 연결된 탭 없음, fixture 서버 종료 후 포트 리스너 없음으로 실패했습니다. 현재 브라우저 호스트가 탭을 등록하지 못해 GUI 통과를 주장하지 않습니다. 위 기기 행 기록은 그대로입니다.
이번 릴리스에서 업데이트한 ps-cua 스킬은 Codex/Paseo와 Claude 스킬 디렉터리 양쪽에 백업과 함께 로컬 설치했습니다. 소스 7개 트리 모두 일치하고 나머지 12개 설치 트리는 그대로였으며, Cua 런타임은 0.28.2로 유지되었습니다.

롤백

이번 변경은 스크립트·테스트·문서·E2E 자산이며 Cua/Paseo 바이너리를 수정하지 않습니다. 이전 helper 동작을 되돌리려면 v2.8.0 트리를 참조할 수 있지만 이는 보장된 태그가 아닙니다. 가장 안전한 방법은 이전 main 커밋 970ea8cab7c3fef757d2bd13f58c8389758aad1d를 별도 clone에서 checkout하여 기존 작업을 보존하는 것입니다. 스킬 롤백은 installer 백업을 사용합니다.
자동 런타임 롤백은 없습니다. Paseobility는 설치된 Cua Driver를 자동 업그레이드하지 않으므로 이미 동작하던 드라이버는 그대로 둡니다.
paseobility-doctor.sh와 paseobility-doctor.ps1은 둘 다 Python 3가 필요합니다. 없으면 각 래퍼가 명확한 메시지와 함께 0이 아닌 코드로 종료하고, installer는 이를 "진단 사용 불가"로 처리하고 설치를 끝냅니다. Python 3가 없으면 진단을 건너뛰세요.

세부 내용과 선택형 Playwright 대안, 호스트별 프로브는 Cua 플랫폼 검증 상태와 호환성 보고서, 현재 기준선 재검증 기록 docs/compatibility-0.10.2.md를 참고하세요. 아래는 이전 버전에 기록된 검증이며 현재 버전의 증거로 사용하지 않습니다.

과거 검증 기록 — 이번 통합본 검증과 별개

환경	상태	확인한 내용
Paseo 0.6.1 on Windows	Tested locally	CLI/daemon 0.6.1 일치, agent/workspace/provider JSON, worktree·schedule·heartbeat·archive CLI schema, 최신 MCP/profile/browser 소스 대조, PowerShell 임시 설치 확인
Apple Silicon macOS	Tested	Paseo CLI 0.2.5에서 `Darwin/arm64` 감지, 임시 HOME 설치, 실제 `~/.agents/skills` 설치, context 생성, package scripts 감지, 새 Paseo agent의 `/paseo-session-brief` 인식 확인
Intel macOS	Tested	Paseo CLI 0.2.5에서 `Darwin/x86_64` 감지, 임시 HOME 설치, 실제 `~/.agents/skills` 설치, context 생성, package scripts 감지, 새 Paseo agent의 `/paseo-session-brief` 인식 확인
Windows	Tested	Windows 11 x64, Windows PowerShell 5.1, Paseo CLI 0.2.5에서 PowerShell installer, `-TargetHome` 임시 설치, 실제 `%USERPROFILE%\.agents\skills` 설치, 새 Paseo agent의 `/paseo-session-brief` 인식 확인. Native bash context script는 미검증
`/ps-spyware-check` on Apple Silicon macOS	Tested	Paseo 0.3.0에서 temp HOME 설치, helper script 실행, fixture 위험 패턴 탐지, 새 Paseo agent 인식, scanner dry-run 확인. 필수 report I/O fail-closed와 선택 scanner 실패 계속 처리 회귀 테스트 통과
`/ps-spyware-check` on Intel macOS	Tested	Darwin x86_64 / Paseo 0.3.0에서 설치, helper script 실행, fixture 위험 패턴 탐지, 새 Paseo agent 인식, Gitleaks secret scan no finding 확인
`/ps-spyware-check` on Windows	Tested	Windows 11 x64 / PowerShell 5.1 / Paseo 0.3.0에서 native PowerShell static-search workflow regex 컴파일, fixture 위험 패턴 탐지, 새 Paseo agent 인식 확인. Bash helper는 Windows native에서 미검증
`/ps-agent-cleanup` helper	Tested locally	Node 회귀 테스트에서 bare dry-run, 일반 idle 보존, disposable marker/명시 ID/사용자 패턴 제한, running/initializing 보호, Paseo 0.6 archive acknowledgement와 post-archive 목록 검증, workspace 승인 gate, 위험 명령 미실행 확인
`/ps-agent-cleanup` on Windows	Previous install verified	Windows 10.0.26200 x64 / Node v24.14.0 / Paseo 0.3.0에서 `%USERPROFILE%\.agents\skills` 설치 및 dry-run JSON 확인. v2.5.2 정책 회귀는 cross-platform Node 단위 테스트로 검증
`/ps-share` on Apple Silicon macOS	Tested	공식 skill validator, Node 보안·온보딩·help/`--help` 회귀 테스트, private 저장소 생성/재사용과 public·비관련 저장소 거부 검증, 실제 private GitHub 게시·조회·자동 fetch·원본 SHA-256 비교, Codex/Claude 격리 설치 확인
`/ps-share` on Windows	Tested	Windows private checkout, PowerShell 설치, private GitHub 연결, 실제 TXT 게시와 원격 파일 조회, 모바일 GitHub 미리보기 확인

Intel Mac 테스트에서는 설치 실패, agent 인식 실패, Intel 전용 오류가 관찰되지 않았습니다. Windows 테스트에서는 PowerShell installer, -TargetHome 임시 홈 설치, 실제 스킬 인식이 통과했습니다. 임시 홈 설치는 $HOME 대신 -TargetHome 또는 $env:USERPROFILE 기준으로 격리하는 방식을 사용합니다.

빠른 사용 예시

다른 컴퓨터와 모바일로 산출물 공유하기

최초 공유 요청에서 GitHub 연결을 확인하고 인증된 계정의 private paseo_share 저장소를 자동으로 준비합니다.

/ps-share 이 보고서 휴대폰에서 볼 수 있게 공유해줘.

GitHub 인증이 없으면 gh auth login --hostname github.com 연결을 먼저 안내합니다. Forgejo나 별도 저장소를 쓰려면 setup <repo-url>을 명시적으로 사용합니다.

그다음 자연어로 게시하거나 가져옵니다.

/ps-share 이 보고서 휴대폰에서 볼 수 있게 공유해줘.
/ps-share 다른 컴퓨터에서 방금 공유한 파일 보여줘.
/ps-share 최신 공유 파일을 현재 프로젝트로 가져와서 요약해줘.

게시 결과에는 공유 ID와 클릭 가능한 미리보기/다운로드 링크가 포함됩니다. private 저장소 링크는 모바일 브라우저에서 GitHub/Forgejo 로그인이 필요합니다.

웹 UI를 직접 다루기

/ps-browser
https://example.com 로그인 페이지 열고, 폼 구조 확인한 다음,
테스트 계정으로 로그인되는지 스크린샷까지 찍어서 검증해줘.

가능한 작업 흐름:

새 탭 열기 -> 페이지 스냅샷 -> 입력 필드 찾기 -> 값 입력
-> 버튼 클릭 -> 대기 -> 다시 스냅샷/스크린샷으로 검증

여러 에이전트를 지휘하기

/ps-orchestration
이 기능을 구현, 테스트, 리뷰로 나눠서 병렬로 진행하고
마지막에는 리뷰 에이전트가 통과 여부를 판단하게 해줘.

가능한 작업 흐름:

작업 분해 -> 워커 에이전트 생성 -> 병렬 실행
-> 결과 수집 -> 리뷰 게이트 -> 통과/차단 판단

여러 모델 답을 비교하기

/ps-orchestration
이 README 방향을 두고 GPT는 옹호, OpenCode DeepSeek은 반대,
Grok은 둘을 비교해서 최종 판단을 정리해줘.

가능한 작업 흐름:

참가자 역할 정의 -> 여러 agent 병렬 실행
-> 결과 수집 -> judge agent 생성
-> winner / merged plan / risks 정리

세션 브리프 만들기

/ps-project
이 프로젝트 처음 보는 상태라고 생각하고 현재 작업 가능한 브리프 만들어줘.

출력 범위:

Project -> Current State -> Instructions -> Commands
-> Project Map -> Risks -> Suggested First Moves

새 프로젝트 맥락 세팅하기

/ps-project
이 repo 처음 보는 상태라고 생각하고 docs, CLAUDE.md, AGENTS.md,
package scripts를 읽어서 작업 맥락을 만들어줘.

같은 일을 shell script로 먼저 준비할 수도 있습니다.

./scripts/paseobility-doctor.sh
./scripts/paseobility-context.sh

생성되는 파일:

.paseobility/
├── context.md        # README/docs/지침 파일 요약
├── commands.md       # install/dev/build/test 명령 후보
├── project-map.md    # 주요 파일/디렉터리 지도
└── bootstrap-log.md  # OS, arch, Paseo 상태, 경고

설치 전 스파이웨어 체크하기

/ps-spyware-check
https://github.com/owner/repo 설치해도 되는지,
install script, secret 접근, 원격 코드 실행, 데이터 유출 위험 위주로 검사해줘.

기본 원칙:

repo 코드를 실행하지 않고 읽기 전용으로 검사합니다.
macOS/Linux에서는 bundled helper가 있으면 temp clone 후 정적 리포트를 만듭니다.
Windows에서는 bundled PowerShell helper로 native 정적 리포트를 만들 수 있습니다.
gitleaks, trufflehog, semgrep, osv-scanner, trivy, shellcheck, yara가 설치되어 있으면 사용하고, 없으면 rg 기반 휴리스틱으로 내려갑니다.
scanner가 없고 추가 커버리지가 가치 있으면 에이전트가 포함된 installer로 직접 설치하고 무엇을 설치했는지 알려줍니다(--dry-run으로 계획 확인 가능).
결과는 severity별로 High, Medium, Info로 분류하고, scanner 문서/정규식에 들어 있는 self-reference는 Info로 표시합니다.
helper report에는 Finding Summary가 포함되어 High / Medium / Info 개수와 verdict hint를 먼저 보여줍니다.
결과는 Low / Medium / High / Critical verdict와 파일/라인 근거로 정리합니다.

테스트 agent 정리하기

/ps-agent-cleanup
먼저 dry-run으로 disposable/test 표식이 있는 inactive agent와 테스트 workspace 후보를 보여줘.
일반 idle 세션은 보존하고, 내가 지정한 ID나 패턴 밖의 agent는 archive하지 마.
실행 중인 agent는 건드리지 말고 workspace는 승인 전에는 후보만 보여줘.

기본 원칙:

기본 실행은 dry-run이며 일반 idle agent는 상태만 보고 archive하지 않습니다.
--auto는 명시적 ID, 사용자 지정 패턴, 또는 분명한 disposable/test/validation 표식이 있는 inactive agent에만 허용됩니다.
delete는 하지 않고 archive만 하며 활성 agent는 항상 보호합니다.
ID나 패턴으로 직접 지정한 agent는 바로 archive합니다(--archive, --yes 불필요). workspace archive는 명시적 ID와 --yes가 필요합니다.
archive 응답의 대상 ID와 상태를 확인하고 active 목록에서 사라졌는지 재조회합니다.

`/ps-share`

50 MiB 이하의 모든 형식 파일을 전용 private Git 저장소에 불변 artifact로 게시합니다. GitHub Actions나 background daemon 없이 각 컴퓨터에서 로컬 git fetch, rebase, commit, push만 실행합니다.

onboard: GitHub 인증 확인 후 <login>/paseo_share private 저장소 생성 또는 안전한 재사용
setup: 컴퓨터별 machine name과 동일한 원격 저장소 설정
publish: 파일 하나 이상을 한 commit으로 게시하고 각각의 공유 ID, 미리보기 URL, 다운로드 URL 반환
list / latest: 원격 동기화 후 다른 컴퓨터 산출물 조회
fetch: 공유 ID 또는 latest를 현재 컴퓨터로 검증 후 복사. 같은 내용의 기존 파일은 재사용하고, 다른 파일이 있으면 그대로 두고 name (2).ext로 저장합니다(--force는 교체를 요청했을 때만 덮어씀)

Artifact는 artifacts/<machine>/<year>/<month>/<artifact-id>/ 아래 저장됩니다. 50 MiB 이하라면 파일 형식은 제한하지 않으며(폴더는 먼저 zip), secret-looking 파일명(.env, *.pem, *.key, SSH 키, credentials, secrets)과 private key·access token 서명이 든 텍스트 내용은 거부합니다. 가져올 때 metadata 스키마, 경로 containment, symlink, 파일 크기, SHA-256을 검사하고, 손상된 항목은 경고와 함께 건너뛰며, Windows CRLF와 macOS/Linux LF 변환을 안전하게 처리합니다. push가 실패하면(오프라인, 인증, hook) commit은 관리 clone에 남고 다음 list, latest, fetch, publish가 자동으로 push합니다. 재시도하려고 같은 파일을 다시 게시하지 않습니다.

지원 모델은 한 사용자가 자기 private 저장소를 신뢰하는 자기 기기들에서 사용하는 방식입니다. 신뢰하지 않는 여러 사용자가 하나의 저장소를 함께 쓰는 멀티테넌트 교환은 지원하지 않습니다. 바이너리 내부의 민감정보는 검사하지 않으며, Git에서 삭제해도 과거 commit에는 남으므로 민감 파일은 게시하지 않아야 합니다.

자동 온보딩은 동명 저장소가 public이거나 Paseo Share 구조가 아닌 경우 가시성 변경, 이름 변경, 삭제, 덮어쓰기를 시도하지 않고 중단합니다.

`/ps-orchestration` 비교 모드

같은 문제를 여러 에이전트에게 독립적으로 맡긴 뒤, 별도 judge가 비교해서 최종 답을 고르는 스킬입니다.

모드	용도
Debate	한 모델은 찬성, 다른 모델은 반대, judge가 종합
Competing Plans	여러 설계/수정 계획을 비교
Competing Implementations	격리 workspace에서 구현 후보를 비교

핵심 규칙:

먼저 list_profiles의 notes를 읽고 profile을 create_agent 인자로 materialize합니다. 맞는 profile이 없으면 list_providers, inspect_provider, 필요 시 list_models로 확인합니다.
분석만 하면 같은 workspace를 써도 됩니다.
파일을 수정하는 tournament는 참가자별 별도 workspace를 씁니다.
judge는 참가자와 다른 provider를 우선합니다.
결과는 winner, runner-up, best merged plan, risks로 정리합니다.

`/ps-project`

프로젝트 요약과 환경 설정을 하나의 진입점에서 선택합니다.

요약 모드: 요청한 repo 개요·명령·인수인계를 정리하고, .paseobility/ context가 없거나 오래됐으면 작성·갱신합니다.
설정 모드: 요청한 초기 설정·환경 수정·context 생성만 수행합니다.
이미 확인한 정보를 재사용하고 같은 문서를 다시 전부 조사하지 않습니다.
Paseo runtime이 관련될 때만 버전·daemon·workspace를 조회합니다. 경로 별칭 때문에 --cwd 조회가 실패하면 기존 workspace ID를 사용합니다.
요약에서는 의존성을 설치하거나 서버를 띄우지 않습니다. .paseobility/는 로컬 상태이며, repo가 무시하지 않으면 .gitignore가 아니라 .git/info/exclude에 추가합니다.

필요한 모드의 절차는 스킬과 연결된 references에서 확인할 수 있습니다.

`/ps-spyware-check`

GitHub URL이나 로컬 repo를 설치하기 전에 spyware, 악성 install script, secret 탈취, 원격 코드 실행, supply-chain 위험 신호를 정적으로 점검합니다.

확인하는 것:

package.json의 preinstall, install, postinstall, prepare
shell/PowerShell script의 remote download/execute, hidden process, persistence
.ssh, .aws, .npmrc, browser profile, keychain, API token 접근
eval, Function, base64, EncodedCommand, child_process 같은 obfuscation/실행 패턴
GitHub Actions의 pull_request_target, unpinned action, secret 노출 위험
optional scanner 결과: gitleaks, trufflehog, semgrep, osv-scanner, trivy, shellcheck, PSScriptAnalyzer, yara
helper report의 severity 분류: High, Medium, Info
helper report의 Finding Summary count와 verdict hint
scanner 문서/스크립트에 들어 있는 self-reference 패턴

핵심 규칙:

검사 대상 repo의 코드는 실행하지 않습니다.
dependency install/build/test를 돌리지 않습니다.
민감 값은 출력하지 않고 파일/라인/키 이름 중심으로 redaction합니다.
깨끗한 결과도 "절대 안전"이 아니라 "정적 검사에서 고위험 신호가 보이지 않음"으로 표현합니다.
scanner 자체 문서나 정규식 설명에서 잡힌 self-reference는 숨기지 않고 Info로 분류합니다.

Third-party scanner note:

/ps-spyware-check는 로컬에 설치된 외부 오픈소스 스캐너 CLI를 호출해 사용하는 방식입니다.
Paseobility는 해당 스캐너의 바이너리나 룰셋을 저장소에 포함하거나 재배포하지 않습니다.

포함된 helper:

# Cross-platform JSON security receipt
python skills/ps-spyware-check/scripts/spyware-check.py https://github.com/owner/repo --json

# macOS/Linux
skills/ps-spyware-check/scripts/spyware-check.sh --target https://github.com/owner/repo
skills/ps-spyware-check/scripts/install-scanners.sh --dry-run

# Windows PowerShell
.\skills\ps-spyware-check\scripts\spyware-check.ps1 -Target https://github.com/owner/repo
.\skills\ps-spyware-check\scripts\install-scanners.ps1 -DryRun

`/ps-agent-cleanup`

Paseo의 비활성 agent와 테스트 workspace를 안전하게 정리합니다.

확인하는 것:

설치된 Paseo 클라이언트로 읽은 전체 agent·workspace 스냅샷 (daemon이 지원하면 백그라운드 워크스페이스 포함)
paseo workspace ls --json의 workspace 목록
명시적 ID, 사용자 지정 --pattern, 또는 disposable/test/validation 표식으로 제한된 inactive agent
보존해야 할 일반 idle agent와 보호되는 active agent
명시적으로 지정한 agent/workspace ID

핵심 규칙:

기본 실행은 dry-run이며 일반 idle agent를 상태만 보고 archive하지 않습니다.
--auto는 명시적 ID, 사용자 지정 패턴, 또는 분명한 disposable/test/validation 표식이 있는 inactive agent만 archive합니다.
running, initializing, working, active, starting, queued, pending, busy, executing, in-progress 상태의 agent는 archive하지 않습니다.
delete/stop/kill/restart와 history/timeline/resume 검증은 사용하지 않습니다.
archive 후 Paseo CLI JSON acknowledgement와 active 목록 제거를 검증합니다.
agent archive(소프트 삭제)는 --archive만으로 실행하고, workspace archive는 명시적 ID와 --archive --yes가 필요합니다.

포함된 helper:

node skills/ps-agent-cleanup/scripts/agent-cleanup.js
node skills/ps-agent-cleanup/scripts/agent-cleanup.js --dry-run --pattern 'cleanup-validation|fixture'
node skills/ps-agent-cleanup/scripts/agent-cleanup.js --agent <agent-id> --archive
node skills/ps-agent-cleanup/scripts/agent-cleanup.js --auto --agent <agent-id>
node skills/ps-agent-cleanup/scripts/agent-cleanup.js --auto --pattern 'cleanup-validation|fixture'
node skills/ps-agent-cleanup/scripts/agent-cleanup.js --workspace <workspace-id> --archive --yes

`/ps-browser`

일반 브라우징은 Ego Lite → TaskSpace 하나 → 기본 탭 p1 재사용 → 완료 정리가 기본입니다. ego-browser skill로 설치 버전의 API 안내를 읽습니다. 여러 실행 간 재사용, 완료 결과 확인, 제어권 전환과 Windows 명령 형식은 Ego 참조를 따릅니다. Ego에 Chrome 도우미를 적용하지 않습니다. 오류가 나면 같은 공간을 복구하며 새 공간을 만들거나 브라우저를 자동 전환하지 않습니다.

Ego 미설치, CLI/PATH 누락, 연결 실패를 이유로 Chrome을 자동 선택하지 않습니다. Ego 참조에 따라 실제 작업할 컴퓨터의 CLI와 앱 경로를 확인하고, 설정이 부족하면 그 내용을 알립니다. 스킬을 갱신한 컴퓨터마다 새 에이전트 세션을 열거나 연동을 다시 불러와야 합니다. Paseo를 재시작할 필요는 없습니다.

사용자가 Chrome을 지정했을 때만 현재 실행 중인 Chrome 창에 작업용 탭 하나 추가 → 재사용 → 그 탭만 종료합니다. macOS의 scripts/chrome-tabs.py가 기존 창 ID를 지정해 탭을 만들고, 생성한 탭 ID와 Chrome 실행 식별자를 기록합니다. 생성 응답이 유실돼도 같은 작업 ID로 복구하며 새 창이나 중복 탭을 만들지 않습니다. 작업 후 종료 결과를 다시 확인합니다.

python3 ~/.agents/skills/ps-browser/scripts/chrome-tabs.py list
python3 ~/.agents/skills/ps-browser/scripts/chrome-tabs.py open --task '<고유-작업-ID>' --window '<기존-창-ID>' --url 'https://example.com/'
# 반환된 tabId를 설치된 Chrome 연동 도구로 바인딩해 작업합니다.
python3 ~/.agents/skills/ps-browser/scripts/chrome-tabs.py close --task '<고유-작업-ID>'

사용자 탭·로그인·다른 에이전트의 탭은 보존합니다. provider 강제 종료 시에는 다음 실행에서 기록을 확인해 정리해야 합니다. macOS 이외의 기존 창 어댑터는 아직 검증하지 않았으며, 연결 실패를 새 브라우저 실행으로 대체하지 않습니다.

격리·headless 작업을 요청했거나 ps-design 검증처럼 별도 워크플로우가 요구할 때만 CloakBrowser, Paseo workspace 브라우저 또는 Playwright CLI를 사용합니다. 설치만으로 브라우저나 데몬을 실행하지 않습니다.

자세한 실행 계약과 반복 검증은 스킬과 Chrome 참조, 격리 실행은 CloakBrowser와 Playwright CLI를 참고하세요.

`/ps-cua`

trycua Cua Driver(cua-driver CLI 또는 MCP)로 네이티브 데스크톱 GUI를 구동합니다. 현재 의존성 고정 버전과 설치 검증은 2026-11-06 기록을 참고하세요. 사용자가 네이티브 앱 조작을 요청하거나 데스크톱 앱 GUI로만 할 수 있는 작업일 때 쓰며, 같은 결과를 내는 CLI·API·파일 수정이 있으면 그쪽을 우선합니다. preview / 제한 검증 단계입니다 — Cua 플랫폼 검증 상태 참고.

사전조건: cua-driver --version. 없으면 GUI가 아닌 경로가 있을 때 그쪽을 쓰고, 없으면 설치 명령을 안내하며 요청하면 직접 실행합니다. macOS Accessibility·Screen Recording 권한은 사람이 부여합니다.
설치된 계약을 먼저 읽습니다: cua-driver list-tools, cua-driver describe <tool>.
cua-driver mcp-config --client opencode는 config 스니펫만 출력하며 서버를 등록하지 않습니다.
핵심 루프: 창 찾기·앱 실행 -> snapshot -> 액션(UI가 바뀌지 않는 동안 한 스냅샷에서 여러 액션 연결 가능) -> 새로 읽어 검증.
기본은 백그라운드 전달이며, 액션이 반영되지 않으면 delivery_mode: "foreground"로 전환하고 그 사실을 알립니다.
작업 범위 안에서는 자유롭게 진행하고, 결제, 되돌릴 수 없는 삭제, 계정 보안 변경, 요청하지 않은 발송·게시 전에는 먼저 묻습니다.

`/ps-orchestration`

한 에이전트가 여러 에이전트를 만들고, 역할을 나누고, 결과를 합성하는 패턴 모음입니다.

패턴	용도
Fan-out	독립 작업을 여러 에이전트에게 동시에 맡기기
Task DAG	Step 1 -> Step 2 -> Step 3 순차 실행
Hybrid DAG	병렬 작업 후 합성, 이후 리뷰 같은 혼합 흐름
Decision Gate	다음 단계 진행 전 리뷰 에이전트가 통과/차단 판단
Coordinator Loop	긴 작업을 heartbeat로 주기적으로 점검
Blocking Ask/Reply	다른 에이전트의 답을 받은 뒤 진행
Escalation	권한, 모호함, 하드 실패를 사용자에게 명확히 보고

선택형 추가 지침

Paseo 0.6에서는 앱에 설정된 agent profile이 provider/model/mode/thinking/ feature 선택의 기준입니다. 아래 legacy 파일은 provider source가 아니라 추가적인 사용자 지침만 전달할 때 사용할 수 있습니다.

~/.paseo/orchestration-preferences.json 예시:

{
  "preferences": [
    "작업 지시는 self-contained briefing으로 작성한다.",
    "리뷰 에이전트는 구현 에이전트와 다른 provider를 우선한다.",
    "하드 실패는 조용히 우회하지 말고 사용자에게 보고한다."
  ]
}

저장소 구조

skills/
├── ps/                     # SKILL.md + read-only local catalog/tests
├── ps-agent-cleanup/       # SKILL.md + CLI helper/tests
├── ps-browser/            # SKILL.md + references (cloakbrowser, paseo, playwright, screenshots)
├── ps-cua/                # SKILL.md + implicit-invocation policy
│   └── references/           # setup.md, workflow.md, recovery.md
├── ps-design/             # SKILL.md + references, templates, scripts/design-check.mjs, vendored guides
├── ps-god/                # SKILL.md + explicit-only policy, procedures, run helper/tests
├── ps-multi/              # SKILL.md + host adapter/tests + references
├── ps-orchestration/      # SKILL.md + explicit-only policy
│   └── references/           # coordination.md, tournament.md
├── ps-plan/               # SKILL.md + explicit-only policy
├── ps-project/            # SKILL.md
│   └── references/           # brief.md, setup.md
├── ps-research/           # SKILL.md + primary-source workflow
├── ps-share/              # SKILL.md + CLI helper/tests
├── ps-spyware-check/      # SKILL.md + scanners/tests
├── ps-toss/               # SKILL.md + pinned upstream Harness
└── ps-write/              # SKILL.md, 명시 호출 설정, 한국어 문체 지침과 동봉 규칙집
scripts/                     # installers, doctor (.sh/.ps1/.py), context helper, cua-driver helper
tests/                       # test_doctor.py, test_e2e_assets.py, test_cua_driver_runtime.py/.ps1, test_skill_migration.py
e2e/                         # browser fixture, fixture server, runbook, report template + validator
.github/workflows/ci.yml     # macOS + Windows 오프라인 스위트
docs/compatibility-0.12.0.md         # 정적 확인(0.12.0)
docs/compatibility-0.10.2.md
docs/compatibility-0.9.0-beta.2.md   # 과거 기록(0.9.0-beta.2)
docs/cua-platform-validation.md
AGENTS.md
CLAUDE.md
VERSION
paseobility.json

라이선스

MIT License.

ps-design에 동봉한 외부 가이드와 데이터의 라이선스는 디자인 자료 출처에 기록했습니다.
ps-write에 동봉한 humanize-korean 참조 문서 두 편은 원본의 MIT 라이선스를 따릅니다. 윤문 자료 출처

브라우저는 손처럼 쓰고, 에이전트는 팀처럼 굴리세요.

이전 릴리스 이력

2026-10-29 · 해외 사용자에게 플러그인 화면을 영어로 (v2.12.11)

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

2026-10-28 · 리서치 스킬, 디자인 비교, Windows·macOS 보완 (v2.12.10)

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

2026-10-28 · Paseo God 작업 절차, 재현 우선 디버깅, 두 갈래 검토 (v2.12.9)

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

2026-10-28 · macOS·Linux에서 감독기 사용 시 GUI 상태 조회 수정 (v2.12.8)

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

2026-10-28 · 한국어 Windows에서 감독 상태 조회 수정 (v2.12.7)

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

2026-10-28 · 어떤 컴퓨터에서든 도는 Paseo 봇: macOS·Linux·Windows (v2.12.6)

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

2026-10-28 · 보호 서비스 설치 안내 개선 (v2.12.5)

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

2026-10-28 · Paseo 봇 보호 서비스와 멈춤 감지 (v2.12.4)

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

2026-10-28 · Paseo 업데이트 중에도 멈추지 않는 Paseo 봇 (v2.12.3)

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

2026-10-25 · 디자인 판단과 AI slop 감소 (v2.12.2)

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

2026-10-24 · Paseo 0.13 대응 (v2.12.1)

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

2026-10-24 — Ego Lite 연동 (v2.12.0)

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

2026-10-23 — 기존 Chrome 탭 재사용과 Apps in Toss (v2.11.0)

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

2026-10-20 — 에이전트를 더 믿기 (v2.10.0)

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

2026-10-19 — God 모드 고정 비용 비례화 (v2.9.4)

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

2026-10-15 수정 릴리스 — Windows·원격 Mac (v2.9.3)

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

2026-10-13 후속 보완 — 기존 9개 스킬 전체 (v2.9.2)

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

2026-10-13 업데이트 — 의존성 최신화 (v2.9.1)

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

2026-10-11 업데이트 — `/ps-multi` (v2.9.0)

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

2026-10-05 업데이트 — `/ps-design`에 design-check (v2.8.3)

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

2026-09-30 업데이트 — CloakBrowser 브라우저 기본, Paseo 0.10.2, Cua 핀 0.30.4

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

`/ps-browser` 기본 백엔드가 CloakBrowser로

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

Paseo 0.10.2 계약 확인(앱/소스), 라이브 데몬은 그대로

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

Cua Driver 소스 핀 0.30.4(호스트는 0.28.2 유지)

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

v2.8.1 — Windows Cua 설치 수정, 읽기 전용 doctor, 오프라인 테스트

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

v2.8.0 — Cua Driver 스킬 추가

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

Cua Driver 런타임 자동 설치

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

v2.6.0 업데이트 — Paseo 0.6.1 호환

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

v2.5.2 업데이트

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

v2.5.1 업데이트

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

v2.4.1 업데이트

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

v2.4.0 업데이트

전체 릴리스 이력에서 내용을 확인할 수 있습니다.

측정된 스타 증가

소개

README.ko.md

Paseobility

시작 전에

한 줄 요약

빠른 시작

/ps-god — 명시 호출 작업 모드 (v0)

사용 방식

들어있는 스킬

설치

Cua Driver 런타임

Doctor와 테스트

요구사항

검증 상태

이번 릴리스(v2.8.1) 테스트 — 위 기기 행과 별개

롤백

과거 검증 기록 — 이번 통합본 검증과 별개

빠른 사용 예시

다른 컴퓨터와 모바일로 산출물 공유하기

웹 UI를 직접 다루기

여러 에이전트를 지휘하기

여러 모델 답을 비교하기

세션 브리프 만들기

새 프로젝트 맥락 세팅하기

설치 전 스파이웨어 체크하기

테스트 agent 정리하기

/ps-share

/ps-orchestration 비교 모드

/ps-project

/ps-spyware-check

/ps-agent-cleanup

/ps-browser

/ps-cua

/ps-orchestration

선택형 추가 지침

저장소 구조

라이선스

2026-10-29 · 해외 사용자에게 플러그인 화면을 영어로 (v2.12.11)

2026-10-28 · 리서치 스킬, 디자인 비교, Windows·macOS 보완 (v2.12.10)

2026-10-28 · Paseo God 작업 절차, 재현 우선 디버깅, 두 갈래 검토 (v2.12.9)

2026-10-28 · macOS·Linux에서 감독기 사용 시 GUI 상태 조회 수정 (v2.12.8)

2026-10-28 · 한국어 Windows에서 감독 상태 조회 수정 (v2.12.7)

2026-10-28 · 어떤 컴퓨터에서든 도는 Paseo 봇: macOS·Linux·Windows (v2.12.6)

2026-10-28 · 보호 서비스 설치 안내 개선 (v2.12.5)

2026-10-28 · Paseo 봇 보호 서비스와 멈춤 감지 (v2.12.4)

2026-10-28 · Paseo 업데이트 중에도 멈추지 않는 Paseo 봇 (v2.12.3)

2026-10-25 · 디자인 판단과 AI slop 감소 (v2.12.2)

2026-10-24 · Paseo 0.13 대응 (v2.12.1)

2026-10-24 — Ego Lite 연동 (v2.12.0)

2026-10-23 — 기존 Chrome 탭 재사용과 Apps in Toss (v2.11.0)

2026-10-20 — 에이전트를 더 믿기 (v2.10.0)

2026-10-19 — God 모드 고정 비용 비례화 (v2.9.4)

2026-10-15 수정 릴리스 — Windows·원격 Mac (v2.9.3)

2026-10-13 후속 보완 — 기존 9개 스킬 전체 (v2.9.2)

2026-10-13 업데이트 — 의존성 최신화 (v2.9.1)

2026-10-11 업데이트 — /ps-multi (v2.9.0)

2026-10-05 업데이트 — /ps-design에 design-check (v2.8.3)

2026-09-30 업데이트 — CloakBrowser 브라우저 기본, Paseo 0.10.2, Cua 핀 0.30.4

/ps-browser 기본 백엔드가 CloakBrowser로

Paseo 0.10.2 계약 확인(앱/소스), 라이브 데몬은 그대로

Cua Driver 소스 핀 0.30.4(호스트는 0.28.2 유지)

v2.8.1 — Windows Cua 설치 수정, 읽기 전용 doctor, 오프라인 테스트

v2.8.0 — Cua Driver 스킬 추가

Cua Driver 런타임 자동 설치

v2.6.0 업데이트 — Paseo 0.6.1 호환

v2.5.2 업데이트

v2.5.1 업데이트

v2.4.1 업데이트

v2.4.0 업데이트

`/ps-god` — 명시 호출 작업 모드 (v0)

`/ps-share`

`/ps-orchestration` 비교 모드

`/ps-project`

`/ps-spyware-check`

`/ps-agent-cleanup`

`/ps-browser`

`/ps-cua`

`/ps-orchestration`

2026-10-11 업데이트 — `/ps-multi` (v2.9.0)

2026-10-05 업데이트 — `/ps-design`에 design-check (v2.8.3)

`/ps-browser` 기본 백엔드가 CloakBrowser로