Paseo

Manage coding agents from your phone and desktop.

Warning

Early development — Features may break or change without notice. Use at your own risk.

Paseo is a self-hosted daemon for Claude Code, Codex, and OpenCode. Agents run on your machine with your full dev environment. Connect from phone, desktop, or web.

Features

Self-hosted: The daemon runs on your laptop, home server, or VPS
Multi-provider: Works with Claude Code, Codex, and OpenCode from one interface
Multi-host: Connect to multiple daemons and see all your agents in one place
Voice input: Dictate prompts when you're away from your keyboard
Optional relay: Use the hosted end-to-end encrypted relay, or connect directly
Cross-device: iOS, Android, desktop, web, and CLI
Git integration: Manage agents in isolated worktrees, review diffs, ship from the app
Open source: Free and open source under MIT license

Quick Start

npm install -g @getpaseo/cli && paseo

Then open the app and connect to your daemon.

Local speech (STT/TTS)

Paseo can run dictation + voice mode STT/TTS fully locally via sherpa-onnx.

When the daemon starts with a local speech provider selected, it will download any missing model files automatically (unless PASEO_SHERPA_ONNX_AUTO_DOWNLOAD=0).

npm run speech:download --workspace=@getpaseo/server

Optional configuration:

PASEO_SHERPA_ONNX_MODELS_DIR (defaults to ~/.paseo/models/sherpa-onnx)
PASEO_SHERPA_ONNX_AUTO_DOWNLOAD (1 by default; set 0 to disable automatic downloads on daemon start)
PASEO_SHERPA_STT_PRESET (zipformer, paraformer, or parakeet for NVIDIA Parakeet TDT v3)
PASEO_SHERPA_TTS_PRESET (pocket-tts (Kyutai Pocket TTS), kitten, or kokoro)
PASEO_DICTATION_STT_PROVIDER, PASEO_VOICE_STT_PROVIDER, PASEO_VOICE_TTS_PROVIDER (sherpa or openai)

To see all supported local model IDs:

npm run speech:models --workspace=@getpaseo/server

Optional: run an end-to-end test that downloads real models and exercises streaming STT + streaming TTS:

PASEO_SPEECH_E2E_DOWNLOAD=1 PASEO_SPEECH_E2E_MODEL_SET=parakeet-pocket \
  npx vitest run --workspace=@getpaseo/server src/server/speech/sherpa/speech-download.e2e.test.ts

Documentation

See paseo.sh/docs for full documentation.

Releases

Desktop app binaries are built and attached to a GitHub Release when you push a version tag (for example v0.1.0 or desktop-v0.1.0).

npm run version:all:patch
npm run release:push

For the full package release flow, use:

npm run release:patch

npm run release:patch bumps all workspace versions together, publishes npm packages (@getpaseo/relay, @getpaseo/server, @getpaseo/cli), and pushes the matching v* tag.

The tag triggers:

GitHub Desktop Release workflow (.github/workflows/desktop-release.yml)
Expo EAS mobile workflow (packages/app/.eas/workflows/release-mobile.yml) to build + submit Android/iOS

Useful monitoring commands after a release push:

# Desktop (GitHub Actions)
gh run list --workflow "Desktop Release" --limit 10
gh run watch <run-id>

# Mobile (EAS Workflows)
cd packages/app && npx eas workflow:runs --workflow release-mobile.yml --limit 10
cd packages/app && npx eas workflow:view <run-id>

License

MIT

3.6 KiB Raw Permalink Blame History