Paseo — единый интерфейс для оркестрации Claude Code, Codex, Copilot, OpenCode и Pi

Coding-агенты стали главным инструментом разработчика: Claude Code, Codex, GitHub Copilot, OpenCode, Pi — у каждого свой интерфейс, свои сильные стороны и свой любимый способ запуска. Работать в нескольких агентах одновременно — например, доверить планирование одному, а реализацию другому — почти всегда означает прыгать между терминалами и окнами приложений. Paseo решает именно эту проблему: это единый интерфейс, через который можно запускать, наблюдать и направлять несколько агентов параллельно — прямо с десктопа, телефона, веба или из CLI.

Ключевая идея Paseo — агенты запускаются на вашей собственной машине в полностью вашем окружении разработки. Это не облачный сервис: весь ваш тулинг, конфиги и skills остаются на месте, а Paseo лишь управляет процессами. Такой подход называют self-hosted оркестрацией кодинга, и у него есть очевидные преимущества: приватность, доступ к локальным ресурсам и возможность комбинировать провайдеров под каждую конкретную задачу.

Что такое Paseo

Paseo — это локальный сервер (daemon), который управляет вашими coding-агентами. Разные клиенты подключаются к этому серверу и через него запускают агентов:

• десктопное приложение (Electron) — рекомендуемый способ для повседневной работы;
• мобильное приложение (iOS и Android, на базе Expo);
• веб-интерфейс — self-hosted веб-версия для запуска, например, в Docker;
• CLI — весь функционал доступен и из терминала.

Общая схема проста: один процесс-демон на вашей машине, много клиентов, подключающихся к нему. Это позволяет, например, начать работу за десктопом, а потом проверить статус агентов с телефона, не прерывая текущую сессию.

Ключевые возможности

Self-hosted

Агенты выполняются на вашей машине с полным окружением разработки. Вы сохраняете свои инструменты, свои конфиги и свои skills. Paseo не забирает код в облако и не требует выносить рабочий процесс наружу.

Мультипровайдерность

Через один и тот же интерфейс запускаются агенты разных провайдеров: Claude Code, Codex, GitHub Copilot, OpenCode и Pi. Это позволяет выбирать подходящую модель под конкретную задачу: что-то дешевле и быстрее сделать в одном агенте, что-то сложнее — в другом.

Управление голосом

В мобильном режиме можно диктовать задачи или устно проговаривать проблемы — удобно, когда руки заняты или хочется работать без клавиатуры.

Кросс-устройства

Один процесс доступен с iOS, Android, десктопа, веба и CLI. Начали на рабочем столе — проверили с телефона — скриптовали из терминала.

Приватность-first

У Paseo нет телеметрии, трекинга и навязывания регистрации. Никаких принудительных логинов, ничего не уходит наружу без вашего ведома.

Начало работы

Требования

Нужен как минимум один установленный и настроенный CLI-агент с вашими учётными данными:

• Claude Code
• Codex
• GitHub Copilot
• OpenCode
• Pi

Десктопное приложение (рекомендуется)

Скачайте его с paseo.sh/download или со страницы релизов GitHub. Откройте приложение — и демон запустится автоматически, устанавливать ничего больше не нужно. Чтобы подключить телефон, откройте Settings → your host → Pair Device.

CLI / headless

Установите CLI и запустите Paseo:

npm install -g @getpaseo/cli
paseo

При первом запуске Paseo спросит, включать ли end-to-end зашифрованный relay для сопряжения устройств. Если отказаться, можно подключаться напрямую по TCP, через Tailscale или другой VPN. Этот путь хорошо подходит для серверов и удалённых машин.

Дальше — документация, гайд по связности и справочник конфигурации.

Docker

Демон и self-hosted веб-интерфейс можно запустить в 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

После старта откройте http://localhost:6767. Базовый образ можно расширить нужными CLI-агентами, а креды передать через переменные окружения или постоянный том /home/paseo. Подробности — в документации Docker.

CLI

Всё, что можно делать в приложении, доступно и из терминала:

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
paseo --host workstation.local:6767 run "run the full test suite"

Полный справочник CLI — в документации.

TypeScript SDK

Для встраивания Paseo в ваши интеграции — обработчики issues, дашборды, сервисы оркестрации — есть официальный клиент @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();

Материалы по SDK: quickstart, рецепты и справочник API.

Skills для оркестрации

Отдельный интерес — skills, которые обучают агента использовать 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 — CLI paseo для работы с демоном и агентами;
• packages/desktop — десктопное приложение на Electron;
• packages/relay — relay-транспорт и шифрование, используемые демоном и клиентами;
• packages/website — маркетинговый сайт и документация (paseo.sh).

Часто используемые команды:

# 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

Экосистема и связанные проекты

• getpaseo/paseo-relay — официальный распределённый relay, написанный на Elixir;
• paseo-skins — комьюнити-темы и zero-patch загрузчик десктоп-тем с Agent Skill;
• paseo-vscode — расширение для VS Code.

Лицензия проекта — AGPL-3.0.

Кому подойдёт

Paseo будет полезен тем, кто уже вышел за пределы одного агента. Если вы пробовали запускать несколько сессий Claude Code, сравнивали Codex и OpenCode на одной и той же задаче или хотите устроить «мнения двух агентов» перед большим рефакторингом — именно здесь Paseo проявляет себя сильнее всего. Self-hosted архитектура делает его пригодным и для удалённых машин: можно поднять демон на сервере или домашней рабочей станции и обращаться к нему по TCP, через Tailscale или другой VPN, а CLI-флаг --host позволит управлять удалённым агентом локально.

При этом стоит помнить особенности: вам понадобится хотя бы один установленный CLI-агент (Claude Code, Codex, Copilot, OpenCode или Pi), а сопряжение устройств с телефона предполагает либо использование end-to-end зашифрованного relay, либо настройку собственного сетевого доступа. Это небольшая плата за приватность и контроль, которые даёт self-hosted подход.

Вывод

Paseo закрывает неудобный разрыв между «агентами есть, а связного управления ними нет». Это не просто запускалка процессов: это единый управляющий слой для нескольких провайдеров, доступный с любых устройств и полностью self-hosted. Если вы уже работаете с Claude Code, Codex или OpenCode и хотите запускать агентов параллельно — подключать их к задачам с телефона или строить поверх них пайплайны оркестрации через SDK, — Paseo стоит попробовать.