# Paseo

> Mobile and desktop app for monitoring and controlling your local AI coding agents from anywhere. Your dev environment, in your pocket.

Paseo is an open source application that lets you run AI coding agents on your own machine and drive them from your phone, desktop, browser, or terminal. Your code stays local — Paseo connects directly to your real development environment instead of running agents in someone else's cloud.

A self-hosted daemon manages agent lifecycle, exposes a WebSocket API, and ships with an MCP server so other agents can talk to it. Native apps for iOS, Android, macOS, Windows, Linux, and the web let you launch sessions, watch them work, review diffs, and ship from anywhere. A Docker-style CLI ("paseo run", "paseo ls", "paseo logs", "paseo wait") gives you scripting access. An end-to-end encrypted relay lets the mobile app reach your daemon over the public internet without exposing it.

Paseo supports every major coding agent: Claude Code, Codex, GitHub Copilot, OpenCode, Cursor, Gemini, Cline, Goose, Amp, Aider, and 30+ others. Each agent runs as its own process; Paseo handles I/O, persistence, git worktree isolation, schedules, and skills.

Distribution: native apps for Mac, Windows, Linux, iOS, and Android; web app; Homebrew; npm. Source: AGPL-3.0 at https://github.com/getpaseo/paseo. Marketing site: https://paseo.sh.

## Docs

- [Getting started](https://paseo.sh/docs.md): Install Paseo and start running coding agents from anywhere.
- [Why Paseo?](https://paseo.sh/docs/why.md): What Paseo is, what it isn't, and how it fits into your workflow.
- [CLI](https://paseo.sh/docs/cli.md): Paseo CLI reference: manage agents, workspaces, scripts, schedules, daemons, and permissions from your terminal.
- [Connectivity](https://paseo.sh/docs/connectivity.md): Connect a Paseo client to your daemon through the relay or Tailscale.
- [Security](https://paseo.sh/docs/security.md): Security model for Paseo: architecture overview, connection methods, relay encryption, and best practices.
- [Updates](https://paseo.sh/docs/updates.md): How Paseo releases work, the difference between stable and beta channels, and how to opt in to earlier updates.
- [Docker](https://paseo.sh/docs/docker.md): Run the Paseo daemon and bundled web UI with the official Docker image.
- [Self-hosting the web UI](https://paseo.sh/docs/web-ui.md): Serve the Paseo web app from your own daemon and reach it over your own LAN, VPN, reverse proxy, or tunnel.
- [Related projects](https://paseo.sh/docs/community.md): The official Paseo relay and community-built tools and integrations.
- [Workspaces](https://paseo.sh/docs/workspaces.md): Understand how Paseo groups working directories, agents, terminals, and browsers into workspaces.
- [Git worktrees](https://paseo.sh/docs/worktrees.md): Run agents in isolated git worktrees with setup hooks, scripts, and long-running services.
- [Providers](https://paseo.sh/docs/providers.md): How Paseo thinks about coding agents, wrapping existing CLIs, native vs ACP support, and where to go next.
- [Supported providers](https://paseo.sh/docs/supported-providers.md): Every coding agent Paseo can launch, natively supported providers and the ACP catalog.
- [Custom providers](https://paseo.sh/docs/custom-providers.md): Configure custom providers, alternative endpoints, profiles, custom binaries, and ACP agents in ~/.paseo/config.json.
- [Claude Code](https://paseo.sh/docs/claude-code.md): Run Claude Code in Paseo using your existing Claude plan.
- [Codex](https://paseo.sh/docs/codex.md): Run Codex in Paseo using the official Codex CLI and your existing OpenAI account.
- [Schedules](https://paseo.sh/docs/schedules.md): Run fresh agents on cron schedules or wake an existing agent with a heartbeat.
- [Schedules from chat](https://paseo.sh/docs/schedules-chat.md): Ask an agent in chat to set up and manage a schedule for you.
- [Schedules from the CLI](https://paseo.sh/docs/schedules-cli.md): Create and manage Paseo schedules with paseo schedule.
- [Orchestration](https://paseo.sh/docs/orchestration.md): Give any coding agent control of Paseo so it can launch and coordinate agents from other providers.
- [Common orchestration workflows](https://paseo.sh/docs/orchestration-workflows.md): Copyable prompts for delegating, parallelizing, reviewing, and continuing agent work with Paseo.
- [Orchestration skills](https://paseo.sh/docs/skills.md): Paseo orchestration skills: teach coding agents to spawn, coordinate, and manage other agents using slash commands.
- [MCP reference](https://paseo.sh/docs/mcp.md): Reference for the Paseo tools agents use to manage agents, workspaces, scripts, terminals, and schedules.
- [Browser automation](https://paseo.sh/docs/browser.md): Give agents a real browser inside Paseo to open pages, click, type, and verify their work.
- [When to use the Paseo browser](https://paseo.sh/docs/browser-when.md): When to reach for Paseo's built-in browser instead of Playwright or agent-browser.
- [Browser tools](https://paseo.sh/docs/browser-tools.md): The browser_* MCP tools agents use to drive Paseo browser tabs.
- [Configuration](https://paseo.sh/docs/configuration.md): Configure Paseo via config.json, environment variables, and CLI overrides.
- [Voice](https://paseo.sh/docs/voice.md): Paseo voice architecture, local-first model execution, and provider configuration.
- [Metadata generation](https://paseo.sh/docs/metadata-generation.md): How Paseo uses providers to generate branch names, commit messages, and pull request text, and how to configure them.
- [TypeScript SDK](https://paseo.sh/docs/sdk.md): Run Paseo coding agents from a TypeScript program.
- [Hub](https://paseo.sh/docs/hub.md): The layer above your daemons. Register them, give them capabilities, and share them with your team.
- [Troubleshooting](https://paseo.sh/docs/troubleshooting.md): Why Paseo can't find a provider you've installed, and how to fix the PATH and environment mismatches behind most setup issues.

## Alternatives

- [Open Source Conductor Alternative With Linux, Windows, and Mobile](https://paseo.sh/alternatives/conductor): Paseo is open source, runs on macOS, Linux, and Windows, ships native iOS and Android apps, and supports 30+ agents through the in-app catalog plus any ACP or CLI agent. Conductor is macOS only and Claude Code or Codex only.
- [Superset Alternative With Linux, Windows, and Mobile](https://paseo.sh/alternatives/superset): Paseo is open source under an OSI license, has no login wall, ships native mobile, and runs on macOS, Linux, and Windows. Superset is source-available, macOS only, and gates the desktop app on a Superset login.
- [OpenChamber Alternative With Linux, Windows, and Mobile](https://paseo.sh/alternatives/openchamber): Paseo ships native iOS and Android apps, runs on macOS, Linux, and Windows, and supports 30+ agents. OpenChamber is macOS only with a PWA and is built around OpenCode.
- [Happy Coder Alternative With a Desktop App and Git Worktrees](https://paseo.sh/alternatives/happy-coder): Paseo ships a native desktop app, runs agents in isolated git worktrees, and supports 30+ agents. Happy Coder is mobile and web only, wraps the agent CLI, and supports Claude Code and Codex.
- [Open Source Codex App Alternative With Linux, Mobile, and Multi-Provider Support](https://paseo.sh/alternatives/codex-app): Paseo is an open source alternative to Codex App for developers who want Linux, native mobile apps, a self-hosted daemon, and Codex alongside Claude Code, OpenCode, Copilot, and more.
- [Open Source Claude Desktop Alternative With Linux, Mobile, and Multi-Provider Support](https://paseo.sh/alternatives/claude-desktop): Paseo is an open source Claude Desktop alternative for developers who want Linux, self-hosting, native mobile apps, and Claude Code alongside Codex, OpenCode, Copilot, and more.
- [OpenCode Desktop Alternative With Native Mobile and Multi-Provider Orchestration](https://paseo.sh/alternatives/opencode-desktop): Paseo is an OpenCode Desktop alternative for developers who want native mobile apps, a self-hosted daemon, and OpenCode alongside Claude Code, Codex, Copilot, and more.

## Supported agents

- [Claude Code](https://paseo.sh/claude-code): Run Claude Code on your machine, drive it from your phone or desktop. Launch agents, watch them work, review and merge from anywhere.
- [Codex](https://paseo.sh/codex): Run OpenAI's Codex on your machine, drive it from your phone or desktop. Same setup, same machine, no laptop required.
- [OpenCode](https://paseo.sh/opencode): Run OpenCode on your machine, drive it from your phone or desktop. Open source on both ends, your code stays local.
- [GitHub Copilot](https://paseo.sh/copilot): Drive GitHub Copilot from your phone or desktop. Same account, same machine, ship without sitting down at your desk.
- [OMP (Oh My Pi)](https://paseo.sh/omp): Run OMP (Oh My Pi) on your machine, drive it from your phone or desktop. Self-hosted and open source.
- [Pi Agent](https://paseo.sh/pi): Run the Pi coding agent on your machine, drive it from your phone or desktop. Self-hosted and open source.
- [Cursor](https://paseo.sh/cursor): Send tasks to Cursor on your machine, drive it from your phone or desktop. Review the diff anywhere.
- [Gemini CLI](https://paseo.sh/gemini): Run Google's Gemini CLI on your machine, drive it from your phone or desktop. Real coding work, no laptop required.
- [Hermes Agent](https://paseo.sh/hermes): Run Nous Research's Hermes Agent on your machine, drive it from your phone or desktop.
- [Qwen Code](https://paseo.sh/qwen-code): Run Alibaba's Qwen Code on your machine, drive it from your phone or desktop.
- [Kimi Code CLI](https://paseo.sh/kimi): Run Moonshot AI's Kimi Code CLI on your machine, drive it from your phone or desktop.
- [Amp](https://paseo.sh/amp): Run Sourcegraph's Amp on your machine, drive it from your phone or desktop. Frontier coding, no laptop required.
- [Auggie CLI](https://paseo.sh/auggie): Run Augment Code's Auggie CLI on your machine, drive it from your phone or desktop.
- [Cline](https://paseo.sh/cline): Run the Cline coding agent on your machine, drive it from your phone or desktop. Watch it work, jump in when needed.
- [Codebuddy Code](https://paseo.sh/codebuddy): Run Tencent Cloud's Codebuddy on your machine, drive it from your phone or desktop.
- [Cortex Code](https://paseo.sh/cortex-code): Run Snowflake's Cortex Code on your machine, drive it from your phone or desktop. No laptop required.
- [Corust Agent](https://paseo.sh/corust): Build Rust with the Corust agent on your machine, drive it from your phone or desktop.
- [crow-cli](https://paseo.sh/crow): Run crow-cli, the minimal ACP-native coding agent, on your machine. Drive it from your phone or desktop.
- [DeepAgents](https://paseo.sh/deepagents): Run LangChain's DeepAgents on your machine, drive it from your phone or desktop. Batteries included.
- [CodeWhale](https://paseo.sh/deepseek-tui): Run CodeWhale's DeepSeek V4 terminal coding agent on your machine, drive it from your phone or desktop.
- [DimCode](https://paseo.sh/dimcode): Leading models, one command. Run DimCode on your machine, drive it from your phone or desktop.
- [Dirac](https://paseo.sh/dirac): Run Dirac's hash-anchored parallel edits on your machine, drive it from your phone or desktop.
- [Factory Droid](https://paseo.sh/factory-droid): Run Factory's Droid coding agent on your machine, drive it from your phone or desktop.
- [fast-agent](https://paseo.sh/fast-agent): Run fast-agent, the multi-provider coding agent, on your machine. Drive it from your phone or desktop.
- [GLM Agent](https://paseo.sh/glm): Run Zhipu AI's GLM coding agent on your machine, drive it from your phone or desktop. Streaming, mid-session model switching.
- [goose](https://paseo.sh/goose): Run Block's goose on your machine, drive it from your phone or desktop. Local, extensible, open source.
- [Junie](https://paseo.sh/junie): Run JetBrains' Junie on your machine, drive it from your phone or desktop. Real work, no IDE required.
- [Kilo Code](https://paseo.sh/kilo): Run Kilo Code on your machine, drive it from your phone or desktop. Send tasks, watch them ship.
- [Minion Code](https://paseo.sh/minion-code): Run Minion Code's framework agent on your machine, drive it from your phone or desktop.
- [Mistral Vibe](https://paseo.sh/mistral-vibe): Run Mistral's open-source Vibe assistant on your machine, drive it from your phone or desktop.
- [Nova](https://paseo.sh/nova): Run Compass AI's Nova on your machine, drive it from your phone or desktop.
- [Poolside](https://paseo.sh/poolside): Drive Poolside's coding agent from your phone or desktop. Kick off the work, watch it land.
- [Qoder CLI](https://paseo.sh/qoder): Run the Qoder agentic coding assistant on your machine, drive it from your phone or desktop.
- [siGit Code](https://paseo.sh/sigit): Run siGit's local-first coding agent on your machine, drive it from your phone or desktop. Optional on-device LLM inference.
- [Stakpak](https://paseo.sh/stakpak): Run Stakpak's Rust-based DevOps agent on your machine, drive it from your phone or desktop.
- [VT Code](https://paseo.sh/vtcode): Run VT Code's multi-provider coding agent on your machine, drive it from your phone or desktop.
- [Agoragentic](https://paseo.sh/agoragentic): Run Agoragentic's 174+ AI capabilities on your machine, drive it from your phone or desktop.
- [Autohand Code](https://paseo.sh/autohand): Run Autohand AI's coding agent on your machine, drive it from your phone or desktop.
- [Grok](https://paseo.sh/grok): Run xAI's Grok Build coding agent on your machine, drive it from your phone or desktop.

## Optional

- [Changelog](https://paseo.sh/changelog): Release notes for the Paseo daemon, CLI, desktop, and mobile apps.
- [Download](https://paseo.sh/download): Install Paseo on Mac, Windows, Linux, iOS, Android, or run the web app.
- [Paseo Hub](https://paseo.sh/hub): Optional service above your daemons that adds GitHub, Slack, and Discord triggers. Self-hosted, private beta.
- [Blog](https://paseo.sh/blog): Updates and technical posts from the Paseo team.
- [Privacy](https://paseo.sh/privacy): Privacy policy.
- [GitHub](https://github.com/getpaseo/paseo): Source code, issues, and releases.