Paseo — Orchestrate Coding Agents from Your Phone

Introduction

Paseo bridges the gap between your coding agents and your daily routine. It provides a mobile-friendly interface and CLI for dispatching tasks to agents like Claude Code, Codex, and Gemini CLI, then tracks their progress and surfaces results when they finish.

What Paseo Does

• Dispatches coding tasks to AI agents from a mobile web UI, desktop app, or CLI
• Monitors agent progress with real-time status updates and log streaming
• Supports multiple agent backends including Claude Code, Codex CLI, and OpenCode
• Queues tasks and manages execution across parallel agent sessions
• Provides a unified task history with diffs and output for review

Architecture Overview

Paseo is a TypeScript application with a responsive web frontend optimized for mobile screens. A lightweight server process runs alongside your agent runtime, accepting task requests via API and routing them to the configured agent. WebSocket connections push live updates to connected clients. Task state and history are persisted locally in SQLite.

Self-Hosting & Configuration

• Install globally via npm or run from source with npm install && npm run dev
• Configure agent backends in ~/.paseo/config.json (supports Claude Code, Codex, OpenCode)
• The server binds to localhost by default; expose via tunnel or reverse proxy for mobile access
• Authentication uses a shared token configured at setup time
• Tasks and logs stored in ~/.paseo/data.db (SQLite)

Key Features

• Mobile-first web UI designed for on-the-go task dispatch
• Multi-agent support with automatic backend selection
• Real-time log streaming and status updates via WebSocket
• Task queuing for sequential or parallel execution
• Lightweight footprint; runs alongside your existing dev environment

Comparison with Similar Tools

• Claude Code CLI — direct terminal interaction; Paseo adds remote dispatch and mobile monitoring
• Superset — multi-agent desktop IDE; Paseo focuses on remote orchestration from any device
• Mission Control — dashboard-centric; Paseo emphasizes mobile-first quick task dispatch
• Ralph — autonomous loops; Paseo is task-oriented with human-initiated dispatch

FAQ

Q: Do I need a cloud server? A: No. Paseo runs on your dev machine. Use a tunnel like Cloudflare or Tailscale for mobile access.

Q: Which agents are supported? A: Claude Code, Codex CLI, OpenCode, and Gemini CLI. Additional backends can be added via plugins.

Q: Can I review code changes before they are committed? A: Yes. Paseo surfaces diffs for each completed task so you can review and approve changes.

Q: Is it open source? A: Yes, Paseo is open source and available on GitHub.

Sources

• https://github.com/getpaseo/paseo