Paseo: Interface de Código Aberto para Claude Code, Codex, Copilot, OpenCode e Agentes Pi

Paseo é uma interface de código aberto para agentes de codificação que permite executar Claude Code, Codex, GitHub Copilot, OpenCode e Pi a partir de um único painel — no seu celular, desktop ou CLI. É auto-hospedado, prioriza a privacidade e suporta controle por voz.

Como Funciona

O Paseo executa um daemon local que gerencia processos de agentes. Os clientes (aplicativo desktop, aplicativo móvel, aplicativo web, CLI) se conectam a ele via WebSocket. Os agentes executam na sua máquina com todo o seu ambiente de desenvolvimento, ferramentas, configurações e habilidades.

Principais Recursos

• Multi-provedor: Claude Code, Codex, Copilot, OpenCode e Pi através da mesma interface. Escolha o modelo certo para cada tarefa.
• Controle por voz: Dite tarefas ou converse sobre problemas sem usar as mãos.
• Entre dispositivos: iOS, Android, desktop, web e CLI. Comece na sua mesa, acompanhe pelo celular, automatize pelo terminal.
• Privacidade em primeiro lugar: Sem telemetria, rastreamento ou logins forçados.
• Agentes paralelos: Execute vários agentes simultaneamente em suas próprias máquinas.

Primeiros Passos

Pré-requisitos: pelo menos um CLI de agente instalado e configurado. O aplicativo desktop é recomendado — baixe em paseo.sh/download ou na página de releases do GitHub. Abra o aplicativo e o daemon inicia automaticamente. Para conectar do seu celular, escaneie o QR Code em Configurações.

Para configuração CLI / headless:

npm install -g @getpaseo/cli
paseo

Isso mostra um QR Code no terminal. Conecte-se de qualquer cliente.

Comandos CLI (Reproduzidos da Fonte)

Execute agentes, liste-os, anexe-se à saída ao vivo e envie acompanhamentos:

paseo run --provider claude/opus-4.6 "implementar autenticação de usuário"
paseo run --provider codex/gpt-5.4 --worktree feature-x "implementar funcionalidade X"
paseo ls
paseo attach abc123
paseo send abc123 "adicione também testes"

Conecte-se a um daemon remoto com --host:

paseo --host workstation.local:6767 run "execute a suíte completa de testes"

Habilidades (Orquestração de Agentes)

Instale habilidades para ensinar agentes a orquestrar outros agentes:

npx skills add getpaseo/paseo

Depois, use em qualquer conversa com o agente:

• /paseo-handoff — transfira trabalho entre agentes (ex.: planeje com Claude, passe para Codex implementar).
• /paseo-loop — faça um loop de um agente contra critérios de aceitação (loops de Ralph), opcionalmente com um verificador.
• /paseo-advisor — inicie um único agente como conselheiro para uma segunda opinião.
• /paseo-committee — forme um comitê de dois agentes contrastantes para análise de causa raiz e planejamento.

Desenvolvimento

O monorepo inclui pacotes:

• packages/server — daemon (orquestração de agentes, API WebSocket, servidor MCP)
• packages/app — cliente Expo (iOS, Android, web)
• packages/cli — CLI para daemon e fluxos de trabalho de agentes
• packages/desktop — aplicativo desktop Electron
• packages/relay — conectividade remota
• packages/website — site de marketing e documentação

Comandos comuns:

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

Relé Auto-Hospedado

Para acesso remoto ao daemon, use o relé Go auto-hospedado. Nota: relés auto-hospedados usam ws:// a menos que TLS seja optado. Configure com variáveis de ambiente:

PASEO_RELAY_ENDPOINT=127.0.0.1:8080
PASEO_RELAY_PUBLIC_ENDPOINT=relay.example.com