Paseo provides a unified interface for managing coding agents across various devices, including phones, desktops, and the command line. It targets developers and power users seeking to run agents remotely and efficiently on their own infrastructure, leveraging their existing development environments and tools. The primary benefit is seamless agent control and execution from any platform, enhancing productivity and flexibility.

How It Works

Paseo employs a monorepo architecture, orchestrating agent processes via a daemon (packages/server) that exposes a WebSocket API. This daemon runs locally on the user's machine, ensuring agents utilize the full development environment, tools, and configurations. A cross-platform client layer, including Expo-based mobile/web apps (packages/app), an Electron desktop app (packages/desktop), and a CLI (packages/cli), connects to this daemon, enabling remote interaction and task management. This design prioritizes self-hosted execution and local environment integrity.

Quick Start & Requirements

• Desktop App: Download from paseo.sh or the GitHub releases page. This bundles the daemon.
• Headless/Server Mode: Install the CLI globally (npm install -g @getpaseo/cli) and run paseo. Connect using other clients.
• Development: Run local dev services with npm run dev. Individual services can be started with npm run dev:server, npm run dev:app, etc.
• Prerequisites: Node.js is required for CLI and development workflows.
• Links: Documentation and downloads are available at paseo.sh.

Highlighted Details

• Cross-Device Control: Manage agents from iOS, Android, desktop, web, and CLI interfaces.
• Voice Control: Dictate tasks or discuss problems using voice commands for hands-free operation.
• Multi-Provider Support: Integrates with various coding models including Claude Code, Codex, and OpenCode through a single interface.
• Self-Hosted Agents: Agents execute on the user's machine, preserving full access to local development environments and configurations.

Maintenance & Community

No specific details regarding maintainers, community channels (like Discord/Slack), or roadmaps were provided in the README snippet.

Licensing & Compatibility

The project is licensed under the AGPL-3.0 license. This strong copyleft license requires any derivative works to also be made available under the AGPL-3.0. Compatibility for commercial use or linking within closed-source projects is significantly restricted due to these terms.

Limitations & Caveats

The provided README does not detail specific limitations, alpha/beta status, known bugs, or unsupported platforms. The AGPL-3.0 license imposes significant obligations on users who modify or distribute the software, potentially limiting adoption in commercial or proprietary contexts.