# Paseo

Open-source desktop interface and self-hosted daemon for coding agents, with worktrees, terminals, diffs and cross-device clients.

> This is the Markdown version of the Paseo page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/paseo>

- **Latest version**: `0.17.1`
- **Developer**: Mohamed Boudra / Paseo Project
- **Homepage**: <https://paseo.sh/>
- **Categories**: [Developer Tools](https://opennavo.com/categories/developer-tools)
- **Install**: `brew install --cask paseo`
- **30-day installs**: 2,057
- **Homebrew**: Available; the app updates itself
- **Download URL**: <https://github.com/getpaseo/paseo/releases/download/v0.17.1/Paseo-0.17.1-arm64.dmg>
- **SHA-256**: `c7dbbf6b566ac78faed2c57c34bd3bc5419909d4b8b18333750c41f304a154bb`
- **Commands**: paseo

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "uninstall": [
        {
          "launchctl": "sh.paseo.desktop.ShipIt",
          "quit": "sh.paseo.desktop",
          "script": {
            "args": [
              "daemon",
              "stop",
              "--force"
            ],
            "executable": "$APPDIR/Paseo.app/Contents/Resources/bin/paseo",
            "must_succeed": false
          }
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "app": [
        "Paseo.app"
      ],
      "target": "/Applications/Paseo.app"
    },
    "phase": "install",
    "sources": [
      "Paseo.app"
    ],
    "target": "/Applications/Paseo.app",
    "type": "app"
  },
  {
    "declaration": {
      "binary": [
        "$APPDIR/Paseo.app/Contents/Resources/bin/paseo"
      ],
      "target": "$HOMEBREW_PREFIX/bin/paseo"
    },
    "phase": "install",
    "sources": [
      "$APPDIR/Paseo.app/Contents/Resources/bin/paseo"
    ],
    "target": "$HOMEBREW_PREFIX/bin/paseo",
    "type": "binary"
  },
  {
    "declaration": {
      "zap": [
        {
          "rmdir": "~/.paseo",
          "trash": [
            "~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments/sh.paseo.desktop.sfl*",
            "~/Library/Application Support/Paseo",
            "~/Library/Caches/@getpaseodesktop-updater",
            "~/Library/Caches/sh.paseo.desktop",
            "~/Library/Caches/sh.paseo.desktop.ShipIt",
            "~/Library/HTTPStorages/sh.paseo.desktop",
            "~/Library/Logs/Paseo",
            "~/Library/Preferences/ByHost/sh.paseo.desktop.ShipIt.*.plist",
            "~/Library/Preferences/sh.paseo.desktop.plist"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

Paseo is a free, open-source interface for coding agents, developed by Mohamed Boudra and the Paseo project. It combines agent conversations, an editor, terminals, diffs and pull-request workflows, with desktop, mobile, web and CLI clients connecting to a self-hosted daemon.

### Development workflows
Run multiple agents in separate Git worktrees, review their changes and use your existing development tools. Supported provider integrations include Claude Code, Codex, GitHub Copilot, OpenCode, Pi, Antigravity and Muse Code. Provider capabilities and approval controls differ; Paseo is an orchestration interface rather than an included model subscription.

Agents execute on the daemon machine using its files, credentials, configuration and development environment. A connected client can monitor and direct that work. Worktrees help separate changes but are not a security sandbox. Review diffs, commands and tests before accepting changes. Plugins can extend the interface, agent lifecycle and providers; they run with access to the daemon machine and connected clients, so install trusted code.

### Mac installation and dependencies
The current 0.11.1 Apple Silicon DMG is 185,842,596 bytes before installed storage. The Mac cask requires macOS 13 Ventura or later and offers separate ARM64 and Intel x64 packages. Copy Paseo.app to Applications and open it; the desktop app starts its daemon automatically and includes the Paseo CLI. The catalog declares no additional cask dependency or conflict, but useful agent work requires at least one supported agent CLI installed and authenticated separately.

The standalone npm daemon route is intended for a server, VM or computer without the desktop app and has its own runtime setup. Do not assume the Mac desktop installer supplies every provider, compiler, package manager or project dependency. Desktop, Linux and Windows distributions and native iOS/Android clients are separate downloads.

### Remote connections and permissions
Pair a device from the host settings or connect to an existing daemon. The optional relay is disabled until enabled and provides end-to-end encrypted client-to-daemon traffic. SSH connections require a working key-based OpenSSH connection and an already-running remote daemon; the transport does not install or start the remote service. Direct or Tailscale connections require reachable network addresses and appropriate daemon authentication.

Keep pairing links and host credentials private and verify a host before accepting a pairing confirmation. Permissions requested by a coding agent remain meaningful: commands can modify files, run processes or contact services with the daemon user's privileges. Antigravity integration is documented as using its installed CLI in Full access, so approval modes are not interchangeable across providers. The daemon needs access to the selected project, and remote paths refer to the remote machine rather than the client's filesystem.

### Voice and data processing
Dictation and voice mode require microphone access. Local speech uses downloaded ONNX models on CPU by default, with Parakeet speech recognition and Kokoro speech synthesis. The default local Parakeet v2 model is English-only; v3 supports 25 documented European languages with automatic detection. Model downloads add storage and initially require network access.

Optional OpenAI speech providers send audio or speech text to the configured service and require credentials. Voice reasoning uses an installed, authenticated coding-agent provider even when speech recognition is local. Likewise, a coding provider may send project content to its cloud service. The project's no-telemetry and no-forced-login claim for Paseo itself does not make all provider or plugin activity offline or private.

### License, accounts and cost
Paseo is Apache License 2.0 software, with third-party components retaining their own licenses. The core self-hosted application does not require a Paseo account or paid subscription; optional sponsorship supports development. Agent-provider subscriptions, API usage, optional cloud speech and third-party services have separate accounts, prices and terms. Choose a provider and permissions suitable for the repository and information being processed.

Official sources: [Paseo](https://paseo.sh/), [Version 0.11.1 documentation](https://github.com/getpaseo/paseo/blob/v0.11.1/README.md), [Connectivity](https://paseo.sh/docs/connectivity), [Voice](https://paseo.sh/docs/voice), [License](https://github.com/getpaseo/paseo/blob/v0.11.1/LICENSE), [Releases](https://github.com/getpaseo/paseo/releases).

## System requirements

- macOS 13 or later · Version: 0.17.1 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/p/paseo.rb> · Checked 2026-11-22
  - <https://github.com/getpaseo/paseo/releases/download/v0.17.1/Paseo-0.17.1-x64.dmg>
  - SHA-256: `ee5e1f4a44a6086e7779c006e3c94126974f540bc178b149757b91c287e8dec6`
- macOS 13 or later · Version: 0.17.1 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/p/paseo.rb> · Checked 2026-11-22
  - <https://github.com/getpaseo/paseo/releases/download/v0.17.1/Paseo-0.17.1-arm64.dmg>
  - SHA-256: `c7dbbf6b566ac78faed2c57c34bd3bc5419909d4b8b18333750c41f304a154bb`

## Paseo security facts

Only facts that can be checked, each with its source and date. This is not a safety certification. To check the files you downloaded, scan them on your Mac with OpenNavo.

- <https://github.com/getpaseo/paseo> · Open source: Yes — <https://github.com/getpaseo/paseo> · Checked 2026-11-13

## Uninstall

- `brew uninstall --cask paseo`

A regular uninstall removes the app and keeps its settings and caches.

### Uninstalling also removes

- Background services (launchctl): `sh.paseo.desktop.ShipIt` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/p/paseo.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

### Deep clean (optional)

- `brew uninstall --zap --cask paseo`

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments/sh.paseo.desktop.sfl*` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/p/paseo.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Application Support/Paseo` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/p/paseo.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Caches/@getpaseodesktop-updater` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/p/paseo.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Caches/sh.paseo.desktop` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/p/paseo.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Caches/sh.paseo.desktop.ShipIt` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/p/paseo.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/HTTPStorages/sh.paseo.desktop` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/p/paseo.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Logs/Paseo` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/p/paseo.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/ByHost/sh.paseo.desktop.ShipIt.*.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/p/paseo.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/sh.paseo.desktop.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/p/paseo.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/.paseo` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/p/paseo.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

## Latest release notes

### 0.17.1 (2026-11-21)

Paseo 0.17.1 lets people running coding agents start a workspace in an existing worktree, update provider CLIs in the app, and see when a quota will run out.

**New**

- Starts a workspace in a worktree you already have.
- Updates supported provider CLIs from inside the app.
- Shows when your pace will use up a quota before reset.
- Lets an agent watch a pull or merge request for updates.

## Facts and sources

- <https://opennavo.com/apps/paseo>
- <https://opennavo.com/apps/paseo/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/p/paseo.rb> · Checked 2026-11-22
- <https://formulae.brew.sh/cask/paseo>
- <https://github.com/getpaseo/paseo> · Checked 2026-11-13
