paseo README

The project's README from github.com/getpaseo/paseo. As one markdown file: README.md.

Paseo logo

Paseo

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

GitHub stars GitHub release X Discord Reddit

One interface for Claude Code, Codex, Copilot, OpenCode, and Pi agents.

Paseo app screenshot

Paseo mobile app

Run agents in parallel on your own machines. Ship from your phone or your desk.

Plugins

Add themes, workspace panels, commands, settings screens, and coding-agent providers with trusted TypeScript plugins. Install from a local directory or Git repository with paseo plugin add <source>.

See the plugin docs for your Paseo version, or start with the 0.8 beta quickstart. Plugins run with access to your daemon machine and inside connected clients; install only code you trust.

Getting Started

Paseo runs a local server called the daemon that manages your coding agents. Clients like the desktop app, mobile app, web app, and CLI connect to it.

Prerequisites

You need at least one agent CLI installed and configured with your credentials:

Download it from paseo.sh/download or the GitHub releases page. Open the app and the daemon starts automatically. Nothing else to install.

To connect from your phone, open Settings → your host → Pair Device.

CLI / headless

Install the CLI and start Paseo:

npm install -g @getpaseo/cli
paseo

Paseo starts locally, then asks whether to enable the end-to-end encrypted relay for device pairing. If you decline, connect directly over TCP, Tailscale, or another VPN. This path is useful for servers and remote machines.

For full setup and configuration, see:

Docker

Run the Paseo daemon and self-hosted web UI in Docker:

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

Open http://localhost:6767 after it starts. Extend the base image with the agent CLIs you use, then provide credentials through environment variables or the persistent /home/paseo volume. See the Docker documentation for full setup details.

CLI

Everything you can do in the app, you can do from the terminal.

paseo run --provider claude/opus-4.6 "implement user authentication"
paseo run --provider codex/gpt-5.5 --worktree feature-x "implement feature X"

paseo ls                           # list running agents
paseo attach abc123                # stream live output
paseo send abc123 "also add tests" # follow-up task

# run on a remote daemon; --cwd is a path on that host
paseo run --host workstation.local:6767 --cwd /workspace "run the full test suite"

See the full CLI reference for more.

TypeScript SDK

Build issue integrations, dashboards, and orchestration services with @getpaseo/client:

import { createPaseoClient } from "@getpaseo/client";

const client = createPaseoClient({ url: "ws://127.0.0.1:6767/ws" });
await client.connect();

const agent = await client.agents.create({
  config: { provider: "codex/gpt-5.5" },
  cwd: "/Users/me/dev/storefront",
  prompt: "Review the current diff and name the riskiest change.",
});

const result = await agent.waitForFinish();
console.log(result.lastMessage);

await client.close();

See the SDK quickstart, recipes, and API reference.

Skills

Skills teach your agent to use Paseo to orchestrate other agents.

npx skills add getpaseo/paseo

Then use them in any agent conversation:

Development

Quick monorepo package map:

Common commands:

# run all local dev services
npm run dev

# run individual surfaces
npm run dev:server
npm run dev:app
npm run dev:desktop
npm run dev:website

# build the server stack
npm run build:server

# repo-wide checks
npm run typecheck

License

Apache-2.0

paseo (getpaseo/paseo)

Searching Database…

21.2K ·GitHub
Paseo
Что это такое?Paseo — это опенсорсный центр для управления кодинг-агентами: единый интерфейс, чтобы запускать Claude Code, Codex, Copilot, OpenCode и Pi параллельно на своих машинах — с компьютера или с телефона.
Так это десктоп-приложение, облачный сервис или библиотека, которую я подключаю в свой код?Это self-hosted решение: локальный сервер, который называется демоном, управляет вашими агентами, а к нему подключаются клиенты — десктоп-приложение, мобильные приложения, веб-приложение и CLI. Есть ещё TypeScript SDK для создания своих интеграций.
Как его запустить?Скачайте десктоп-приложение с paseo.sh/download или со страницы релизов на GitHub и просто откройте его — демон запустится автоматически, больше ничего ставить не нужно. Дальше можно привязать другие устройства.
Откуда берётся часть с ИИ — мне сначала нужно самому установить и настроить CLI агентов?Агентов приносите вы: должен быть установлен и настроен хотя бы один агентский CLI с вашими учётными данными — Claude Code, Codex, GitHub Copilot, OpenCode или Pi. Paseo ими управляет, но собственных моделей не содержит.
Есть ли какие-то риски, о которых стоит знать перед установкой плагинов?Плагины получают доступ к машине с демоном и работают внутри подключённых клиентов, поэтому в README предупреждают: устанавливайте только код, которому доверяете. Добавляются они командой paseo plugin add из локальной папки или Git-репозитория.
А правда можно управлять агентами с телефона, и как устройства соединяются?Да — есть клиенты для iOS, Android, десктопа, веба и CLI. Телефон привязывается из десктоп-приложения через Settings → ваш хост → Pair Device; через CLI доступен сквозным шифрованием защищённый relay для привязки, либо можно подключаться напрямую по TCP, Tailscale или другому VPN.
Мои агенты живут на мощном сервере — может, демон запустить там, а не на ноутбуке?Да. Режим CLI/headless как раз рассчитан на серверы и удалённые машины, а Docker-образ запускает демон плюс собственный веб-интерфейс — дополните образ нужными вам CLI агентов и передайте учётные данные через переменные окружения или том /home/paseo.
Не отправляется ли всё, что я делаю, разработчикам?Нет — в Paseo нет телеметрии, слежки и принудительных входов, а агенты работают на вашей машине в вашем привычном окружении для разработки. Опциональный relay зашифрован сквозным шифрованием, а для прямых подключений его можно вообще не использовать.
А можно пользоваться без рук?Да — голосовой режим позволяет надиктовывать задачи или обсуждать проблемы с агентом голосом вместо печати. Удобно, когда вы не за клавиатурой.
Что делают встроенные скиллы вроде /paseo-handoff и /paseo-committee?Они учат ваших агентов управлять друг другом: /paseo-handoff передаёт работу между агентами (планируем с Claude, реализуем с Codex), /paseo-advisor запускает отдельного агента для второго мнения без делегирования, а /paseo-committee собирает двух разных по подходу агентов для поиска первопричины и составления плана.
Можно ли построить поверх этого свои инструменты?Да — TypeScript SDK @getpaseo/client рассчитан на интеграции с таск-трекерами, дашборды и сервисы оркестрации; плагины на TypeScript добавляют темы, панели рабочего пространства, команды и даже новых провайдеров агентов; есть и отдельное расширение для VS Code (paseo-vscode).
What are similar projects?vicoa, orca, happy, 1code, t3code, hapi, rakazo, superset
Which topics is it in?ade, pi, expo, hermes, copilot, voice, opencode, orchestration, mobile-app, electron, sdk, multi-agent
Creator
getpaseo
Size
156.6 MB
Stars
21.2K
Updated
CommitOct 17Releasev0.11.4Oct 15
Age
1y
Commits · 90 Days