mirror of
https://github.com/getpaseo/paseo.git
synced 2026-07-29 12:01:31 +00:00
214f85a1508124a0f4bb8b27f58496b67bf88ab0
Add Drizzle schema for all four tables (projects, workspaces, agent_snapshots, agent_timeline_rows), PGlite bootstrap lifecycle, migration harness, and real contract tests proving query shapes work. No runtime authority changes — Session, AgentManager, and existing storage call sites are untouched. CLI cleanup removes stale projection fields from two fetchAgentTimeline call sites. Audit-verified: correctness (all acceptance criteria met), boundary (no runtime files touched), complexity (minor flags resolved).
Paseo
One interface for all your coding agents.
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:paseoCLI for daemon and agent workflowspackages/desktop: Electron desktop apppackages/relay: Relay package for remote connectivitypackages/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%
