Mohamed Boudra 7f9dafab68 refactor(cli): deduplicate command options between top-level and agent subcommands
Extract addXxxOptions() builder functions for all 9 shared commands
(ls, run, attach, logs, stop, delete, send, inspect, wait) so both
paseo <cmd> and paseo agent <cmd> use a single source of truth.

Fixes drift where agent subcommands were missing --wait-timeout (run),
--worktree/--base/--image (run), --since (logs), and --image (send).
2026-03-23 10:33:06 +07:00
2026-03-06 16:49:40 +01:00
2026-03-06 16:49:40 +01:00
2026-02-25 13:53:23 +07:00
2026-02-05 15:08:41 +07:00

Paseo logo

Paseo

One interface for all your coding agents.

Paseo app screenshot


Run agents in parallel on your own machines. Ship from your phone or your desk.

  • Self-hosted — Agents run on your machine with your full dev environment. Use your tools, your configs, and your skills.
  • Multi-provider — Claude Code, Codex, and OpenCode through the same interface. Pick the right model for each job.
  • Voice control — Dictate tasks or talk through problems in voice mode. Hands-free when you need it.
  • Cross-device — iOS, Android, desktop, web, and CLI. Start work at your desk, check in from your phone, script it from the terminal.

Getting Started

Download the desktop app from paseo.sh or the GitHub releases page — it bundles the daemon so there's nothing else to install.

Headless / server mode

To run the daemon on a remote or headless machine:

npm install -g @getpaseo/cli
paseo

Then connect from the desktop app, mobile app, or CLI.

For full setup and configuration, see:

Development

Quick monorepo package map:

  • packages/server: Paseo daemon (agent process orchestration, WebSocket API, MCP server)
  • packages/app: Expo client (iOS, Android, web)
  • packages/cli: paseo CLI for daemon and agent workflows
  • packages/desktop: Electron desktop app
  • packages/relay: Relay package for remote connectivity
  • packages/website: Marketing site and documentation (paseo.sh)

Common commands:

# run all local dev services
npm run dev

# run individual surfaces
npm run dev:server
npm run dev:app
npm run dev:website

# repo-wide checks
npm run typecheck

License

AGPL-3.0

Languages
TypeScript 98.1%
JavaScript 1.3%
Shell 0.1%
Swift 0.1%