79 lines
2.3 KiB
Markdown
79 lines
2.3 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">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.
|
|
|
|
## Getting Started
|
|
|
|
### Desktop app
|
|
|
|
Download from [paseo.sh/download](https://paseo.sh/download) or the [GitHub releases page](https://github.com/getpaseo/paseo/releases). The app bundles its own daemon, so there's nothing else to install. It can also connect to daemons running on other machines.
|
|
|
|
### Headless / server mode
|
|
|
|
Run the daemon on any machine:
|
|
|
|
```bash
|
|
npm install -g @getpaseo/cli
|
|
paseo
|
|
```
|
|
|
|
Then connect from any client — desktop, web, mobile, or CLI. See [paseo.sh/download](https://paseo.sh/download) for all options.
|
|
|
|
For full setup and configuration, see:
|
|
- [Docs](https://paseo.sh/docs)
|
|
- [Configuration reference](https://paseo.sh/docs/configuration)
|
|
|
|
## 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
|