mirror of
https://github.com/getpaseo/paseo.git
synced 2026-07-29 12:01:31 +00:00
ce4b0d54c7
Apply prettier-compatible formatting across the repo to match the incoming oxfmt configuration. Mechanical reformat only — no logic changes. Covers YAML quote normalization, package.json key sorting, Markdown/TOML formatting, and minor TS whitespace tweaks.
150 lines
5.0 KiB
Markdown
150 lines
5.0 KiB
Markdown
<p align="center">
|
|
<img src="packages/website/public/logo.svg" width="64" height="64" alt="Paseo logo">
|
|
</p>
|
|
|
|
<h1 align="center">Paseo</h1>
|
|
|
|
<p align="center">
|
|
<a href="https://github.com/getpaseo/paseo/stargazers">
|
|
<img src="https://img.shields.io/github/stars/getpaseo/paseo?style=flat&logo=github" alt="GitHub stars">
|
|
</a>
|
|
<a href="https://github.com/getpaseo/paseo/releases">
|
|
<img src="https://img.shields.io/github/v/release/getpaseo/paseo?style=flat&logo=github" alt="GitHub release">
|
|
</a>
|
|
<a href="https://x.com/moboudra">
|
|
<img src="https://img.shields.io/badge/%40moboudra-555?logo=x" alt="X">
|
|
</a>
|
|
<a href="https://discord.gg/jz8T2uahpH">
|
|
<img src="https://img.shields.io/badge/Discord-555?logo=discord" alt="Discord">
|
|
</a>
|
|
</p>
|
|
|
|
<p align="center">One interface for all your Claude Code, Codex and OpenCode agents.</p>
|
|
|
|
<p align="center">
|
|
<img src="https://paseo.sh/hero-mockup.png" alt="Paseo app screenshot" width="100%">
|
|
</p>
|
|
|
|
<p align="center">
|
|
<img src="https://paseo.sh/mobile-mockup.png" alt="Paseo mobile app" width="100%">
|
|
</p>
|
|
|
|
---
|
|
|
|
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.
|
|
- **Privacy-first:** Paseo doesn't have any telemetry, tracking, or forced log-ins.
|
|
|
|
## Getting Started
|
|
|
|
Paseo runs a local server called the daemon that manages your coding agents. Clients like the desktop app, mobile app, web app, and CLI connect to it.
|
|
|
|
### Prerequisites
|
|
|
|
You need at least one agent CLI installed and configured with your credentials:
|
|
|
|
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code)
|
|
- [Codex](https://github.com/openai/codex)
|
|
- [OpenCode](https://github.com/anomalyco/opencode)
|
|
|
|
### Desktop app (recommended)
|
|
|
|
Download it from [paseo.sh/download](https://paseo.sh/download) or the [GitHub releases page](https://github.com/getpaseo/paseo/releases). Open the app and the daemon starts automatically. Nothing else to install.
|
|
|
|
To connect from your phone, scan the QR code shown in Settings.
|
|
|
|
### CLI / headless
|
|
|
|
Install the CLI and start Paseo:
|
|
|
|
```bash
|
|
npm install -g @getpaseo/cli
|
|
paseo
|
|
```
|
|
|
|
This shows a QR code in the terminal. Connect from any client. This path is useful for servers and remote machines.
|
|
|
|
For full setup and configuration, see:
|
|
|
|
- [Docs](https://paseo.sh/docs)
|
|
- [Configuration reference](https://paseo.sh/docs/configuration)
|
|
|
|
## CLI
|
|
|
|
Everything you can do in the app, you can do from the terminal.
|
|
|
|
```bash
|
|
paseo run --provider claude/opus-4.6 "implement user authentication"
|
|
paseo run --provider codex/gpt-5.4 --worktree feature-x "implement feature X"
|
|
|
|
paseo ls # list running agents
|
|
paseo attach abc123 # stream live output
|
|
paseo send abc123 "also add tests" # follow-up task
|
|
|
|
# run on a remote daemon
|
|
paseo --host workstation.local:6767 run "run the full test suite"
|
|
```
|
|
|
|
See the [full CLI reference](https://paseo.sh/docs/cli) for more.
|
|
|
|
## Orchestration skills (Unstable)
|
|
|
|
Experimental skills that teach agents how to use the Paseo CLI to orchestrate other agents. I am updating these very frequently as I learn new things, expect changes without notice, might be coupled to my own setup, use at your own risk.
|
|
|
|
```bash
|
|
npx skills add getpaseo/paseo
|
|
```
|
|
|
|
Then use them in any agent conversation:
|
|
|
|
```bash
|
|
# Use handoff when you discuss something with an agent but want another one to implement.
|
|
# I use this to plan with Claude and then handoff to Codex to implement.
|
|
/paseo-handoff hand off the authentication fix to codex 5.4 in a worktree
|
|
|
|
# Use loops when you have clear acceptance criteria (aka Ralph loops).
|
|
/paseo-loop loop a codex agent to fix the backend tests, use sonnet to verify, max 10 iterations
|
|
|
|
# Orchestrator teaches the agent how to create teams and manage them via a chat room.
|
|
# Very opinionated and expects both Codex and Claude to work.
|
|
/paseo-orchestrator spin up a team to implement the database refactor, use chat to coordinate. use claude to plan and codex to implement and review
|
|
```
|
|
|
|
## 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:
|
|
|
|
```bash
|
|
# run all local dev services
|
|
npm run dev
|
|
|
|
# run individual surfaces
|
|
npm run dev:server
|
|
npm run dev:app
|
|
npm run dev:desktop
|
|
npm run dev:website
|
|
|
|
# build the daemon
|
|
npm run build:daemon
|
|
|
|
# repo-wide checks
|
|
npm run typecheck
|
|
```
|
|
|
|
## License
|
|
|
|
AGPL-3.0
|