From 292a9c4c8c4a970951d5010c3f122c8977a05cc3 Mon Sep 17 00:00:00 2001 From: Yoonho Son <94930261+SonYoonho@users.noreply.github.com> Date: Fri, 7 Aug 2026 08:18:25 +0900 Subject: [PATCH] docs: add Korean README translation (#2947) Co-authored-by: Mohamed Boudra --- README.ja.md | 3 +- README.ko.md | 173 ++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 3 +- README.zh-CN.md | 3 +- 4 files changed, 179 insertions(+), 3 deletions(-) create mode 100644 README.ko.md diff --git a/README.ja.md b/README.ja.md index 288d773b5..ff159843e 100644 --- a/README.ja.md +++ b/README.ja.md @@ -7,7 +7,8 @@

English · 简体中文 · - 日本語 + 日本語 · + 한국어

diff --git a/README.ko.md b/README.ko.md new file mode 100644 index 000000000..ec1bc64cf --- /dev/null +++ b/README.ko.md @@ -0,0 +1,173 @@ +

+ Paseo 로고 +

+ +

Paseo

+ +

+ English · + 简体中文 · + 日本語 · + 한국어 +

+ +

+ + GitHub stars + + + GitHub release + + + X + + + Discord + + + Reddit + +

+ +

Claude Code, Codex, Copilot, OpenCode, Pi 에이전트를 위한 하나의 인터페이스

+ +

+ Paseo app screenshot +

+ +

+ Paseo mobile app +

+ +내 컴퓨터에서 에이전트를 병렬로 실행하세요. 데스크톱이나 휴대폰에서 배포하세요. + +- **셀프 호스팅:** 에이전트는 완전한 개발 환경이 갖춰진 내 컴퓨터에서 실행됩니다. 평소 쓰던 도구, 설정, 스킬을 그대로 쓸 수 있습니다. +- **여러 제공자 지원:** Claude Code, Codex, Copilot, OpenCode, Pi를 하나의 인터페이스에서 사용할 수 있습니다. 작업마다 알맞은 모델을 고를 수 있습니다. +- **음성 제어:** 음성 모드에서 작업을 말로 지시하거나 문제를 음성으로 함께 검토할 수 있습니다. 손을 쓰지 않고 작업해야 할 때 유용합니다. +- **여러 기기 지원:** iOS, Android, 데스크톱, 웹, CLI를 지원합니다. 데스크톱에서 시작해 휴대폰으로 확인하고 터미널에서 자동화할 수 있습니다. +- **개인정보 보호 우선:** Paseo는 텔레메트리, 추적, 강제 로그인을 사용하지 않습니다. + +## 시작하기 + +Paseo는 코딩 에이전트를 관리하는 로컬 서버인 데몬을 실행합니다. 데스크톱 앱, 모바일 앱, 웹 앱, CLI 같은 클라이언트가 이 데몬에 연결합니다. + +### 준비 사항 + +아래 에이전트 CLI 중 하나 이상을 설치하고 인증 정보를 설정해야 합니다. + +- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) +- [Codex](https://github.com/openai/codex) +- [GitHub Copilot](https://github.com/features/copilot/cli/) +- [OpenCode](https://github.com/anomalyco/opencode) +- [Pi](https://pi.dev) + +### 데스크톱 앱(권장) + +[paseo.sh/download](https://paseo.sh/download) 또는 [GitHub 릴리스 페이지](https://github.com/getpaseo/paseo/releases)에서 다운로드하세요. 앱을 열면 데몬이 자동으로 시작됩니다. 별도로 설치할 것은 없습니다. + +휴대폰에서 연결하려면 **설정 → 호스트 → 기기 페어링**을 여세요. + +### CLI / 헤드리스 환경 + +CLI를 설치하고 Paseo를 시작하세요. + +```bash +npm install -g @getpaseo/cli +paseo +``` + +Paseo가 로컬에서 시작된 뒤 기기 페어링을 위한 종단 간 암호화 릴레이를 켤지 묻습니다. 거절하면 TCP, Tailscale 또는 다른 VPN으로 직접 연결할 수 있습니다. 이 방식은 서버나 원격 머신에서 유용합니다. + +자세한 설치와 설정은 아래 문서를 참고하세요. + +- [문서](https://paseo.sh/docs) +- [연결 가이드](https://paseo.sh/docs/connectivity) +- [설정 레퍼런스](https://paseo.sh/docs/configuration) + +### Docker + +Docker에서 Paseo 데몬과 셀프 호스팅 웹 UI를 실행하세요: + +```bash +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 문서](docs/docker.md)를 참고하세요. + +## CLI + +앱에서 할 수 있는 모든 작업은 터미널에서도 할 수 있습니다. + +```bash +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 레퍼런스](https://paseo.sh/docs/cli)를 참고하세요. + +## 스킬 + +스킬은 에이전트가 Paseo를 통해 다른 에이전트를 오케스트레이션하는 방법을 알려 줍니다. + +```bash +npx skills add getpaseo/paseo +``` + +그런 다음 어떤 에이전트 대화에서든 아래 명령을 사용할 수 있습니다. + +- `/paseo-handoff` — 에이전트 간에 작업을 넘깁니다. Claude로 계획을 세운 뒤 Codex에 구현을 넘길 때 이 기능을 씁니다. +- `/paseo-loop` — 명확한 완료 조건을 기준으로 에이전트를 반복 실행합니다(Ralph loop). 검증 에이전트를 추가할 수도 있습니다. +- `/paseo-advisor` — 작업 자체를 넘기지 않고, 에이전트 하나를 조언자로 띄워 두 번째 의견을 받습니다. +- `/paseo-committee` — 서로 다른 관점의 에이전트 두 개로 위원회를 구성해, 한 발 물러나 근본 원인을 분석하고 계획을 세웁니다. + +## 개발 + +모노레포 패키지 구성은 다음과 같습니다. + +- `packages/server`: Paseo 데몬(에이전트 프로세스 오케스트레이션, WebSocket API, MCP 서버 제공) +- `packages/app`: Expo 클라이언트(iOS, Android, 웹) +- `packages/cli`: `paseo` CLI(데몬과 에이전트 워크플로) +- `packages/desktop`: Electron 데스크톱 앱 +- `packages/relay`: 데몬과 클라이언트가 쓰는 릴레이 전송 및 암호화 패키지 +- `packages/website`: 마케팅 사이트 및 문서(`paseo.sh`) + +자주 쓰는 명령: + +```bash +# 모든 로컬 개발 서비스 실행 +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 +``` + +## 관련 프로젝트 + +- [getpaseo/paseo-relay](https://github.com/getpaseo/paseo-relay) — Elixir로 작성한 공식 분산형 릴레이 +- [paseo-skins](https://github.com/huangguang1999/paseo-skins) — 커뮤니티 테마와 Agent Skill을 제공하고, 코드 수정 없이 쓸 수 있는 데스크톱 테마 로더 +- [paseo-vscode](https://marketplace.visualstudio.com/items?itemName=hinnes.paseo-vscode) — VS Code 확장 프로그램 + +## 라이선스 + +AGPL-3.0 diff --git a/README.md b/README.md index 07c02012c..4382873e3 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,8 @@

English · 简体中文 · - 日本語 + 日本語 · + 한국어

diff --git a/README.zh-CN.md b/README.zh-CN.md index e2b36c0ac..dd9e2eae6 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -7,7 +7,8 @@

English · 简体中文 · - 日本語 + 日本語 · + 한국어