Paseo
One interface to orchestrate multiple coding agents (Claude Code, Codex, Copilot, OpenCode, Pi) from desktop and mobile.
Evidence shows: SECURITY.md details the relay threat model, end-to-end encryption, DNS rebinding protection, HTML preview sandbox, and agent authentication boundaries, indicating a clear understanding of data flow and security boundaries. However, there is no user confirmation mechanism (e.g., confirmation prompts before sensitive actions) and no rollback functionality. Dependency security: CI includes lockfile-lint and npm audit signatures, but no vulnerability scan results are provided. External effects: agents can execute arbitrary commands, but documentation does not explain how to limit or rollback. Source attribution: author identity is clear, but publisher is unverified. Therefore, least privilege, user confirmation, external effects, rollback, and source attribution score low.
Evidence shows: README and SECURITY.md describe architecture and features consistently, and CI configures multi-platform tests, indicating good self-consistency. Dependency availability: uses npm workspaces, but no dependency locking or mirror information is provided. Failure messages: CLI tests check error output, but no user-friendly error handling documentation is provided. Therefore, self-consistency and dependency availability score moderate, failure messages score low.
Evidence shows: README describes multiple usage scenarios (desktop, mobile, CLI, voice control) and supports multiple agent providers, indicating good audience and scenario coverage. Capability boundaries: documentation describes supported agents and features, but no explicit limitations. Trigger precision: CLI commands and skills have clear usage, but no detailed trigger conditions. Environment fit: supports multiple platforms and self-hosting, but no detailed system requirements. Therefore, audience and scenarios, capability boundaries, environment fit score moderate, trigger precision score low.
Evidence shows: README provides clear information architecture, including installation, CLI, skills, development sections. Installation notes are detailed, including desktop app and CLI. Naming stability: project name and CLI commands are consistent, but no naming conventions. Examples and FAQ: README provides CLI examples, but lacks FAQ. Known limitations: SECURITY.md mentions HTML preview limitations, but not comprehensive. License is AGPL-3.0, but metadata is NOASSERTION. Versioning and changelog: version number exists but no changelog. Maintenance responsibility: author is clear, but no contribution guidelines. Therefore, information architecture, installation notes, examples and FAQ, license score moderate, naming stability, known limitations, versioning and changelog, maintenance responsibility score low.
Evidence shows: Output usability: CLI provides clear commands and output, but no output format documentation. Marginal value: tool provides multi-agent orchestration and cross-device access, offering unique value. Cost-benefit: self-hosted and open-source, but no performance or resource consumption data. Therefore, output usability and marginal value score moderate, cost-benefit score low.
Evidence shows: Claims in README (e.g., privacy-first, end-to-end encryption) are detailed in SECURITY.md, but no independent verification. Cross-source corroboration: community links exist, but no third-party audit. Fact-inference separation: documentation distinguishes facts and inferences, but not explicitly labeled. Therefore, all sub-items score low.
- Publisher identity is unverified; treat with caution.
- Lack of user confirmation and rollback mechanisms; be cautious when executing sensitive operations.
- Dependency security relies only on CI checks; no vulnerability scan results provided.
- HTML preview has navigation escape risk; use Source view for untrusted pages.
- Local daemon trusts network reachability by default; configure password when exposing beyond loopback.
What does this agent do, and when should you use it?
Paseo is a self-hosted coding agent orchestration platform that provides a unified interface to manage multiple agents from a single place. It runs a local daemon that manages agent processes, exposing a WebSocket API and MCP server. Clients include a desktop app (Electron), mobile apps (Expo for iOS/Android), web app, and CLI (`paseo`). It supports multiple providers including Claude Code, Codex, GitHub Copilot, OpenCode, and Pi, allowing users to pick the right model for each job. Paseo emphasizes privacy with no telemetry, offers voice control, and enables cross-device connectivity via a relay with optional end-to-end encryption. Use cases include running agents in parallel, checking in from your phone, and scripting workflows from the terminal. Paseo also provides a TypeScript SDK (`@getpaseo/client`) for building custom integrations.
Paseo runs a local daemon that manages the lifecycle of coding agents. It communicates with desktop, mobile, web, and CLI clients via a WebSocket API, and uses an MCP server for skill integrations. Users can launch agents via CLI commands like paseo run --provider claude/opus-4.6 "implement user authentication" or paseo run --provider codex/gpt-5.5 --worktree feature-x "implement feature X", list running agents with paseo ls, attach to live output with paseo attach abc123, and send follow-up tasks with paseo send abc123 "also add tests". It supports running multiple agents in parallel and provides voice input mode. Clients can connect to the daemon via a relay or directly over TCP/Tailscale. The TypeScript SDK allows developers to create agents, wait for completion, and retrieve results.
- A developer who starts work on their desktop and wants to check in from their phone while commuting.
- A team that wants to switch between different models (e.g., Claude for planning, Codex for implementation) through the same interface.
- A user who needs to run multiple agents in parallel for different features and automate via CLI scripts.
- A remote headless server environment where agents are managed via CLI and web UI.
- A user who wants to use voice commands to control coding agents while doing other tasks.
- A developer who wants to run agents on their own machine to keep the full dev environment and custom configurations.
What are this agent's strengths and limitations?
- Supports multiple agent providers (Claude Code, Codex, Copilot, OpenCode, Pi) with flexible selection.
- Cross-device support (desktop, mobile, web, CLI) enables mobile productivity.
- Self-hosted and privacy-first with no telemetry or tracking.
- Provides a CLI and TypeScript SDK for automation and integration.
- Voice control offers hands-free operation, increasing efficiency.
- Requires the user to install and configure at least one agent CLI with credentials, adding initial setup cost.
- Depends on external provider services (Anthropic, OpenAI, GitHub) which require network access and respective subscriptions.
- Docker deployment requires additional configuration for agent CLIs and credentials, with a learning curve.
- The project is licensed under AGPL-3.0, which may restrict commercial integration.
- The relay service is optional with end-to-end encryption, but users need to understand network configuration to use it securely.
How do you install or deploy this agent?
Install the CLI globally: npm install -g @getpaseo/cli, then run paseo to start the daemon. Alternatively, download the desktop app from paseo.sh/download or from GitHub releases. For Docker deployment: 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, then open http://localhost:6767. You must have at least one agent CLI installed and configured (e.g., Claude Code, Codex, GitHub Copilot, OpenCode, or Pi).
How do you use this agent?
After starting Paseo, run an agent with paseo run --provider <provider> '<prompt>'. List running agents with paseo ls, attach to an agent's output with paseo attach <id>, and send follow-up tasks with paseo send <id> 'additional instructions'. For mobile pairing, open the app and go to Settings → Your Host → Pair Device. To use the TypeScript SDK, install with npm install @getpaseo/client, then use createPaseoClient to connect over WebSocket and create agents.