chore(release): cut 0.1.6

What changed:
- Added private  helper in  to centralize request-id resolution, schema parsing, and correlated RPC dispatch defaults.
- Migrated checkout/worktree/branch/file-explorer/provider/speech/command request methods to use the helper while preserving existing message types and per-method timeouts.
- Added a deterministic unit test covering  request/response wiring.

Reasoning:
- The prior implementation duplicated the same correlated-RPC boilerplate across many methods, increasing maintenance cost and risk of drift.
- Centralizing this path reduces logic density and keeps transport behavior consistent.
- Additional test coverage protects one of the checkout RPC flows touched by the refactor.

Accomplishments for next agent:
- Reduced repetitive correlated RPC scaffolding in  without changing external behavior.
- Verified with workspace typecheck and daemon-client test suite.

Challenges / follow-ups for next agent:
-  remains very large; this commit intentionally scoped to request plumbing only.
- Next high-value split is extracting cohesive domains (for example checkout/worktree flows) behind focused modules while keeping wire contracts unchanged.

.github/workflows/deploy-app.yml

@@ -0,0 +1,38 @@
+name: Deploy App
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'packages/app/**'
+      - 'packages/server/src/**'
+      - '.github/workflows/deploy-app.yml'
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+          registry-url: 'https://npm.pkg.github.com'
+          scope: '@boudra'
+
+      - name: Install dependencies
+        run: npm install --workspace=@getpaseo/app --include-workspace-root
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Typecheck
+        run: npm run typecheck --workspace=@getpaseo/app
+
+      - name: Build and deploy to Cloudflare Pages
+        run: npm run deploy:web --workspace=@getpaseo/app
+        env:
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          CLOUDFLARE_ACCOUNT_ID: 10ed39a1dbf316e30abd0c409bed40d6

.github/workflows/deploy-relay.yml

@@ -0,0 +1,33 @@
+name: Deploy Relay
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'packages/relay/**'
+      - '.github/workflows/deploy-relay.yml'
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm install --workspace=@getpaseo/relay --include-workspace-root
+
+      - name: Typecheck
+        run: npm run typecheck --workspace=@getpaseo/relay
+
+      - name: Deploy worker
+        run: cd packages/relay && npx wrangler deploy
+        env:
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+

.github/workflows/deploy-website.yml

@@ -0,0 +1,35 @@
+name: Deploy Website
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'packages/website/**'
+      - 'package.json'
+      - 'package-lock.json'
+      - 'patches/**'
+      - '.github/workflows/deploy-website.yml'
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm install --workspace=@getpaseo/website --include-workspace-root
+
+      - name: Typecheck
+        run: npm run typecheck --workspace=@getpaseo/website
+
+      - name: Deploy to Cloudflare Workers
+        run: npm run deploy --workspace=@getpaseo/website
+        env:
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}

.github/workflows/desktop-release.yml

@@ -0,0 +1,113 @@
+name: Desktop Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+      - 'desktop-v*'
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: 'Existing tag to build (e.g. v0.1.0)'
+        required: true
+        type: string
+
+concurrency:
+  group: desktop-release-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  publish-tauri:
+    permissions:
+      contents: write
+      packages: read
+    runs-on: macos-latest
+    env:
+      RELEASE_TAG: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.tag || github.ref_name }}
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          ref: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.tag || github.ref }}
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+          registry-url: 'https://npm.pkg.github.com'
+          scope: '@boudra'
+
+      - name: Install Rust stable
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: aarch64-apple-darwin
+
+      - name: Install JS dependencies
+        run: npm ci
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build web app for Tauri
+        run: npm run build:web --workspace=@getpaseo/app
+
+      - name: Set desktop version from tag
+        shell: bash
+        run: |
+          node <<'NODE'
+          const fs = require('node:fs');
+          const path = require('node:path');
+
+          const rawTag = process.env.RELEASE_TAG;
+          if (!rawTag) throw new Error('RELEASE_TAG env var is missing');
+
+          const version = rawTag.replace(/^desktop-/, '').replace(/^v/, '');
+          console.log(`Using desktop version ${version} from tag ${rawTag}`);
+
+          const tauriConfPath = path.join('packages', 'desktop', 'src-tauri', 'tauri.conf.json');
+          const tauriConfText = fs.readFileSync(tauriConfPath, 'utf8');
+          const tauriRe = /("version"\s*:\s*")([^"]+)(")/;
+          if (!tauriRe.test(tauriConfText)) {
+            throw new Error(`Failed to find version field in ${tauriConfPath}`);
+          }
+          fs.writeFileSync(tauriConfPath, tauriConfText.replace(tauriRe, `$1${version}$3`));
+
+          const cargoTomlPath = path.join('packages', 'desktop', 'src-tauri', 'Cargo.toml');
+          const cargoLines = fs.readFileSync(cargoTomlPath, 'utf8').split(/\r?\n/);
+          let inPackage = false;
+          let updated = false;
+          const nextLines = cargoLines.map((line) => {
+            if (/^\[package\]\s*$/.test(line)) inPackage = true;
+            else if (inPackage && /^\[/.test(line)) inPackage = false;
+
+            if (inPackage && /^version\s*=\s*".*"\s*$/.test(line)) {
+              updated = true;
+              return `version = "${version}"`;
+            }
+            return line;
+          });
+          if (!updated) throw new Error(`Failed to update Cargo package version in ${cargoTomlPath}`);
+          fs.writeFileSync(cargoTomlPath, `${nextLines.join('\n')}\n`);
+          NODE
+
+      - name: Build and publish Tauri release
+        uses: tauri-apps/tauri-action@v0
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          APPLE_CERTIFICATE: ${{ secrets.APPLE_CERTIFICATE }}
+          APPLE_CERTIFICATE_PASSWORD: ${{ secrets.APPLE_CERTIFICATE_PASSWORD }}
+          APPLE_SIGNING_IDENTITY: ${{ secrets.APPLE_SIGNING_IDENTITY }}
+          APPLE_ID: ${{ secrets.APPLE_ID }}
+          APPLE_PASSWORD: ${{ secrets.APPLE_PASSWORD }}
+          APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
+          TAURI_SIGNING_PRIVATE_KEY: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY }}
+          TAURI_SIGNING_PRIVATE_KEY_PASSWORD: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }}
+        with:
+          projectPath: packages/desktop
+          tagName: ${{ env.RELEASE_TAG }}
+          releaseName: Paseo Desktop ${{ env.RELEASE_TAG }}
+          releaseBody: See the assets to download and install this version.
+          releaseDraft: false
+          prerelease: false
+          args: --target aarch64-apple-darwin

.github/workflows/server-ci.yml

@@ -0,0 +1,43 @@
+name: Server CI
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'packages/server/**'
+      - 'package.json'
+      - 'package-lock.json'
+      - '.github/workflows/server-ci.yml'
+  pull_request:
+    branches: [main]
+    paths:
+      - 'packages/server/**'
+      - 'package.json'
+      - 'package-lock.json'
+      - '.github/workflows/server-ci.yml'
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Fetch origin/main (worktree tests)
+        run: git fetch --no-tags origin main:refs/remotes/origin/main
+
+      - name: Install server dependencies
+        run: npm install --workspace=@getpaseo/server --include-workspace-root
+
+      - name: Typecheck
+        run: npm run typecheck --workspace=@getpaseo/server
+
+      - name: Test
+        run: npm run test --workspace=@getpaseo/server

.gitignore

@@ -0,0 +1,76 @@
+# Dependencies
+node_modules/
+
+# Build outputs
+build/
+dist/
+.next/
+out/
+
+# Environment variables
+.env
+.env.test
+.env.local
+.env.test.local
+.env*.local
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# OS files
+.DS_Store
+*.swp
+*.swo
+*~
+
+# TypeScript
+*.tsbuildinfo
+tsconfig.tsbuildinfo
+
+# IDEs
+.vscode/
+.idea/
+*.sublime-*
+
+# Testing
+coverage/
+
+# Playwright
+test-results/
+**/test-results/
+
+# Vercel
+.vercel/
+
+# Misc
+*.pem
+.vercel
+
+# Local Claude configuration
+CLAUDE.local.md
+
+# Task CLI
+.tasks/
+
+.debug.conversations/
+.debug/
+.paseo/
+.wrangler/
+**/.wrangler/
+
+# Local agent/tooling artifacts (do not commit)
+PLAN.md
+.valknut/
+valknut-report.html/
+valknut-report.json/
+**/.playwright-mcp/
+**/.paseo-provider-history/
+.claude/settings.local.json
+**/.claude/settings.local.json
+.plans/
+packages/server/src/server/fixtures/dictation/dictation-debug-largest.wav
+packages/server/src/server/fixtures/dictation/dictation-debug-largest.transcript.txt

.prettierignore

@@ -0,0 +1,21 @@
+# Dependencies
+node_modules
+
+# Build outputs
+dist
+.next
+.expo
+build
+*.tsbuildinfo
+
+# Coverage
+coverage
+
+# Lock files
+*.lock
+package-lock.json
+
+# Generated
+android
+ios
+.turbo

.prettierrc

@@ -0,0 +1,7 @@
+{
+  "semi": false,
+  "singleQuote": true,
+  "trailingComma": "es5",
+  "tabWidth": 2,
+  "printWidth": 100
+}

.tool-versions

@@ -0,0 +1,2 @@
+rust 1.85.1
+nodejs 22.20.0

AGENTS.md

@@ -0,0 +1 @@
+CLAUDE.md

CLAUDE.md

@@ -0,0 +1,220 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Paseo is a mobile app for monitoring and controlling your local AI coding agents from anywhere. Your dev environment, in your pocket.
+
+**Key features:**
+- Real-time streaming of agent output
+- Voice commands for hands-free interaction
+- Push notifications when tasks complete
+- Multi-agent orchestration across projects
+
+**Not a cloud sandbox** - Paseo connects directly to your actual development environment. Your code stays on your machine.
+
+**Supported agents:** Claude Code, Codex, and OpenCode.
+
+## Monorepo Structure
+
+This is an npm workspace monorepo:
+
+- **packages/server**: The Paseo daemon that runs on your machine. Manages agent processes, provides WebSocket API for real-time streaming, and exposes an MCP server for agent control.
+- **packages/app**: Cross-platform client (Expo). Connects to one or more servers, displays agent output, handles voice input, and sends push notifications.
+- **packages/cli**: The `paseo` CLI that is used to manage the deamon, and acts as a client to it with  Docker-style commands like `paseo run/ls/logs/wait`
+- **packages/website**: Marketing site at paseo.sh (TanStack Router + Cloudflare Workers).
+
+## Development Server
+
+The `npm run dev` script automatically picks an available port for the development server.
+
+When running in a worktree or alongside the main checkout, set `PASEO_HOME` to isolate state:
+
+```bash
+PASEO_HOME=~/.paseo-blue npm run dev
+```
+
+- `PASEO_HOME` – path for runtime state (agent data, sockets, etc.). Defaults to `~/.paseo`; set this to a unique directory when running a secondary server instance.
+
+## Running and checking logs
+
+Both the server and Expo app are running in a Tmux session. See CLAUDE.local.md for system-specific session details.
+
+## Debugging
+
+### Daemon and CLI
+
+The Paseo daemon communicates via WebSocket. In the main checkout:
+- Daemon runs at `localhost:6767`
+- Expo app at `localhost:8081`
+- State lives in `$PASEO_HOME`
+
+In worktrees or when running `npm run dev`, ports and home directories may differ. Never assume the defaults.
+
+Use `npm run cli` to run the local CLI (instead of the globally linked `paseo` which points to the main checkout). Always run `npm run cli -- --help` or load the `/paseo` skill before using it - do not guess commands.
+
+Use `--host <host:port>` to point the CLI at a different daemon (e.g., `--host localhost:7777`).
+
+### Quick reference CLI commands
+
+```bash
+npm run cli -- ls -a -g              # List all agents globally
+npm run cli -- ls -a -g --json       # Same, as JSON
+npm run cli -- inspect <id>          # Show detailed agent info
+npm run cli -- logs <id>             # View agent timeline
+npm run cli -- daemon status         # Check daemon status
+```
+
+### Agent state
+
+Agent data is stored at:
+```
+$PASEO_HOME/agents/{cwd-with-dashes}/{agent-id}.json
+```
+
+To find an agent by ID:
+```bash
+find $PASEO_HOME/agents -name "{agent-id}.json"
+```
+
+To find an agent by title or other content:
+```bash
+rg -l "some title text" $PASEO_HOME/agents/
+rg -l "spiteful-toad" $PASEO_HOME/agents/
+```
+
+### Provider session files
+
+Get the session ID from the agent JSON file (`persistence.sessionId`), then:
+
+**Claude sessions:**
+```
+~/.claude/projects/{cwd-with-dashes}/{session-id}.jsonl
+```
+
+**Codex sessions:**
+```
+~/.codex/sessions/{YYYY}/{MM}/{DD}/rollout-{timestamp}-{session-id}.jsonl
+```
+
+## Android
+
+Take screenshots like this: `adb exec-out screencap -p > screenshot.png`
+
+### Android variants (vanilla Expo)
+
+Use `APP_VARIANT` in `packages/app/app.config.js` to control app name + package ID (no custom Gradle flavor plugin):
+
+- `production` -> app name `Paseo`, package `sh.paseo`
+- `development` -> app name `Paseo Debug`, package `sh.paseo.debug`
+
+EAS profiles live in `packages/app/eas.json` as `development`, `production`, and `production-apk`.
+
+`development` uses Android `debug`.
+
+### Local build + install (Android device)
+
+From `packages/app`:
+
+```bash
+# development (debug)
+APP_VARIANT=development npx expo prebuild --platform android --clean --non-interactive
+APP_VARIANT=development npx expo run:android --variant=debug
+
+# production (release)
+APP_VARIANT=production npx expo prebuild --platform android --clean --non-interactive
+APP_VARIANT=production npx expo run:android --variant=release
+```
+
+From repo root:
+
+```bash
+npm run android:development
+npm run android:production
+```
+
+`npm run android:prod` and `npm run android:release` are aliases for `npm run android:production`.
+
+### Cloud build + submit (EAS Workflows)
+
+Tag pushes like `v0.1.0` trigger `packages/app/.eas/workflows/release-mobile.yml` on Expo servers.
+
+That workflow does:
+- Build iOS with the `production` profile
+- Build Android with the `production` profile
+- Submit each build with the `production` submit profile
+
+Useful commands:
+
+```bash
+# List recent mobile workflow runs
+cd packages/app && npx eas workflow:runs --workflow release-mobile.yml --limit 10
+
+# Inspect one run (jobs, status, outputs)
+cd packages/app && npx eas workflow:view <run-id>
+
+# Stream logs for all steps in one failed job
+cd packages/app && npx eas workflow:logs <job-id> --non-interactive --all-steps
+```
+
+## Testing with Playwright MCP
+
+**CRITICAL:** When asked to test the app, you MUST use the Playwright MCP connecting to Metro at `http://localhost:8081`.
+
+Use the Playwright MCP to test the app in Metro web. Navigate to `http://localhost:8081` to interact with the app UI.
+
+**Important:** Do NOT use browser history (back/forward). Always navigate by clicking UI elements or using `browser_navigate` with the full URL. The app uses client-side routing and browser history navigation breaks the state.
+
+## Expo troubleshooting
+
+Run `npx expo-doctor` to diagnose version mismatches and native module issues.
+
+## Release playbook
+
+Use the scripted release flow from repo root. Avoid manual version bumps, manual tags, or ad hoc publish commands unless debugging.
+
+```bash
+# Recommended: full patch release (bump, check, publish, push branch+tag)
+npm run release:patch
+
+# Manual, step-by-step fallback:
+npm run version:all:patch  # npm version across all workspaces (creates commit + local tag)
+npm run release:check
+npm run release:publish
+npm run release:push       # pushes HEAD and current version tag (triggers desktop + EAS mobile workflows)
+```
+
+Notes:
+- `version:all:*` bumps the root package version and runs the root `version` lifecycle script to sync workspace versions and internal `@getpaseo/*` dependency versions before the release commit/tag is created.
+- `release:prepare` refreshes workspace `node_modules` links to prevent stale local package types during release checks.
+- If `release:publish` fails after a successful publish of one workspace, re-run `npm run release:publish`; npm will skip already-published versions and continue where possible.
+- If a user asks to "release paseo" (without specifying major/minor), treat it as a patch release and run `npm run release:patch`.
+- All workspaces share one version by design. Keep versions synchronized and release together.
+- After each release, update the website Mac download CTA URL to the new version tag in `packages/website/src/routes/index.tsx`.
+
+Release completion checklist:
+- `npm run release:patch` completes successfully.
+- GitHub `Desktop Release` workflow for the new `v*` tag is green.
+- EAS `release-mobile.yml` workflow for the same tag is green (Expo queues can take longer on the free plan).
+
+## Orchestrator Mode
+
+- **When agent control tool calls fail**, make sure you list agents before trying to launch another one. It could just be a wait timeout.
+- **Always prefix agent titles** so we can tell which ones are running under you (e.g., "🎭 Feature Implementation", "🎭 Design Discussion").
+- **Launch agents in the most permissive mode**: Use full access or bypass permissions mode.
+- **Set cwd to the repository root** - The agent's working directory should usually be the repo root
+
+**CRITICAL: ALWAYS RUN TYPECHECK AFTER EVERY CHANGE.**
+
+## Agent Authentication
+
+All agent providers (Claude, Codex, OpenCode) handle their own authentication outside of environment variables. They are authenticated without providing any extra configuration—Paseo does not manage API keys or tokens for agents.
+
+**Do not add auth checks to tests.** If auth fails for whatever reason, let the user know instead of patching the code or adding conditional skips.
+
+## NEVER DO THESE THINGS
+
+- **NEVER restart the main Paseo daemon on port 6767 without permission** - This is the production daemon that launches and manages agents. If you are reading this, you are probably running as an agent under it. Restarting it will kill your own process and all other running agents. The daemon is managed by the user in Tmux.
+- **NEVER assume a timeout means the service needs restarting** - Timeouts can be transient network issues, not service failures
+- **NEVER add authentication checks to tests** - Agent providers handle their own auth. If tests fail due to auth issues, report it rather than adding conditional skips or env var checks

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Mohamed Boudra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,109 @@
+<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">Manage coding agents from your phone and desktop.</p>
+
+<p align="center">
+  <img src="https://paseo.sh/paseo-mockup.png" alt="Paseo app screenshot" width="100%">
+</p>
+
+---
+
+> [!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
+
+```bash
+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`).
+
+```bash
+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:
+
+```bash
+npm run speech:models --workspace=@getpaseo/server
+```
+
+Optional: run an end-to-end test that downloads real models and exercises streaming STT + streaming TTS:
+
+```bash
+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](https://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`).
+
+```bash
+npm run version:all:patch
+npm run release:push
+```
+
+For the full package release flow, use:
+
+```bash
+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:
+
+```bash
+# 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

SECURITY.md

@@ -0,0 +1,54 @@
+# Security
+
+Paseo follows a client-server architecture, similar to Docker. The daemon runs on your machine and manages your coding agents. Clients (the mobile app, CLI, or web interface) connect to the daemon to monitor and control those agents.
+
+Your code never leaves your machine. Paseo is a local-first tool that connects directly to your development environment.
+
+## Architecture
+
+The Paseo daemon can run anywhere you want to execute agents: your laptop, a Mac Mini, a VPS, or a Docker container. The daemon listens for connections and manages agent lifecycles.
+
+Clients connect to the daemon over WebSocket. There are two ways to establish this connection:
+
+- **Relay connection** — The daemon connects outbound to our relay server, and clients meet it there. No open ports required.
+- **Direct connection** — The daemon listens on a network address and clients connect directly.
+
+## Relay threat model
+
+The relay is designed to be untrusted. All traffic between your phone and daemon is end-to-end encrypted. The relay server cannot read your messages, see your code, or modify traffic without detection. Even if the relay is compromised, your data remains protected.
+
+### How it works
+
+1. The daemon generates a persistent ECDH keypair and stores it locally
+2. When you scan the QR code or click the pairing link, your phone receives the daemon's public key
+3. Your phone sends a handshake message with its own public key. The daemon will not accept any commands until this handshake completes.
+4. Both sides perform an ECDH key exchange to derive a shared secret. All subsequent messages are encrypted with AES-256-GCM.
+
+The relay sees only: IP addresses, timing, message sizes, and session IDs. It cannot read message contents, forge messages, or derive encryption keys from observing the handshake.
+
+### Why the relay can't attack you
+
+The daemon requires a valid cryptographic handshake before processing any commands. A compromised relay cannot:
+
+- **Send commands** — Without your phone's private key, it cannot complete the handshake
+- **Read your traffic** — All messages are encrypted with AES-256-GCM after the handshake
+- **Forge messages** — GCM provides authenticated encryption; tampered messages are rejected
+- **Replay old messages** — Each session derives fresh encryption keys
+
+### Trust model
+
+The QR code or pairing link is the trust anchor. It contains the daemon's public key, which is required to establish the encrypted connection. Treat it like a password — don't share it publicly.
+
+## DNS rebinding protection
+
+CORS is not a complete security boundary. It controls which browser origins can make requests, but does not prevent a malicious website from resolving its domain to your local machine (DNS rebinding).
+
+Paseo uses a host allowlist to validate the `Host` header on incoming requests. Requests with unrecognized hosts are rejected.
+
+## Agent authentication
+
+Paseo wraps agent CLIs (Claude Code, Codex, OpenCode) but does not manage their authentication. Each agent provider handles its own credentials. Paseo never stores or transmits provider API keys. Agents run in your user context with your existing credentials.
+
+## Reporting vulnerabilities
+
+If you discover a security vulnerability, please report it privately by emailing mo@faro.so. Do not open a public issue.

package.json

@@ -0,0 +1,74 @@
+{
+  "name": "paseo",
+  "version": "0.1.6",
+  "private": true,
+  "workspaces": [
+    "packages/server",
+    "packages/app",
+    "packages/relay",
+    "packages/website",
+    "packages/desktop",
+    "packages/cli"
+  ],
+  "scripts": {
+    "dev": "./scripts/dev.sh",
+    "dev:server": "NODE_ENV=development tsx packages/server/scripts/dev-runner.ts",
+    "dev:app": "npm run start --workspace=@getpaseo/app",
+    "dev:website": "npm run dev --workspace=@getpaseo/website",
+    "postinstall": "node scripts/postinstall-patches.mjs",
+    "build": "npm run build --workspaces --if-present",
+    "typecheck": "npm run typecheck --workspaces --if-present",
+    "test": "npm run test --workspaces --if-present",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "start": "npm run start --workspace=@getpaseo/server",
+    "android": "npm run android --workspace=@getpaseo/app",
+    "android:development": "npm run android:development --workspace=@getpaseo/app",
+    "android:prod": "npm run android:prod --workspace=@getpaseo/app",
+    "android:production": "npm run android:production --workspace=@getpaseo/app",
+    "android:release": "npm run android:prod --workspace=@getpaseo/app",
+    "ios": "npm run ios --workspace=@getpaseo/app",
+    "web": "npm run web --workspace=@getpaseo/app",
+    "dev:desktop": "npm run dev --workspace=@getpaseo/desktop",
+    "build:desktop": "npm run build --workspace=@getpaseo/desktop",
+    "cli": "npx tsx packages/cli/src/index.js",
+    "version": "npm run version:sync-internal && npm run release:prepare && git add -A",
+    "version:sync-internal": "node scripts/sync-workspace-versions.mjs",
+    "release:prepare": "npm install --workspaces --include-workspace-root",
+    "version:all:patch": "npm version patch --include-workspace-root --message \"chore(release): cut %s\"",
+    "version:all:minor": "npm version minor --include-workspace-root --message \"chore(release): cut %s\"",
+    "version:all:major": "npm version major --include-workspace-root --message \"chore(release): cut %s\"",
+    "release:check": "npm run release:prepare && npm run typecheck --workspace=@getpaseo/relay && npm run typecheck --workspace=@getpaseo/server && npm run typecheck --workspace=@getpaseo/cli && npm run build --workspace=@getpaseo/relay && npm run build --workspace=@getpaseo/server && npm run build --workspace=@getpaseo/cli && npm pack --dry-run --workspace=@getpaseo/relay && npm pack --dry-run --workspace=@getpaseo/server && npm pack --dry-run --workspace=@getpaseo/cli",
+    "release:publish:dry-run": "npm publish --dry-run --workspace=@getpaseo/relay --access public && npm publish --dry-run --workspace=@getpaseo/server --access public && npm publish --dry-run --workspace=@getpaseo/cli --access public",
+    "release:publish": "npm publish --workspace=@getpaseo/relay --access public && npm publish --workspace=@getpaseo/server --access public && npm publish --workspace=@getpaseo/cli --access public",
+    "release:push": "node scripts/push-current-release-tag.mjs",
+    "release:patch": "npm run version:all:patch && npm run release:check && npm run release:publish && npm run release:push",
+    "release:minor": "npm run version:all:minor && npm run release:check && npm run release:publish && npm run release:push",
+    "release:major": "npm run version:all:major && npm run release:check && npm run release:publish && npm run release:push"
+  },
+  "devDependencies": {
+    "concurrently": "^9.2.1",
+    "prettier": "^3.5.3",
+    "get-port-cli": "^3.0.0",
+    "knip": "^5.82.1",
+    "patch-package": "^8.0.1",
+    "typescript": "^5.9.3"
+  },
+  "description": "Paseo: voice-controlled development environment with OpenAI Realtime API",
+  "keywords": [
+    "openai",
+    "realtime",
+    "voice",
+    "voice-assistant",
+    "development",
+    "mcp"
+  ],
+  "author": "moboudra",
+  "license": "MIT",
+  "overrides": {
+    "lightningcss": "1.30.1"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.11"
+  }
+}

packages/app/.eas/workflows/release-mobile.yml

@@ -0,0 +1,38 @@
+name: Release Mobile
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch: {}
+
+jobs:
+  build_ios:
+    name: Build iOS
+    type: build
+    params:
+      platform: ios
+      profile: production
+
+  build_android:
+    name: Build Android
+    type: build
+    params:
+      platform: android
+      profile: production
+
+  submit_ios:
+    name: Submit iOS
+    needs: [build_ios]
+    type: submit
+    params:
+      build_id: ${{ needs.build_ios.outputs.build_id }}
+      profile: production
+
+  submit_android:
+    name: Submit Android
+    needs: [build_android]
+    type: submit
+    params:
+      build_id: ${{ needs.build_android.outputs.build_id }}
+      profile: production

packages/app/.gitignore

@@ -0,0 +1,44 @@
+# Learn more https://docs.github.com/en/get-started/getting-started-with-git/ignoring-files
+
+# dependencies
+node_modules/
+
+# Expo
+.expo/
+dist/
+web-build/
+expo-env.d.ts
+
+# Native
+.kotlin/
+*.orig.*
+*.jks
+*.p8
+*.p12
+*.key
+*.mobileprovision
+
+# Metro
+.metro-health-check*
+
+# debug
+npm-debug.*
+yarn-debug.*
+yarn-error.*
+
+# macOS
+.DS_Store
+*.pem
+
+# local env files
+.env*.local
+.secrets/
+
+# typescript
+*.tsbuildinfo
+
+app-example
+
+# generated native folders
+/ios
+/android

packages/app/README.md

@@ -0,0 +1,54 @@
+# Welcome to your Expo app 👋
+
+This is an [Expo](https://expo.dev) project created with [`create-expo-app`](https://www.npmjs.com/package/create-expo-app).
+
+## Get started
+
+1. Install dependencies
+
+   ```bash
+   npm install
+   ```
+
+2. Start the app
+
+   ```bash
+   npx expo start
+   ```
+
+In the output, you'll find options to open the app in a
+
+- [development build](https://docs.expo.dev/develop/development-builds/introduction/)
+- [Android emulator](https://docs.expo.dev/workflow/android-studio-emulator/)
+- [iOS simulator](https://docs.expo.dev/workflow/ios-simulator/)
+- [Expo Go](https://expo.dev/go), a limited sandbox for trying out app development with Expo
+
+You can start developing by editing the files inside the **app** directory. This project uses [file-based routing](https://docs.expo.dev/router/introduction).
+
+## Get a fresh project
+
+When you're ready, run:
+
+```bash
+npm run reset-project
+```
+
+This command will move the starter code to the **app-example** directory and create a blank **app** directory where you can start developing.
+
+## Learn more
+
+To learn more about developing your project with Expo, look at the following resources:
+
+- [Expo documentation](https://docs.expo.dev/): Learn fundamentals, or go into advanced topics with our [guides](https://docs.expo.dev/guides).
+- [Learn Expo tutorial](https://docs.expo.dev/tutorial/introduction/): Follow a step-by-step tutorial where you'll create a project that runs on Android, iOS, and the web.
+
+## Join the community
+
+Join our community of developers creating universal apps.
+
+- [Expo on GitHub](https://github.com/expo/expo): View our open source platform and contribute.
+- [Discord community](https://chat.expo.dev): Chat with Expo users and ask questions.
+
+## Dictation debugging
+
+Set `EXPO_PUBLIC_ENABLE_AUDIO_DEBUG=1` before running `npx expo start` to render the in-app audio debug card. Pair it with the server-side `STT_DEBUG_AUDIO_DIR` flag so every dictation includes a copyable path to the saved raw audio file.

packages/app/app.config.js

@@ -0,0 +1,117 @@
+const pkg = require("./package.json");
+const appVariant = process.env.APP_VARIANT ?? "production";
+
+const variants = {
+  production: {
+    name: "Paseo",
+    packageId: "sh.paseo",
+  },
+  development: {
+    name: "Paseo Debug",
+    packageId: "sh.paseo.debug",
+  },
+};
+
+const variant = variants[appVariant] ?? variants.production;
+
+export default {
+  expo: {
+    name: variant.name,
+    slug: "voice-mobile",
+    version: pkg.version,
+    orientation: "portrait",
+    icon: "./assets/images/icon.png",
+    scheme: "paseo",
+    userInterfaceStyle: "automatic",
+    newArchEnabled: true,
+    runtimeVersion: {
+      policy: "appVersion",
+    },
+    updates: {
+      url: "https://u.expo.dev/0e7f65ce-0367-46c8-a238-2b65963d235a",
+    },
+    ios: {
+      supportsTablet: true,
+      infoPlist: {
+        NSMicrophoneUsageDescription:
+          "This app needs access to the microphone for voice commands.",
+        ITSAppUsesNonExemptEncryption: false,
+      },
+      bundleIdentifier: variant.packageId,
+    },
+    android: {
+      adaptiveIcon: {
+        backgroundColor: "#000000",
+        foregroundImage: "./assets/images/android-icon-foreground.png",
+      },
+      edgeToEdgeEnabled: true,
+      predictiveBackGestureEnabled: false,
+      softwareKeyboardLayoutMode: "resize",
+      // Allow HTTP connections for local network hosts (required for release builds)
+      usesCleartextTraffic: true,
+      permissions: [
+        "RECORD_AUDIO",
+        "android.permission.RECORD_AUDIO",
+        "android.permission.MODIFY_AUDIO_SETTINGS",
+        "CAMERA",
+        "android.permission.CAMERA",
+      ],
+      package: variant.packageId,
+    },
+    web: {
+      output: "single",
+      favicon: "./assets/images/favicon.png",
+    },
+    plugins: [
+      "expo-router",
+      [
+        "expo-camera",
+        {
+          cameraPermission: "Allow $(PRODUCT_NAME) to access your camera to scan pairing QR codes.",
+        },
+      ],
+      [
+        "expo-splash-screen",
+        {
+          image: "./assets/images/splash-icon.png",
+          imageWidth: 200,
+          resizeMode: "contain",
+          backgroundColor: "#ffffff",
+          dark: {
+            backgroundColor: "#000000",
+          },
+        },
+      ],
+      [
+        "expo-notifications",
+        {
+          icon: "./assets/images/notification-icon.png",
+          color: "#20744A",
+        },
+      ],
+      "expo-audio",
+      [
+        "expo-build-properties",
+        {
+          android: {
+            minSdkVersion: 29,
+            kotlinVersion: "2.1.20",
+            // Allow HTTP connections for local network hosts in release builds
+            usesCleartextTraffic: true,
+          },
+        },
+      ],
+    ],
+    experiments: {
+      typedRoutes: true,
+      reactCompiler: true,
+    },
+    extra: {
+      router: {},
+      eas: {
+        projectId: "0e7f65ce-0367-46c8-a238-2b65963d235a",
+      },
+    },
+    owner: "getpaseo",
+  },
+};

packages/app/assets/icons/claude.svg

@@ -0,0 +1 @@
+<svg fill="currentColor" fill-rule="evenodd" height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Claude</title><path d="M4.709 15.955l4.72-2.647.08-.23-.08-.128H9.2l-.79-.048-2.698-.073-2.339-.097-2.266-.122-.571-.121L0 11.784l.055-.352.48-.321.686.06 1.52.103 2.278.158 1.652.097 2.449.255h.389l.055-.157-.134-.098-.103-.097-2.358-1.596-2.552-1.688-1.336-.972-.724-.491-.364-.462-.158-1.008.656-.722.881.06.225.061.893.686 1.908 1.476 2.491 1.833.365.304.145-.103.019-.073-.164-.274-1.355-2.446-1.446-2.49-.644-1.032-.17-.619a2.97 2.97 0 01-.104-.729L6.283.134 6.696 0l.996.134.42.364.62 1.414 1.002 2.229 1.555 3.03.456.898.243.832.091.255h.158V9.01l.128-1.706.237-2.095.23-2.695.08-.76.376-.91.747-.492.584.28.48.685-.067.444-.286 1.851-.559 2.903-.364 1.942h.212l.243-.242.985-1.306 1.652-2.064.73-.82.85-.904.547-.431h1.033l.76 1.129-.34 1.166-1.064 1.347-.881 1.142-1.264 1.7-.79 1.36.073.11.188-.02 2.856-.606 1.543-.28 1.841-.315.833.388.091.395-.328.807-1.969.486-2.309.462-3.439.813-.042.03.049.061 1.549.146.662.036h1.622l3.02.225.79.522.474.638-.079.485-1.215.62-1.64-.389-3.829-.91-1.312-.329h-.182v.11l1.093 1.068 2.006 1.81 2.509 2.33.127.578-.322.455-.34-.049-2.205-1.657-.851-.747-1.926-1.62h-.128v.17l.444.649 2.345 3.521.122 1.08-.17.353-.608.213-.668-.122-1.374-1.925-1.415-2.167-1.143-1.943-.14.08-.674 7.254-.316.37-.729.28-.607-.461-.322-.747.322-1.476.389-1.924.315-1.53.286-1.9.17-.632-.012-.042-.14.018-1.434 1.967-2.18 2.945-1.726 1.845-.414.164-.717-.37.067-.662.401-.589 2.388-3.036 1.44-1.882.93-1.086-.006-.158h-.055L4.132 18.56l-1.13.146-.487-.456.061-.746.231-.243 1.908-1.312-.006.006z"></path></svg>

packages/app/assets/icons/codex.svg

@@ -0,0 +1 @@
+<svg fill="currentColor" fill-rule="evenodd" height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>OpenAI</title><path d="M21.55 10.004a5.416 5.416 0 00-.478-4.501c-1.217-2.09-3.662-3.166-6.05-2.66A5.59 5.59 0 0010.831 1C8.39.995 6.224 2.546 5.473 4.838A5.553 5.553 0 001.76 7.496a5.487 5.487 0 00.691 6.5 5.416 5.416 0 00.477 4.502c1.217 2.09 3.662 3.165 6.05 2.66A5.586 5.586 0 0013.168 23c2.443.006 4.61-1.546 5.361-3.84a5.553 5.553 0 003.715-2.66 5.488 5.488 0 00-.693-6.497v.001zm-8.381 11.558a4.199 4.199 0 01-2.675-.954c.034-.018.093-.05.132-.074l4.44-2.53a.71.71 0 00.364-.623v-6.176l1.877 1.069c.02.01.033.029.036.05v5.115c-.003 2.274-1.87 4.118-4.174 4.123zM4.192 17.78a4.059 4.059 0 01-.498-2.763c.032.02.09.055.131.078l4.44 2.53c.225.13.504.13.73 0l5.42-3.088v2.138a.068.068 0 01-.027.057L9.9 19.288c-1.999 1.136-4.552.46-5.707-1.51h-.001zM3.023 8.216A4.15 4.15 0 015.198 6.41l-.002.151v5.06a.711.711 0 00.364.624l5.42 3.087-1.876 1.07a.067.067 0 01-.063.005l-4.489-2.559c-1.995-1.14-2.679-3.658-1.53-5.63h.001zm15.417 3.54l-5.42-3.088L14.896 7.6a.067.067 0 01.063-.006l4.489 2.557c1.998 1.14 2.683 3.662 1.529 5.633a4.163 4.163 0 01-2.174 1.807V12.38a.71.71 0 00-.363-.623zm1.867-2.773a6.04 6.04 0 00-.132-.078l-4.44-2.53a.731.731 0 00-.729 0l-5.42 3.088V7.325a.068.068 0 01.027-.057L14.1 4.713c2-1.137 4.555-.46 5.707 1.513.487.833.664 1.809.499 2.757h.001zm-11.741 3.81l-1.877-1.068a.065.065 0 01-.036-.051V6.559c.001-2.277 1.873-4.122 4.181-4.12.976 0 1.92.338 2.671.954-.034.018-.092.05-.131.073l-4.44 2.53a.71.71 0 00-.365.623l-.003 6.173v.002zm1.02-2.168L12 9.25l2.414 1.375v2.75L12 14.75l-2.415-1.375v-2.75z"></path></svg>

packages/app/assets/images/butterfly-green.svg

@@ -0,0 +1,3 @@
+<svg width="700" height="700" viewBox="0 0 700 700" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M291.495 91.399C333.897 104.892 379.155 135.075 416.229 173.191C453.389 211.394 484.429 259.725 495.708 311.251C497.555 319.693 498.865 328.216 499.586 336.776C509.755 326.554 519.867 317.815 529.89 311.547C540.647 304.821 553.808 299.297 568.641 299.785C584.29 300.299 597.395 307.326 607.747 317.632C632.173 341.947 629.612 372.898 619.872 397.936C610.185 422.833 591.557 447.826 572.732 469.124C553.591 490.78 532.713 510.308 516.779 524.318C508.775 531.355 501.936 537.073 497.07 541.052C494.635 543.043 492.689 544.603 491.334 545.679C490.657 546.217 490.126 546.635 489.756 546.926C489.571 547.071 489.425 547.184 489.321 547.265C489.269 547.305 489.227 547.338 489.196 547.362C489.181 547.374 489.168 547.385 489.157 547.393C489.153 547.397 489.147 547.401 489.144 547.403C489.134 547.4 488.837 547.06 473.001 528.499L489.135 547.411C478.157 555.911 462.033 554.334 453.122 543.89C444.213 533.448 445.887 518.094 456.861 509.592C456.863 509.591 456.865 509.588 456.869 509.586C456.88 509.577 456.902 509.561 456.933 509.536C456.997 509.487 457.101 509.404 457.245 509.292C457.533 509.066 457.979 508.715 458.569 508.247C459.749 507.31 461.506 505.901 463.742 504.073C468.216 500.414 474.589 495.088 482.073 488.508C497.114 475.284 516.315 457.282 533.578 437.75C551.157 417.862 565.26 398.01 571.859 381.048C578.403 364.227 575.681 356.302 570.724 351.367C568.928 349.579 567.744 348.902 567.267 348.676C566.888 348.496 566.811 348.52 566.804 348.52C566.605 348.513 563.971 348.537 557.953 352.3C545.161 360.299 528.815 377.492 506.807 403.867C494.927 418.106 481.871 434.435 467.547 451.957C463.709 457.28 459.503 462.538 454.91 467.717L454.702 467.549C420.808 508.347 380.37 553.856 332.335 593.848C301.853 619.226 262.656 622.597 228.642 614.743C194.834 606.936 162.658 587.448 142.217 561.686C108.054 518.631 100.57 469.801 108.223 427.836C115.56 387.606 137.391 351.005 166.502 331.557C161.248 315.813 156.813 299.49 153.519 283.013C142.593 228.368 143.239 167.031 174.28 119.619C186.922 100.31 205.846 89.1535 227.387 85.2773C248.1 81.5504 270.278 84.648 291.495 91.399ZM378.642 206.356C345.773 172.563 307.463 147.917 275.208 137.654C259.096 132.527 246.171 131.514 236.828 133.195C228.314 134.727 222.227 138.497 217.721 145.38C196.712 177.468 193.858 224.004 203.82 273.827C206.532 287.394 210.127 300.834 214.345 313.817C236.45 310.276 260.156 311.463 281.22 317.11C319.621 327.403 357.501 355.419 357.501 405.654C357.501 435.255 339.111 465.136 307.278 473.815C273.211 483.103 238.854 464.822 213.105 427.541C203.716 413.947 194.443 397.766 185.947 379.89C174.028 392.223 163.08 411.953 158.673 436.118C153.128 466.518 158.514 501.286 183.085 532.253C195.993 548.522 217.742 562.031 240.771 567.349C263.594 572.619 284.147 569.24 298.664 557.154C349.383 514.927 390.709 466.547 426.366 422.952C448.879 390.86 453.195 356.06 445.578 321.265C436.703 280.718 411.425 240.06 378.642 206.356ZM306.296 405.722C306.296 384.769 292.223 370.736 267.284 364.051C256.012 361.03 244.156 360.087 233.095 360.771C240.361 375.935 248.168 389.513 255.897 400.704C275.647 429.298 289.989 427.822 293.247 426.934C298.737 425.437 306.296 418.161 306.296 405.722Z" fill="#20744A"/>
+</svg>

packages/app/assets/images/butterfly-white.svg

@@ -0,0 +1,3 @@
+<svg width="700" height="700" viewBox="0 0 700 700" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M291.495 91.399C333.897 104.892 379.155 135.075 416.229 173.191C453.389 211.394 484.429 259.725 495.708 311.251C497.555 319.693 498.865 328.216 499.586 336.776C509.755 326.554 519.867 317.815 529.89 311.547C540.647 304.821 553.808 299.297 568.641 299.785C584.29 300.299 597.395 307.326 607.747 317.632C632.173 341.947 629.612 372.898 619.872 397.936C610.185 422.833 591.557 447.826 572.732 469.124C553.591 490.78 532.713 510.308 516.779 524.318C508.775 531.355 501.936 537.073 497.07 541.052C494.635 543.043 492.689 544.603 491.334 545.679C490.657 546.217 490.126 546.635 489.756 546.926C489.571 547.071 489.425 547.184 489.321 547.265C489.269 547.305 489.227 547.338 489.196 547.362C489.181 547.374 489.168 547.385 489.157 547.393C489.153 547.397 489.147 547.401 489.144 547.403C489.134 547.4 488.837 547.06 473.001 528.499L489.135 547.411C478.157 555.911 462.033 554.334 453.122 543.89C444.213 533.448 445.887 518.094 456.861 509.592C456.863 509.591 456.865 509.588 456.869 509.586C456.88 509.577 456.902 509.561 456.933 509.536C456.997 509.487 457.101 509.404 457.245 509.292C457.533 509.066 457.979 508.715 458.569 508.247C459.749 507.31 461.506 505.901 463.742 504.073C468.216 500.414 474.589 495.088 482.073 488.508C497.114 475.284 516.315 457.282 533.578 437.75C551.157 417.862 565.26 398.01 571.859 381.048C578.403 364.227 575.681 356.302 570.724 351.367C568.928 349.579 567.744 348.902 567.267 348.676C566.888 348.496 566.811 348.52 566.804 348.52C566.605 348.513 563.971 348.537 557.953 352.3C545.161 360.299 528.815 377.492 506.807 403.867C494.927 418.106 481.871 434.435 467.547 451.957C463.709 457.28 459.503 462.538 454.91 467.717L454.702 467.549C420.808 508.347 380.37 553.856 332.335 593.848C301.853 619.226 262.656 622.597 228.642 614.743C194.834 606.936 162.658 587.448 142.217 561.686C108.054 518.631 100.57 469.801 108.223 427.836C115.56 387.606 137.391 351.005 166.502 331.557C161.248 315.813 156.813 299.49 153.519 283.013C142.593 228.368 143.239 167.031 174.28 119.619C186.922 100.31 205.846 89.1535 227.387 85.2773C248.1 81.5504 270.278 84.648 291.495 91.399ZM378.642 206.356C345.773 172.563 307.463 147.917 275.208 137.654C259.096 132.527 246.171 131.514 236.828 133.195C228.314 134.727 222.227 138.497 217.721 145.38C196.712 177.468 193.858 224.004 203.82 273.827C206.532 287.394 210.127 300.834 214.345 313.817C236.45 310.276 260.156 311.463 281.22 317.11C319.621 327.403 357.501 355.419 357.501 405.654C357.501 435.255 339.111 465.136 307.278 473.815C273.211 483.103 238.854 464.822 213.105 427.541C203.716 413.947 194.443 397.766 185.947 379.89C174.028 392.223 163.08 411.953 158.673 436.118C153.128 466.518 158.514 501.286 183.085 532.253C195.993 548.522 217.742 562.031 240.771 567.349C263.594 572.619 284.147 569.24 298.664 557.154C349.383 514.927 390.709 466.547 426.366 422.952C448.879 390.86 453.195 356.06 445.578 321.265C436.703 280.718 411.425 240.06 378.642 206.356ZM306.296 405.722C306.296 384.769 292.223 370.736 267.284 364.051C256.012 361.03 244.156 360.087 233.095 360.771C240.361 375.935 248.168 389.513 255.897 400.704C275.647 429.298 289.989 427.822 293.247 426.934C298.737 425.437 306.296 418.161 306.296 405.722Z" fill="white"/>
+</svg>

packages/app/assets/images/favicon-dark-attention.svg

@@ -0,0 +1,5 @@
+<svg width="48" height="48" viewBox="0 0 700 700" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect width="700" height="700" rx="156" fill="black"/>
+<path transform="translate(350,350) scale(1.05) translate(-350,-350)" d="M291.495 91.399C333.897 104.892 379.155 135.075 416.229 173.191C453.389 211.394 484.429 259.725 495.708 311.251C497.555 319.693 498.865 328.216 499.586 336.776C509.755 326.554 519.867 317.815 529.89 311.547C540.647 304.821 553.808 299.297 568.641 299.785C584.29 300.299 597.395 307.326 607.747 317.632C632.173 341.947 629.612 372.898 619.872 397.936C610.185 422.833 591.557 447.826 572.732 469.124C553.591 490.78 532.713 510.308 516.779 524.318C508.775 531.355 501.936 537.073 497.07 541.052C494.635 543.043 492.689 544.603 491.334 545.679C490.657 546.217 490.126 546.635 489.756 546.926C489.571 547.071 489.425 547.184 489.321 547.265C489.269 547.305 489.227 547.338 489.196 547.362C489.181 547.374 489.168 547.385 489.157 547.393C489.153 547.397 489.147 547.401 489.144 547.403C489.134 547.4 488.837 547.06 473.001 528.499L489.135 547.411C478.157 555.911 462.033 554.334 453.122 543.89C444.213 533.448 445.887 518.094 456.861 509.592C456.863 509.591 456.865 509.588 456.869 509.586C456.88 509.577 456.902 509.561 456.933 509.536C456.997 509.487 457.101 509.404 457.245 509.292C457.533 509.066 457.979 508.715 458.569 508.247C459.749 507.31 461.506 505.901 463.742 504.073C468.216 500.414 474.589 495.088 482.073 488.508C497.114 475.284 516.315 457.282 533.578 437.75C551.157 417.862 565.26 398.01 571.859 381.048C578.403 364.227 575.681 356.302 570.724 351.367C568.928 349.579 567.744 348.902 567.267 348.676C566.888 348.496 566.811 348.52 566.804 348.52C566.605 348.513 563.971 348.537 557.953 352.3C545.161 360.299 528.815 377.492 506.807 403.867C494.927 418.106 481.871 434.435 467.547 451.957C463.709 457.28 459.503 462.538 454.91 467.717L454.702 467.549C420.808 508.347 380.37 553.856 332.335 593.848C301.853 619.226 262.656 622.597 228.642 614.743C194.834 606.936 162.658 587.448 142.217 561.686C108.054 518.631 100.57 469.801 108.223 427.836C115.56 387.606 137.391 351.005 166.502 331.557C161.248 315.813 156.813 299.49 153.519 283.013C142.593 228.368 143.239 167.031 174.28 119.619C186.922 100.31 205.846 89.1535 227.387 85.2773C248.1 81.5504 270.278 84.648 291.495 91.399ZM378.642 206.356C345.773 172.563 307.463 147.917 275.208 137.654C259.096 132.527 246.171 131.514 236.828 133.195C228.314 134.727 222.227 138.497 217.721 145.38C196.712 177.468 193.858 224.004 203.82 273.827C206.532 287.394 210.127 300.834 214.345 313.817C236.45 310.276 260.156 311.463 281.22 317.11C319.621 327.403 357.501 355.419 357.501 405.654C357.501 435.255 339.111 465.136 307.278 473.815C273.211 483.103 238.854 464.822 213.105 427.541C203.716 413.947 194.443 397.766 185.947 379.89C174.028 392.223 163.08 411.953 158.673 436.118C153.128 466.518 158.514 501.286 183.085 532.253C195.993 548.522 217.742 562.031 240.771 567.349C263.594 572.619 284.147 569.24 298.664 557.154C349.383 514.927 390.709 466.547 426.366 422.952C448.879 390.86 453.195 356.06 445.578 321.265C436.703 280.718 411.425 240.06 378.642 206.356ZM306.296 405.722C306.296 384.769 292.223 370.736 267.284 364.051C256.012 361.03 244.156 360.087 233.095 360.771C240.361 375.935 248.168 389.513 255.897 400.704C275.647 429.298 289.989 427.822 293.247 426.934C298.737 425.437 306.296 418.161 306.296 405.722Z" fill="white"/>
+<circle cx="570" cy="570" r="130" fill="#22c55e"/>
+</svg>

packages/app/assets/images/favicon-dark-running.svg

@@ -0,0 +1,5 @@
+<svg width="48" height="48" viewBox="0 0 700 700" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect width="700" height="700" rx="156" fill="black"/>
+<path transform="translate(350,350) scale(1.05) translate(-350,-350)" d="M291.495 91.399C333.897 104.892 379.155 135.075 416.229 173.191C453.389 211.394 484.429 259.725 495.708 311.251C497.555 319.693 498.865 328.216 499.586 336.776C509.755 326.554 519.867 317.815 529.89 311.547C540.647 304.821 553.808 299.297 568.641 299.785C584.29 300.299 597.395 307.326 607.747 317.632C632.173 341.947 629.612 372.898 619.872 397.936C610.185 422.833 591.557 447.826 572.732 469.124C553.591 490.78 532.713 510.308 516.779 524.318C508.775 531.355 501.936 537.073 497.07 541.052C494.635 543.043 492.689 544.603 491.334 545.679C490.657 546.217 490.126 546.635 489.756 546.926C489.571 547.071 489.425 547.184 489.321 547.265C489.269 547.305 489.227 547.338 489.196 547.362C489.181 547.374 489.168 547.385 489.157 547.393C489.153 547.397 489.147 547.401 489.144 547.403C489.134 547.4 488.837 547.06 473.001 528.499L489.135 547.411C478.157 555.911 462.033 554.334 453.122 543.89C444.213 533.448 445.887 518.094 456.861 509.592C456.863 509.591 456.865 509.588 456.869 509.586C456.88 509.577 456.902 509.561 456.933 509.536C456.997 509.487 457.101 509.404 457.245 509.292C457.533 509.066 457.979 508.715 458.569 508.247C459.749 507.31 461.506 505.901 463.742 504.073C468.216 500.414 474.589 495.088 482.073 488.508C497.114 475.284 516.315 457.282 533.578 437.75C551.157 417.862 565.26 398.01 571.859 381.048C578.403 364.227 575.681 356.302 570.724 351.367C568.928 349.579 567.744 348.902 567.267 348.676C566.888 348.496 566.811 348.52 566.804 348.52C566.605 348.513 563.971 348.537 557.953 352.3C545.161 360.299 528.815 377.492 506.807 403.867C494.927 418.106 481.871 434.435 467.547 451.957C463.709 457.28 459.503 462.538 454.91 467.717L454.702 467.549C420.808 508.347 380.37 553.856 332.335 593.848C301.853 619.226 262.656 622.597 228.642 614.743C194.834 606.936 162.658 587.448 142.217 561.686C108.054 518.631 100.57 469.801 108.223 427.836C115.56 387.606 137.391 351.005 166.502 331.557C161.248 315.813 156.813 299.49 153.519 283.013C142.593 228.368 143.239 167.031 174.28 119.619C186.922 100.31 205.846 89.1535 227.387 85.2773C248.1 81.5504 270.278 84.648 291.495 91.399ZM378.642 206.356C345.773 172.563 307.463 147.917 275.208 137.654C259.096 132.527 246.171 131.514 236.828 133.195C228.314 134.727 222.227 138.497 217.721 145.38C196.712 177.468 193.858 224.004 203.82 273.827C206.532 287.394 210.127 300.834 214.345 313.817C236.45 310.276 260.156 311.463 281.22 317.11C319.621 327.403 357.501 355.419 357.501 405.654C357.501 435.255 339.111 465.136 307.278 473.815C273.211 483.103 238.854 464.822 213.105 427.541C203.716 413.947 194.443 397.766 185.947 379.89C174.028 392.223 163.08 411.953 158.673 436.118C153.128 466.518 158.514 501.286 183.085 532.253C195.993 548.522 217.742 562.031 240.771 567.349C263.594 572.619 284.147 569.24 298.664 557.154C349.383 514.927 390.709 466.547 426.366 422.952C448.879 390.86 453.195 356.06 445.578 321.265C436.703 280.718 411.425 240.06 378.642 206.356ZM306.296 405.722C306.296 384.769 292.223 370.736 267.284 364.051C256.012 361.03 244.156 360.087 233.095 360.771C240.361 375.935 248.168 389.513 255.897 400.704C275.647 429.298 289.989 427.822 293.247 426.934C298.737 425.437 306.296 418.161 306.296 405.722Z" fill="white"/>
+<circle cx="570" cy="570" r="130" fill="#3b82f6"/>
+</svg>

packages/app/assets/images/favicon-dark.svg

@@ -0,0 +1,4 @@
+<svg width="48" height="48" viewBox="0 0 700 700" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect width="700" height="700" rx="156" fill="black"/>
+<path transform="translate(350,350) scale(1.05) translate(-350,-350)" d="M291.495 91.399C333.897 104.892 379.155 135.075 416.229 173.191C453.389 211.394 484.429 259.725 495.708 311.251C497.555 319.693 498.865 328.216 499.586 336.776C509.755 326.554 519.867 317.815 529.89 311.547C540.647 304.821 553.808 299.297 568.641 299.785C584.29 300.299 597.395 307.326 607.747 317.632C632.173 341.947 629.612 372.898 619.872 397.936C610.185 422.833 591.557 447.826 572.732 469.124C553.591 490.78 532.713 510.308 516.779 524.318C508.775 531.355 501.936 537.073 497.07 541.052C494.635 543.043 492.689 544.603 491.334 545.679C490.657 546.217 490.126 546.635 489.756 546.926C489.571 547.071 489.425 547.184 489.321 547.265C489.269 547.305 489.227 547.338 489.196 547.362C489.181 547.374 489.168 547.385 489.157 547.393C489.153 547.397 489.147 547.401 489.144 547.403C489.134 547.4 488.837 547.06 473.001 528.499L489.135 547.411C478.157 555.911 462.033 554.334 453.122 543.89C444.213 533.448 445.887 518.094 456.861 509.592C456.863 509.591 456.865 509.588 456.869 509.586C456.88 509.577 456.902 509.561 456.933 509.536C456.997 509.487 457.101 509.404 457.245 509.292C457.533 509.066 457.979 508.715 458.569 508.247C459.749 507.31 461.506 505.901 463.742 504.073C468.216 500.414 474.589 495.088 482.073 488.508C497.114 475.284 516.315 457.282 533.578 437.75C551.157 417.862 565.26 398.01 571.859 381.048C578.403 364.227 575.681 356.302 570.724 351.367C568.928 349.579 567.744 348.902 567.267 348.676C566.888 348.496 566.811 348.52 566.804 348.52C566.605 348.513 563.971 348.537 557.953 352.3C545.161 360.299 528.815 377.492 506.807 403.867C494.927 418.106 481.871 434.435 467.547 451.957C463.709 457.28 459.503 462.538 454.91 467.717L454.702 467.549C420.808 508.347 380.37 553.856 332.335 593.848C301.853 619.226 262.656 622.597 228.642 614.743C194.834 606.936 162.658 587.448 142.217 561.686C108.054 518.631 100.57 469.801 108.223 427.836C115.56 387.606 137.391 351.005 166.502 331.557C161.248 315.813 156.813 299.49 153.519 283.013C142.593 228.368 143.239 167.031 174.28 119.619C186.922 100.31 205.846 89.1535 227.387 85.2773C248.1 81.5504 270.278 84.648 291.495 91.399ZM378.642 206.356C345.773 172.563 307.463 147.917 275.208 137.654C259.096 132.527 246.171 131.514 236.828 133.195C228.314 134.727 222.227 138.497 217.721 145.38C196.712 177.468 193.858 224.004 203.82 273.827C206.532 287.394 210.127 300.834 214.345 313.817C236.45 310.276 260.156 311.463 281.22 317.11C319.621 327.403 357.501 355.419 357.501 405.654C357.501 435.255 339.111 465.136 307.278 473.815C273.211 483.103 238.854 464.822 213.105 427.541C203.716 413.947 194.443 397.766 185.947 379.89C174.028 392.223 163.08 411.953 158.673 436.118C153.128 466.518 158.514 501.286 183.085 532.253C195.993 548.522 217.742 562.031 240.771 567.349C263.594 572.619 284.147 569.24 298.664 557.154C349.383 514.927 390.709 466.547 426.366 422.952C448.879 390.86 453.195 356.06 445.578 321.265C436.703 280.718 411.425 240.06 378.642 206.356ZM306.296 405.722C306.296 384.769 292.223 370.736 267.284 364.051C256.012 361.03 244.156 360.087 233.095 360.771C240.361 375.935 248.168 389.513 255.897 400.704C275.647 429.298 289.989 427.822 293.247 426.934C298.737 425.437 306.296 418.161 306.296 405.722Z" fill="white"/>
+</svg>

packages/app/assets/images/favicon-light-attention.svg

@@ -0,0 +1,5 @@
+<svg width="48" height="48" viewBox="0 0 700 700" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect width="700" height="700" rx="156" fill="black"/>
+<path transform="translate(350,350) scale(1.05) translate(-350,-350)" d="M291.495 91.399C333.897 104.892 379.155 135.075 416.229 173.191C453.389 211.394 484.429 259.725 495.708 311.251C497.555 319.693 498.865 328.216 499.586 336.776C509.755 326.554 519.867 317.815 529.89 311.547C540.647 304.821 553.808 299.297 568.641 299.785C584.29 300.299 597.395 307.326 607.747 317.632C632.173 341.947 629.612 372.898 619.872 397.936C610.185 422.833 591.557 447.826 572.732 469.124C553.591 490.78 532.713 510.308 516.779 524.318C508.775 531.355 501.936 537.073 497.07 541.052C494.635 543.043 492.689 544.603 491.334 545.679C490.657 546.217 490.126 546.635 489.756 546.926C489.571 547.071 489.425 547.184 489.321 547.265C489.269 547.305 489.227 547.338 489.196 547.362C489.181 547.374 489.168 547.385 489.157 547.393C489.153 547.397 489.147 547.401 489.144 547.403C489.134 547.4 488.837 547.06 473.001 528.499L489.135 547.411C478.157 555.911 462.033 554.334 453.122 543.89C444.213 533.448 445.887 518.094 456.861 509.592C456.863 509.591 456.865 509.588 456.869 509.586C456.88 509.577 456.902 509.561 456.933 509.536C456.997 509.487 457.101 509.404 457.245 509.292C457.533 509.066 457.979 508.715 458.569 508.247C459.749 507.31 461.506 505.901 463.742 504.073C468.216 500.414 474.589 495.088 482.073 488.508C497.114 475.284 516.315 457.282 533.578 437.75C551.157 417.862 565.26 398.01 571.859 381.048C578.403 364.227 575.681 356.302 570.724 351.367C568.928 349.579 567.744 348.902 567.267 348.676C566.888 348.496 566.811 348.52 566.804 348.52C566.605 348.513 563.971 348.537 557.953 352.3C545.161 360.299 528.815 377.492 506.807 403.867C494.927 418.106 481.871 434.435 467.547 451.957C463.709 457.28 459.503 462.538 454.91 467.717L454.702 467.549C420.808 508.347 380.37 553.856 332.335 593.848C301.853 619.226 262.656 622.597 228.642 614.743C194.834 606.936 162.658 587.448 142.217 561.686C108.054 518.631 100.57 469.801 108.223 427.836C115.56 387.606 137.391 351.005 166.502 331.557C161.248 315.813 156.813 299.49 153.519 283.013C142.593 228.368 143.239 167.031 174.28 119.619C186.922 100.31 205.846 89.1535 227.387 85.2773C248.1 81.5504 270.278 84.648 291.495 91.399ZM378.642 206.356C345.773 172.563 307.463 147.917 275.208 137.654C259.096 132.527 246.171 131.514 236.828 133.195C228.314 134.727 222.227 138.497 217.721 145.38C196.712 177.468 193.858 224.004 203.82 273.827C206.532 287.394 210.127 300.834 214.345 313.817C236.45 310.276 260.156 311.463 281.22 317.11C319.621 327.403 357.501 355.419 357.501 405.654C357.501 435.255 339.111 465.136 307.278 473.815C273.211 483.103 238.854 464.822 213.105 427.541C203.716 413.947 194.443 397.766 185.947 379.89C174.028 392.223 163.08 411.953 158.673 436.118C153.128 466.518 158.514 501.286 183.085 532.253C195.993 548.522 217.742 562.031 240.771 567.349C263.594 572.619 284.147 569.24 298.664 557.154C349.383 514.927 390.709 466.547 426.366 422.952C448.879 390.86 453.195 356.06 445.578 321.265C436.703 280.718 411.425 240.06 378.642 206.356ZM306.296 405.722C306.296 384.769 292.223 370.736 267.284 364.051C256.012 361.03 244.156 360.087 233.095 360.771C240.361 375.935 248.168 389.513 255.897 400.704C275.647 429.298 289.989 427.822 293.247 426.934C298.737 425.437 306.296 418.161 306.296 405.722Z" fill="white"/>
+<circle cx="570" cy="570" r="130" fill="#22c55e"/>
+</svg>

packages/app/assets/images/favicon-light-running.svg

@@ -0,0 +1,5 @@
+<svg width="48" height="48" viewBox="0 0 700 700" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect width="700" height="700" rx="156" fill="black"/>
+<path transform="translate(350,350) scale(1.05) translate(-350,-350)" d="M291.495 91.399C333.897 104.892 379.155 135.075 416.229 173.191C453.389 211.394 484.429 259.725 495.708 311.251C497.555 319.693 498.865 328.216 499.586 336.776C509.755 326.554 519.867 317.815 529.89 311.547C540.647 304.821 553.808 299.297 568.641 299.785C584.29 300.299 597.395 307.326 607.747 317.632C632.173 341.947 629.612 372.898 619.872 397.936C610.185 422.833 591.557 447.826 572.732 469.124C553.591 490.78 532.713 510.308 516.779 524.318C508.775 531.355 501.936 537.073 497.07 541.052C494.635 543.043 492.689 544.603 491.334 545.679C490.657 546.217 490.126 546.635 489.756 546.926C489.571 547.071 489.425 547.184 489.321 547.265C489.269 547.305 489.227 547.338 489.196 547.362C489.181 547.374 489.168 547.385 489.157 547.393C489.153 547.397 489.147 547.401 489.144 547.403C489.134 547.4 488.837 547.06 473.001 528.499L489.135 547.411C478.157 555.911 462.033 554.334 453.122 543.89C444.213 533.448 445.887 518.094 456.861 509.592C456.863 509.591 456.865 509.588 456.869 509.586C456.88 509.577 456.902 509.561 456.933 509.536C456.997 509.487 457.101 509.404 457.245 509.292C457.533 509.066 457.979 508.715 458.569 508.247C459.749 507.31 461.506 505.901 463.742 504.073C468.216 500.414 474.589 495.088 482.073 488.508C497.114 475.284 516.315 457.282 533.578 437.75C551.157 417.862 565.26 398.01 571.859 381.048C578.403 364.227 575.681 356.302 570.724 351.367C568.928 349.579 567.744 348.902 567.267 348.676C566.888 348.496 566.811 348.52 566.804 348.52C566.605 348.513 563.971 348.537 557.953 352.3C545.161 360.299 528.815 377.492 506.807 403.867C494.927 418.106 481.871 434.435 467.547 451.957C463.709 457.28 459.503 462.538 454.91 467.717L454.702 467.549C420.808 508.347 380.37 553.856 332.335 593.848C301.853 619.226 262.656 622.597 228.642 614.743C194.834 606.936 162.658 587.448 142.217 561.686C108.054 518.631 100.57 469.801 108.223 427.836C115.56 387.606 137.391 351.005 166.502 331.557C161.248 315.813 156.813 299.49 153.519 283.013C142.593 228.368 143.239 167.031 174.28 119.619C186.922 100.31 205.846 89.1535 227.387 85.2773C248.1 81.5504 270.278 84.648 291.495 91.399ZM378.642 206.356C345.773 172.563 307.463 147.917 275.208 137.654C259.096 132.527 246.171 131.514 236.828 133.195C228.314 134.727 222.227 138.497 217.721 145.38C196.712 177.468 193.858 224.004 203.82 273.827C206.532 287.394 210.127 300.834 214.345 313.817C236.45 310.276 260.156 311.463 281.22 317.11C319.621 327.403 357.501 355.419 357.501 405.654C357.501 435.255 339.111 465.136 307.278 473.815C273.211 483.103 238.854 464.822 213.105 427.541C203.716 413.947 194.443 397.766 185.947 379.89C174.028 392.223 163.08 411.953 158.673 436.118C153.128 466.518 158.514 501.286 183.085 532.253C195.993 548.522 217.742 562.031 240.771 567.349C263.594 572.619 284.147 569.24 298.664 557.154C349.383 514.927 390.709 466.547 426.366 422.952C448.879 390.86 453.195 356.06 445.578 321.265C436.703 280.718 411.425 240.06 378.642 206.356ZM306.296 405.722C306.296 384.769 292.223 370.736 267.284 364.051C256.012 361.03 244.156 360.087 233.095 360.771C240.361 375.935 248.168 389.513 255.897 400.704C275.647 429.298 289.989 427.822 293.247 426.934C298.737 425.437 306.296 418.161 306.296 405.722Z" fill="white"/>
+<circle cx="570" cy="570" r="130" fill="#3b82f6"/>
+</svg>

packages/app/assets/images/favicon-light.svg

@@ -0,0 +1,4 @@
+<svg width="48" height="48" viewBox="0 0 700 700" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect width="700" height="700" rx="156" fill="black"/>
+<path transform="translate(350,350) scale(1.05) translate(-350,-350)" d="M291.495 91.399C333.897 104.892 379.155 135.075 416.229 173.191C453.389 211.394 484.429 259.725 495.708 311.251C497.555 319.693 498.865 328.216 499.586 336.776C509.755 326.554 519.867 317.815 529.89 311.547C540.647 304.821 553.808 299.297 568.641 299.785C584.29 300.299 597.395 307.326 607.747 317.632C632.173 341.947 629.612 372.898 619.872 397.936C610.185 422.833 591.557 447.826 572.732 469.124C553.591 490.78 532.713 510.308 516.779 524.318C508.775 531.355 501.936 537.073 497.07 541.052C494.635 543.043 492.689 544.603 491.334 545.679C490.657 546.217 490.126 546.635 489.756 546.926C489.571 547.071 489.425 547.184 489.321 547.265C489.269 547.305 489.227 547.338 489.196 547.362C489.181 547.374 489.168 547.385 489.157 547.393C489.153 547.397 489.147 547.401 489.144 547.403C489.134 547.4 488.837 547.06 473.001 528.499L489.135 547.411C478.157 555.911 462.033 554.334 453.122 543.89C444.213 533.448 445.887 518.094 456.861 509.592C456.863 509.591 456.865 509.588 456.869 509.586C456.88 509.577 456.902 509.561 456.933 509.536C456.997 509.487 457.101 509.404 457.245 509.292C457.533 509.066 457.979 508.715 458.569 508.247C459.749 507.31 461.506 505.901 463.742 504.073C468.216 500.414 474.589 495.088 482.073 488.508C497.114 475.284 516.315 457.282 533.578 437.75C551.157 417.862 565.26 398.01 571.859 381.048C578.403 364.227 575.681 356.302 570.724 351.367C568.928 349.579 567.744 348.902 567.267 348.676C566.888 348.496 566.811 348.52 566.804 348.52C566.605 348.513 563.971 348.537 557.953 352.3C545.161 360.299 528.815 377.492 506.807 403.867C494.927 418.106 481.871 434.435 467.547 451.957C463.709 457.28 459.503 462.538 454.91 467.717L454.702 467.549C420.808 508.347 380.37 553.856 332.335 593.848C301.853 619.226 262.656 622.597 228.642 614.743C194.834 606.936 162.658 587.448 142.217 561.686C108.054 518.631 100.57 469.801 108.223 427.836C115.56 387.606 137.391 351.005 166.502 331.557C161.248 315.813 156.813 299.49 153.519 283.013C142.593 228.368 143.239 167.031 174.28 119.619C186.922 100.31 205.846 89.1535 227.387 85.2773C248.1 81.5504 270.278 84.648 291.495 91.399ZM378.642 206.356C345.773 172.563 307.463 147.917 275.208 137.654C259.096 132.527 246.171 131.514 236.828 133.195C228.314 134.727 222.227 138.497 217.721 145.38C196.712 177.468 193.858 224.004 203.82 273.827C206.532 287.394 210.127 300.834 214.345 313.817C236.45 310.276 260.156 311.463 281.22 317.11C319.621 327.403 357.501 355.419 357.501 405.654C357.501 435.255 339.111 465.136 307.278 473.815C273.211 483.103 238.854 464.822 213.105 427.541C203.716 413.947 194.443 397.766 185.947 379.89C174.028 392.223 163.08 411.953 158.673 436.118C153.128 466.518 158.514 501.286 183.085 532.253C195.993 548.522 217.742 562.031 240.771 567.349C263.594 572.619 284.147 569.24 298.664 557.154C349.383 514.927 390.709 466.547 426.366 422.952C448.879 390.86 453.195 356.06 445.578 321.265C436.703 280.718 411.425 240.06 378.642 206.356ZM306.296 405.722C306.296 384.769 292.223 370.736 267.284 364.051C256.012 361.03 244.156 360.087 233.095 360.771C240.361 375.935 248.168 389.513 255.897 400.704C275.647 429.298 289.989 427.822 293.247 426.934C298.737 425.437 306.296 418.161 306.296 405.722Z" fill="white"/>
+</svg>

packages/app/babel.config.js

@@ -0,0 +1,24 @@
+module.exports = function (api) {
+  api.cache(true);
+
+  const expoPreset = [
+    "babel-preset-expo",
+    {
+      // Transform `import.meta` for ALL platforms (web + native)
+      // Required for modern ESM deps like Zustand 5 that use import.meta.env
+      unstable_transformImportMeta: true,
+    },
+  ];
+
+  return {
+    presets: [expoPreset],
+    plugins: [
+      [
+        "react-native-unistyles/plugin",
+        {
+          root: "src",
+        },
+      ],
+    ],
+  };
+};

packages/app/e2e/agent-details-sheet.spec.ts

@@ -0,0 +1,37 @@
+import { test, expect } from "./fixtures";
+import { createAgent, ensureHostSelected, gotoHome, setWorkingDirectory } from "./helpers/app";
+import { createTempGitRepo } from "./helpers/workspace";
+
+test("agent details sheet shows IDs and copy toast", async ({ page }) => {
+  test.setTimeout(120_000);
+  const repo = await createTempGitRepo();
+  const prompt = "Respond with exactly: Hello";
+
+  try {
+    await gotoHome(page);
+    await setWorkingDirectory(page, repo.path);
+    await ensureHostSelected(page);
+    await createAgent(page, prompt);
+
+    await page.getByTestId("agent-overflow-menu").click();
+    await page.getByTestId("agent-menu-details").click();
+
+    await expect(page.getByTestId("agent-details-sheet")).toBeVisible();
+
+    await expect(page.getByTestId("agent-details-agent-id")).toBeVisible();
+    await expect(page.getByTestId("agent-details-agent-id-value")).not.toHaveText(
+      "Not available"
+    );
+
+    await expect(page.getByTestId("agent-details-persistence-session-id")).toBeVisible();
+    await expect(
+      page.getByTestId("agent-details-persistence-session-id-value")
+    ).not.toHaveText("Not available", { timeout: 90_000 });
+
+    await page.getByTestId("agent-details-agent-id").click();
+    await expect(page.getByTestId("app-toast")).toBeVisible();
+    await expect(page.getByTestId("app-toast-message")).toHaveText(/copied/i);
+  } finally {
+    await repo.cleanup();
+  }
+});

packages/app/e2e/agent-timeline-hydration.spec.ts

@@ -0,0 +1,34 @@
+import { test, expect } from './fixtures';
+import { createAgent, ensureHostSelected, gotoHome, setWorkingDirectory } from './helpers/app';
+import { createTempGitRepo } from './helpers/workspace';
+
+test('agent timeline hydrates after reload via fetch_agent_timeline_request', async ({ page }) => {
+  const repo = await createTempGitRepo();
+  const marker = 'TIMELINE_HYDRATION_OK';
+  const prompt = `Respond with exactly: ${marker}`;
+
+  try {
+    await gotoHome(page);
+    await setWorkingDirectory(page, repo.path);
+    await ensureHostSelected(page);
+    await createAgent(page, prompt);
+
+    const assistantMessage = page
+      .getByTestId('assistant-message')
+      .filter({ hasText: marker })
+      .first();
+    await expect(assistantMessage).toBeVisible({ timeout: 120000 });
+
+    await page.reload({ waitUntil: 'commit' });
+    await expect(page).toHaveURL(/\/agent\//);
+    await expect(page.getByTestId('agent-loading')).toHaveCount(0, { timeout: 30000 });
+    await expect(page.getByText(prompt, { exact: true }).first()).toBeVisible({
+      timeout: 30000,
+    });
+    await expect(
+      page.getByTestId('assistant-message').filter({ hasText: marker }).first()
+    ).toBeVisible({ timeout: 30000 });
+  } finally {
+    await repo.cleanup();
+  }
+});

packages/app/e2e/checkout-ship.spec.ts

@@ -0,0 +1,428 @@
+import path from 'node:path';
+import { appendFile, mkdtemp, rm, writeFile, realpath } from 'node:fs/promises';
+import { execSync } from 'node:child_process';
+import { tmpdir } from 'node:os';
+import { test, expect, type Page } from './fixtures';
+import {
+  ensureHostSelected,
+  gotoHome,
+  setWorkingDirectory,
+} from './helpers/app';
+import { createTempGitRepo } from './helpers/workspace';
+
+test.describe.configure({ mode: 'serial', timeout: 120000 });
+
+function getChangesScope(page: Page) {
+  return page.locator('[data-testid="explorer-content-area"]:visible').first();
+}
+
+function getChangesHeader(page: Page) {
+  return getChangesScope(page).getByTestId('changes-header');
+}
+
+async function selectChangesView(page: Page, view: 'working' | 'base') {
+  // Defensive: close any open dropdown menus (their backdrops intercept clicks).
+  const primaryBackdrop = page.getByTestId('changes-primary-cta-menu-backdrop');
+  if (await primaryBackdrop.isVisible().catch(() => false)) {
+    await primaryBackdrop.click({ force: true });
+    await expect(primaryBackdrop).toHaveCount(0);
+  }
+  const overflowBackdrop = page.getByTestId('changes-overflow-content-backdrop');
+  if (await overflowBackdrop.isVisible().catch(() => false)) {
+    await overflowBackdrop.click({ force: true });
+    await expect(overflowBackdrop).toHaveCount(0);
+  }
+
+  const scope = getChangesScope(page);
+  const modeToggle = scope.getByTestId('changes-diff-status').first();
+  const expected = view === 'working' ? 'Uncommitted' : 'Committed';
+  if (!(await modeToggle.isVisible().catch(() => false))) {
+    return;
+  }
+  const current = ((await modeToggle.innerText().catch(() => '')) ?? '').trim();
+  if (current !== expected) {
+    await modeToggle.click();
+  }
+  await expect(modeToggle).toContainText(expected, { timeout: 10000 });
+}
+
+async function openChangesOverflowMenu(page: Page) {
+  const menuButton = getChangesScope(page).locator('[data-testid="changes-overflow-menu"]:visible').first();
+  await expect(menuButton).toBeVisible();
+  await menuButton.click();
+}
+
+async function openChangesPrimaryMenu(page: Page) {
+  const scope = getChangesScope(page);
+  const caret = scope.getByTestId('changes-primary-cta-caret').first();
+  await expect(caret).toBeVisible();
+  await caret.click();
+  // Menu content is rendered via a portal, so don't scope it to the explorer content area.
+  await expect(page.getByTestId('changes-primary-cta-menu')).toBeVisible();
+}
+
+async function openChangesPanel(page: Page, options?: { expectGit?: boolean }) {
+  const changesHeader = getChangesHeader(page);
+  if (!(await changesHeader.isVisible())) {
+    const explorerHeader = page.getByTestId('explorer-header');
+    if (await explorerHeader.isVisible()) {
+      const changesTab = explorerHeader.getByText('Changes', { exact: true });
+      if (await changesTab.isVisible().catch(() => false)) {
+        await changesTab.click();
+      } else {
+        const overflowMenu = page.getByTestId('agent-overflow-menu').first();
+        await expect(overflowMenu).toBeVisible({ timeout: 10000 });
+        await overflowMenu.click();
+        await page.getByText(/view changes/i).first().click();
+      }
+    } else {
+      const overflowMenu = page.getByTestId('agent-overflow-menu').first();
+      await expect(overflowMenu).toBeVisible({ timeout: 10000 });
+      await overflowMenu.click();
+      await page.getByText(/view changes/i).first().click();
+    }
+  }
+  await expect(changesHeader).toBeVisible({ timeout: 30000 });
+  if (options?.expectGit === false) {
+    return;
+  }
+  const changesScope = getChangesScope(page);
+  await expect(changesScope.getByTestId('changes-not-git')).toHaveCount(0, {
+    timeout: 30000,
+  });
+  await expect(changesScope.getByTestId('changes-branch')).not.toHaveText('Not a git repository', {
+    timeout: 30000,
+  });
+}
+
+async function sendPrompt(page: Page, prompt: string) {
+  const input = page.getByRole('textbox', { name: 'Message agent...' });
+  await expect(input).toBeEditable();
+  await input.fill(prompt);
+  await input.press('Enter');
+}
+
+async function waitForAssistantText(page: Page, text: string) {
+  const assistantMessage = page.getByTestId('assistant-message').filter({ hasText: text }).last();
+  await expect(assistantMessage).toBeVisible({ timeout: 60000 });
+  return assistantMessage;
+}
+
+async function createAgentAndWait(page: Page, message: string) {
+  const input = page.getByRole('textbox', { name: 'Message agent...' });
+  await expect(input).toBeEditable();
+  await input.fill(message);
+  await input.press('Enter');
+  await expect(page).toHaveURL(/\/agent\//, { timeout: 120000 });
+  await expect(page.getByText(message, { exact: true })).toBeVisible();
+}
+
+async function requestCwd(page: Page) {
+  await sendPrompt(page, 'Run `pwd` and respond with exactly: CWD: <path>');
+  const message = await waitForAssistantText(page, 'CWD:');
+  // The assistant streams tokens; make sure we capture the full path (not a partial prefix).
+  await expect.poll(async () => (await message.textContent()) ?? '', { timeout: 60000 }).toContain('/worktrees/');
+  const content = (await message.textContent()) ?? '';
+  const match = content.match(/CWD:\s*(\S+)/);
+  if (!match) {
+    throw new Error(`Expected agent to respond with "CWD: <path>", got: ${content}`);
+  }
+  return match[1].trim();
+}
+
+async function selectAttachWorktree(page: Page, branchName: string) {
+  await page.getByTestId('worktree-attach-toggle').click();
+  const picker = page.getByTestId('worktree-attach-picker');
+  await expect(picker).toBeVisible();
+
+  // Wait a bit for the worktree list to load
+  await page.waitForTimeout(1000);
+
+  await picker.click();
+
+  // Wait a bit for animation
+  await page.waitForTimeout(500);
+
+  const sheet = page.getByLabel('Bottom Sheet', { exact: true });
+  const backdrop = page.getByRole('button', { name: 'Bottom sheet backdrop' }).first();
+
+  await expect.poll(async () => {
+    const sheetVisible = await sheet.isVisible().catch(() => false);
+    const backdropVisible = await backdrop.isVisible().catch(() => false);
+    // Also check if branch name is visible directly
+    const branchVisible = await page.getByText(branchName, { exact: true }).first().isVisible().catch(() => false);
+    return sheetVisible || backdropVisible || branchVisible;
+  }, { timeout: 10000 }).toBeTruthy();
+  const sheetVisible = await sheet.isVisible().catch(() => false);
+  const scope = sheetVisible ? sheet : page;
+  const preferredOption = scope.getByText(branchName, { exact: true }).first();
+  if (await preferredOption.isVisible().catch(() => false)) {
+    await preferredOption.click();
+    await expect(picker).toContainText(branchName);
+    return;
+  }
+
+  const options = scope.locator('[data-testid^="worktree-attach-option-"]');
+  const optionCount = await options.count();
+  if (optionCount === 0) {
+    throw new Error(`No worktree options were available in the attach picker`);
+  }
+  const fallbackOption = options.first();
+  const fallbackLabel = ((await fallbackOption.innerText()) ?? "").trim();
+  await fallbackOption.click();
+  if (fallbackLabel.length > 0) {
+    await expect(picker).toContainText(fallbackLabel);
+  }
+}
+
+async function enableCreateWorktree(page: Page) {
+  const createToggle = page.getByTestId('worktree-create-toggle');
+  const willCreateLabel = page.getByText(/Will create:/);
+  if (await willCreateLabel.isVisible()) {
+    return;
+  }
+  const readyLabel = page.getByText(
+    /Run isolated from|Run in an isolated directory/
+  );
+  await expect(readyLabel).toBeVisible({ timeout: 30000 });
+  await createToggle.click({ force: true });
+  await expect(willCreateLabel).toBeVisible({ timeout: 30000 });
+}
+
+async function refreshUncommittedMode(page: Page) {
+  await selectChangesView(page, 'base');
+  await selectChangesView(page, 'working');
+}
+
+async function refreshChangesTab(page: Page) {
+  const header = page.locator('[data-testid="explorer-header"]:visible').first();
+  await header.getByText('Files', { exact: true }).first().click();
+  await header.getByText('Changes', { exact: true }).first().click();
+}
+
+function normalizeTmpPath(value: string) {
+  if (value.startsWith('/var/')) {
+    return `/private${value}`;
+  }
+  return value;
+}
+
+test('checkout-first Changes panel ship loop', async ({ page }) => {
+  const repo = await createTempGitRepo('paseo-e2e-', { withRemote: true });
+  const nonGitDir = await mkdtemp(path.join(tmpdir(), 'paseo-e2e-non-git-'));
+
+  try {
+    await gotoHome(page);
+    await setWorkingDirectory(page, repo.path);
+    await ensureHostSelected(page);
+
+    await enableCreateWorktree(page);
+    await createAgentAndWait(page, 'Respond with exactly: READY');
+    await waitForAssistantText(page, 'READY');
+
+    await openChangesPanel(page);
+    const branchLabelLocator = getChangesScope(page).getByTestId('changes-branch');
+    await expect
+      .poll(async () => (await branchLabelLocator.innerText()).trim(), { timeout: 30000 })
+      .not.toBe('Unknown');
+    const branchNameFromUi = (await branchLabelLocator.innerText()).trim();
+    expect(branchNameFromUi.length).toBeGreaterThan(0);
+
+    const firstCwd = await requestCwd(page);
+    const worktreeBranch = execSync('git rev-parse --abbrev-ref HEAD', {
+      cwd: firstCwd,
+      encoding: 'utf8',
+    }).trim();
+    expect(worktreeBranch.length).toBeGreaterThan(0);
+    const [resolvedCwd, resolvedRepo] = await Promise.all([
+      realpath(firstCwd).catch(() => firstCwd),
+      realpath(repo.path).catch(() => repo.path),
+    ]);
+    const normalizedRepo = normalizeTmpPath(resolvedRepo);
+    const normalizedCwd = normalizeTmpPath(resolvedCwd);
+    const expectedMarker = `${path.sep}worktrees${path.sep}`;
+    expect(normalizedCwd.includes(expectedMarker)).toBeTruthy();
+
+    await page.getByTestId('sidebar-new-agent').click();
+    await expect(page).toHaveURL(/\/agent\/?$/);
+
+    await setWorkingDirectory(page, repo.path);
+    await ensureHostSelected(page);
+    await selectAttachWorktree(page, worktreeBranch);
+    await createAgentAndWait(page, 'Respond with exactly: READY2');
+    await waitForAssistantText(page, 'READY2');
+
+    const secondCwd = await requestCwd(page);
+    expect(secondCwd).toBe(firstCwd);
+
+    await sendPrompt(page, "Respond with exactly: OK");
+    await waitForAssistantText(page, "OK");
+
+    const readmePath = path.join(firstCwd, 'README.md');
+    await appendFile(readmePath, '\nFirst change\n');
+
+    await refreshUncommittedMode(page);
+    await expect(getChangesScope(page).getByText('README.md', { exact: true })).toBeVisible({
+      timeout: 30000,
+    });
+    await getChangesScope(page).getByTestId('diff-file-0-toggle').first().click();
+    await expect(page.getByText('First change')).toBeVisible();
+    const primaryCta = getChangesScope(page).getByTestId('changes-primary-cta').first();
+    await expect(primaryCta).toBeVisible();
+    await expect(primaryCta).toContainText('Commit');
+
+    await primaryCta.click();
+    await expect
+      .poll(() => {
+        try {
+          return execSync('git status --porcelain', {
+            cwd: firstCwd,
+            encoding: 'utf8',
+            env: { ...process.env, GIT_OPTIONAL_LOCKS: '0' },
+          }).trim();
+        } catch {
+          return null;
+        }
+      }, { timeout: 30000 })
+      .toBe('');
+    await openChangesPanel(page);
+    await selectChangesView(page, 'working');
+    await expect(getChangesScope(page).getByText('No uncommitted changes')).toBeVisible({
+      timeout: 30000,
+    });
+    await expect(getChangesScope(page).getByTestId('changes-primary-cta')).not.toContainText('Commit');
+
+    await selectChangesView(page, 'base');
+    await expect(getChangesScope(page).getByText('README.md', { exact: true })).toBeVisible({
+      timeout: 30000,
+    });
+
+    // Push once from the menu so the branch has an origin/<branch> ref.
+    await openChangesPrimaryMenu(page);
+    await page.getByTestId('changes-menu-push').click();
+    await expect
+      .poll(() => {
+        try {
+          execSync(`git show-ref --verify --quiet refs/remotes/origin/${worktreeBranch}`, { cwd: firstCwd });
+          return true;
+        } catch {
+          return false;
+        }
+      }, { timeout: 30000 })
+      .toBe(true);
+
+    const notesPath = path.join(firstCwd, 'notes.txt');
+    await writeFile(notesPath, 'Second change\n');
+
+    await refreshUncommittedMode(page);
+    await refreshChangesTab(page);
+    await expect(getChangesScope(page).getByText('notes.txt', { exact: true })).toBeVisible({
+      timeout: 30000,
+    });
+    await expect(getChangesScope(page).getByText('README.md', { exact: true })).toHaveCount(0);
+    await expect(getChangesScope(page).getByTestId('changes-primary-cta')).toContainText('Commit');
+
+    await selectChangesView(page, 'base');
+    await expect(getChangesScope(page).getByText('README.md', { exact: true })).toBeVisible({
+      timeout: 30000,
+    });
+
+    await getChangesScope(page).getByTestId('changes-primary-cta').click();
+    await expect
+      .poll(() => {
+        try {
+          return execSync('git status --porcelain', {
+            cwd: firstCwd,
+            encoding: 'utf8',
+            env: { ...process.env, GIT_OPTIONAL_LOCKS: '0' },
+          }).trim();
+        } catch {
+          return null;
+        }
+      }, { timeout: 30000 })
+      .toBe('');
+    await openChangesPanel(page);
+    await selectChangesView(page, 'working');
+    await expect(getChangesScope(page).getByText('No uncommitted changes')).toBeVisible({ timeout: 30000 });
+    await expect(getChangesScope(page).getByTestId('changes-primary-cta')).not.toContainText('Commit');
+
+    await selectChangesView(page, 'base');
+    await expect(getChangesScope(page).getByText('README.md', { exact: true })).toBeVisible({
+      timeout: 30000,
+    });
+    await expect(getChangesScope(page).getByText('notes.txt', { exact: true })).toBeVisible({
+      timeout: 30000,
+    });
+
+    // Push is now the primary action (origin/<branch> exists and we're ahead of it).
+    const pushPrimary = getChangesScope(page).getByTestId('changes-primary-cta').first();
+    await expect(pushPrimary).toContainText(/push/i, { timeout: 30000 });
+    await pushPrimary.click();
+    // Regression check: the primary CTA stays in place while pushing.
+    await expect(pushPrimary).toBeVisible();
+    await page.waitForTimeout(50);
+    await expect(pushPrimary).toBeVisible();
+
+    await expect
+      .poll(() => {
+        try {
+          const count = execSync(
+            `git rev-list --count origin/${worktreeBranch}..${worktreeBranch}`,
+            { cwd: firstCwd, encoding: 'utf8' }
+          ).trim();
+          return Number.parseInt(count, 10);
+        } catch {
+          return null;
+        }
+      }, { timeout: 30000 })
+      .toBe(0);
+
+    // Merge to base in the main worktree (worktree branches can't always check out base refs in-place).
+    // This avoids UI flakiness around ship actions while still validating the diff panel end-to-end.
+    execSync("git checkout main", { cwd: repo.path });
+    execSync(`git -c commit.gpgsign=false merge --no-edit ${worktreeBranch}`, { cwd: repo.path });
+    execSync("git push", { cwd: repo.path });
+
+    await selectChangesView(page, 'base');
+    await expect(getChangesScope(page).getByText(/No changes vs/i)).toBeVisible({
+      timeout: 60000,
+    });
+    await refreshChangesTab(page);
+    await expect(getChangesScope(page).getByTestId('changes-primary-cta')).toHaveCount(0, { timeout: 30000 });
+
+    await openChangesOverflowMenu(page);
+    await expect(page.getByTestId('changes-menu-archive-worktree')).toBeVisible();
+    await page.getByTestId('changes-menu-archive-worktree').click();
+    // Archiving a worktree deletes agents and redirects to home
+    await expect(page).toHaveURL(/\/agent\/?$/, { timeout: 30000 });
+    await setWorkingDirectory(page, repo.path);
+    await ensureHostSelected(page);
+    // Repo inspection is async; wait until git options are interactive again.
+    await expect(page.getByText('Inspecting repository…')).toHaveCount(0, { timeout: 30000 });
+    await page.getByTestId('worktree-attach-toggle').click();
+    await expect(page.getByTestId('worktree-attach-picker')).toBeVisible({ timeout: 30000 });
+    await page.getByTestId('worktree-attach-picker').click();
+    await expect(page.getByText(worktreeBranch, { exact: true })).toHaveCount(0);
+    const attachSheet = page.getByLabel('Bottom Sheet', { exact: true });
+    if (await attachSheet.isVisible().catch(() => false)) {
+      await page.getByTestId('dropdown-sheet-close').click({ force: true });
+      await expect(attachSheet).toBeHidden({ timeout: 30000 });
+    }
+    await page.getByTestId('worktree-attach-toggle').click();
+    await expect(page.getByTestId('worktree-attach-picker')).toBeHidden({ timeout: 30000 });
+
+    await setWorkingDirectory(page, nonGitDir);
+    // Wait for git options to disappear (repo inspection is async and the git section can briefly render stale UI).
+    await expect(page.getByTestId('worktree-attach-toggle')).toHaveCount(0, { timeout: 30000 });
+    await expect(page.getByTestId('worktree-attach-picker')).toHaveCount(0);
+    await createAgentAndWait(page, 'Respond with exactly: NON-GIT');
+    await waitForAssistantText(page, 'NON-GIT');
+    await openChangesPanel(page, { expectGit: false });
+    await expect(getChangesScope(page).getByTestId('changes-not-git')).toBeVisible();
+    await expect(getChangesScope(page).getByTestId('changes-primary-cta')).toHaveCount(0);
+    await expect(getChangesScope(page).getByTestId('changes-overflow-menu')).toHaveCount(0);
+  } finally {
+    await rm(nonGitDir, { recursive: true, force: true });
+    await repo.cleanup();
+  }
+});

packages/app/e2e/create-agent.spec.ts

@@ -0,0 +1,29 @@
+import { test, expect } from './fixtures';
+import { createAgent, ensureHostSelected, gotoHome, setWorkingDirectory } from './helpers/app';
+import { createTempGitRepo } from './helpers/workspace';
+
+test('create agent in a temp repo', async ({ page }) => {
+  const repo = await createTempGitRepo();
+  const prompt = "Respond with exactly: Hello";
+
+  try {
+    await gotoHome(page);
+    await setWorkingDirectory(page, repo.path);
+    await ensureHostSelected(page);
+    await createAgent(page, prompt);
+
+    // Verify user message is shown in the stream
+    await expect(page.getByText(prompt, { exact: true })).toBeVisible();
+
+    // Verify we used a fast model (do not fall back to a default like Sonnet).
+    await page.getByTestId('agent-overflow-menu').click();
+    await expect(page.getByText('Model', { exact: true })).toBeVisible();
+    await expect(page.getByTestId('agent-overflow-content').getByText(/haiku/i)).toBeVisible();
+
+    // Wait for agent response containing "Hello" within an assistant message
+    const assistantMessage = page.getByTestId('assistant-message').filter({ hasText: 'Hello' });
+    await expect(assistantMessage).toBeVisible({ timeout: 30000 });
+  } finally {
+    await repo.cleanup();
+  }
+});

packages/app/e2e/daemon-connectivity.spec.ts

@@ -0,0 +1,19 @@
+import { test, expect } from './fixtures';
+import { gotoHome, openSettings } from './helpers/app';
+
+test('daemon is connected in settings', async ({ page }) => {
+  const daemonPort = process.env.E2E_DAEMON_PORT;
+  const serverId = process.env.E2E_SERVER_ID;
+  if (!daemonPort) {
+    throw new Error('E2E_DAEMON_PORT is not set (expected from globalSetup).');
+  }
+  if (!serverId) {
+    throw new Error('E2E_SERVER_ID is not set (expected from globalSetup).');
+  }
+
+  await gotoHome(page);
+  await openSettings(page);
+
+  await expect(page.getByText(`127.0.0.1:${daemonPort}`)).toBeVisible();
+  await expect(page.getByTestId(`daemon-card-${serverId}`).getByText('Online', { exact: true })).toBeVisible();
+});

packages/app/e2e/delete-agent-persists.spec.ts

@@ -0,0 +1,55 @@
+import { test, expect } from './fixtures';
+import { ensureHostSelected, gotoHome, setWorkingDirectory } from './helpers/app';
+import { createTempGitRepo } from './helpers/workspace';
+
+test('deleting an agent persists after reload', async ({ page }) => {
+  const repo = await createTempGitRepo();
+  const nonce = Math.random().toString(36).slice(2, 10);
+  const prompt = `respond-ready-${nonce}`;
+
+  try {
+    await gotoHome(page);
+    await setWorkingDirectory(page, repo.path);
+    await ensureHostSelected(page);
+
+    // Create agent (via message input) so it shows up in the sidebar list.
+    const input = page.getByRole('textbox', { name: 'Message agent...' });
+    await expect(input).toBeEditable();
+    await input.fill(prompt);
+    await input.press('Enter');
+    await page.waitForURL(/\/agent\//, { waitUntil: 'commit' });
+    // Wait for the initial turn to complete so the agent can be archived (web uses a hover action).
+    const stopOrCancel = page.getByRole('button', { name: /Stop agent|Canceling agent/ });
+    await stopOrCancel.first().waitFor({ state: 'visible', timeout: 30000 }).catch(() => undefined);
+    await expect(stopOrCancel).toHaveCount(0, { timeout: 120000 });
+
+    const match = page.url().match(/\/agent\/([^/]+)\/([^/?#]+)/);
+    if (!match) {
+      throw new Error(`Expected /agent/:serverId/:agentId URL, got ${page.url()}`);
+    }
+    const serverId = decodeURIComponent(match[1]);
+    const agentId = decodeURIComponent(match[2]);
+
+    // Return home and delete via long-press in the agent list.
+    await gotoHome(page);
+    const rowTestId = `agent-row-${serverId}-${agentId}`;
+    const agentRow = page.getByTestId(rowTestId).first();
+    await expect(agentRow).toBeVisible({ timeout: 30000 });
+
+    // Web UX: hover shows a quick-archive icon. (Long-press is touch-oriented and unreliable on desktop web.)
+    await agentRow.hover();
+    const quickArchive = page.getByTestId(`agent-archive-${serverId}-${agentId}`).first();
+    await expect(quickArchive).toBeVisible({ timeout: 10000 });
+    await quickArchive.click({ force: true });
+
+    // Ensure deletion finished before reload (avoids races).
+    await expect(page.getByTestId(rowTestId)).toHaveCount(0, { timeout: 30000 });
+
+    // A full reload should not bring the agent back.
+    await page.reload();
+    await expect(page.getByRole('textbox', { name: 'Message agent...' })).toBeVisible();
+    await expect(page.getByTestId(rowTestId)).toHaveCount(0, { timeout: 30000 });
+  } finally {
+    await repo.cleanup();
+  }
+});

packages/app/e2e/dictation-web.spec.ts

@@ -0,0 +1,227 @@
+import { test, expect } from './fixtures';
+import { createAgent, ensureHostSelected, gotoHome, setWorkingDirectory } from './helpers/app';
+import { createTempGitRepo } from './helpers/workspace';
+import type { Page } from '@playwright/test';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+
+async function addFakeMicrophone(page: Page) {
+  const fixturePath = path.resolve(__dirname, 'fixtures', 'recording.webm');
+  const base64Audio = (await readFile(fixturePath)).toString('base64');
+  const mimeType = 'audio/webm;codecs=opus';
+
+  return page.addInitScript(({ base64Audio, mimeType }) => {
+    const mic = {
+      active: 0,
+      getUserMediaCalls: 0,
+      stopCalls: 0,
+      lastRecorder: null as null | { state: string },
+    };
+    (window as any).__mic = mic;
+
+    (window as any).isSecureContext = true;
+
+    const nav = navigator as any;
+    if (!nav.mediaDevices) {
+      nav.mediaDevices = {};
+    }
+    nav.mediaDevices.getUserMedia = async () => {
+      mic.getUserMediaCalls += 1;
+      mic.active += 1;
+      const track = {
+        stop: () => {
+          mic.stopCalls += 1;
+          mic.active = Math.max(0, mic.active - 1);
+        },
+      };
+      return {
+        getTracks: () => [track],
+      };
+    };
+
+    const blobFromBase64 = (base64: string, mimeType: string): Blob => {
+      const binaryString = atob(base64);
+      const bytes = new Uint8Array(binaryString.length);
+      for (let i = 0; i < binaryString.length; i++) {
+        bytes[i] = binaryString.charCodeAt(i);
+      }
+      return new Blob([bytes], { type: mimeType });
+    };
+
+    class FakeMediaRecorder extends EventTarget {
+      public static isTypeSupported() {
+        return true;
+      }
+
+      public state: 'inactive' | 'recording' = 'inactive';
+      public mimeType: string;
+      public ondataavailable: ((event: { data: Blob }) => void) | null = null;
+      public onerror: ((event: unknown) => void) | null = null;
+
+      constructor(_stream: unknown, options?: MediaRecorderOptions) {
+        super();
+        this.mimeType = options?.mimeType ?? 'audio/webm';
+        mic.lastRecorder = this;
+      }
+
+      public start() {
+        this.state = 'recording';
+      }
+
+      public stop() {
+        if (this.state !== 'recording') {
+          throw new Error('Not recording');
+        }
+        this.state = 'inactive';
+        try {
+          this.ondataavailable?.({
+            data: blobFromBase64(base64Audio, mimeType),
+          });
+        } catch (err) {
+          this.onerror?.(err);
+        }
+        this.dispatchEvent(new Event('stop'));
+      }
+    }
+
+    (window as any).MediaRecorder = FakeMediaRecorder;
+  }, { base64Audio, mimeType });
+}
+
+test('dictation hotkeys do not trigger on background screens', async ({ page }) => {
+  await addFakeMicrophone(page);
+
+  const repo = await createTempGitRepo();
+  try {
+    await gotoHome(page);
+    await ensureHostSelected(page);
+    await setWorkingDirectory(page, repo.path);
+    await createAgent(page, 'Respond with exactly: Hello');
+
+    await expect(page).toHaveURL(/\/agent\//);
+    await expect(page.getByRole('textbox', { name: 'Message agent...' })).toBeEditable();
+
+    await page.keyboard.press('Control+d');
+    await page.waitForTimeout(200);
+
+    const calls = await page.evaluate(() => (window as any).__mic.getUserMediaCalls as number);
+    const active = await page.evaluate(() => (window as any).__mic.active as number);
+
+    expect(calls).toBe(1);
+    expect(active).toBe(1);
+
+    await page.keyboard.press('Escape');
+    await expect
+      .poll(async () => page.evaluate(() => (window as any).__mic.active as number))
+      .toBe(0);
+  } finally {
+    await repo.cleanup();
+  }
+});
+
+test('dictation transcribes fixture via real STT', async ({ page }) => {
+  await addFakeMicrophone(page);
+
+  const repo = await createTempGitRepo();
+  try {
+    await gotoHome(page);
+    await ensureHostSelected(page);
+    await setWorkingDirectory(page, repo.path);
+    await createAgent(page, 'Respond with exactly: Hello');
+
+    await expect(page).toHaveURL(/\/agent\//);
+    await expect(page.getByRole('textbox', { name: 'Message agent...' })).toBeEditable();
+
+    await page.keyboard.press('Control+d');
+    await expect
+      .poll(async () => page.evaluate(() => (window as any).__mic.active as number))
+      .toBe(1);
+
+    const initialCopyMessageCount = await page
+      .getByRole('button', { name: 'Copy message' })
+      .count();
+
+    await page.keyboard.press('Control+d');
+
+    await expect
+      .poll(
+        async () => page.getByRole('button', { name: 'Copy message' }).count(),
+        { timeout: 60_000 }
+      )
+      .toBeGreaterThan(initialCopyMessageCount);
+  } finally {
+    await repo.cleanup();
+  }
+});
+
+test('cancel stops mic even if recorder is already inactive', async ({ page }) => {
+  await addFakeMicrophone(page);
+
+  const repo = await createTempGitRepo();
+  try {
+    await gotoHome(page);
+    await ensureHostSelected(page);
+    await setWorkingDirectory(page, repo.path);
+    await createAgent(page, 'Respond with exactly: Hello');
+
+    await expect(page).toHaveURL(/\/agent\//);
+    await expect(page.getByRole('textbox', { name: 'Message agent...' })).toBeEditable();
+
+    await page.keyboard.press('Control+d');
+    await expect
+      .poll(async () => page.evaluate(() => (window as any).__mic.active as number))
+      .toBe(1);
+
+    await page.evaluate(() => {
+      const mic = (window as any).__mic as { lastRecorder: null | { state: string } };
+      if (mic.lastRecorder) {
+        mic.lastRecorder.state = 'inactive';
+      }
+    });
+
+    await page.keyboard.press('Escape');
+    await expect
+      .poll(async () => page.evaluate(() => (window as any).__mic.active as number))
+      .toBe(0);
+  } finally {
+    await repo.cleanup();
+  }
+});
+
+test('dictation confirm+send does not dispatch after navigating away', async ({ page }) => {
+  await addFakeMicrophone(page);
+
+  const repo = await createTempGitRepo();
+  try {
+    await gotoHome(page);
+    await setWorkingDirectory(page, repo.path);
+    await ensureHostSelected(page);
+    await createAgent(page, 'Respond with exactly: Hello');
+
+    await expect(page).toHaveURL(/\/agent($|\/)/);
+    await expect(page.getByRole('textbox', { name: 'Message agent...' })).toBeEditable();
+
+    await page.keyboard.press('Control+d');
+    await expect
+      .poll(async () => page.evaluate(() => (window as any).__mic.active as number))
+      .toBe(1);
+
+    await page.keyboard.press('Control+d');
+
+    const newAgentButton = page.getByTestId('sidebar-new-agent');
+    await expect(newAgentButton).toBeVisible();
+    await newAgentButton.click();
+    await expect(page).toHaveURL(/\/agent\/?$/);
+
+    await page.waitForTimeout(10_000);
+
+    const agentEntry = page.getByText(repo.path).first();
+    await expect(agentEntry).toBeVisible();
+    await agentEntry.click();
+    await expect(page).toHaveURL(/\/agent($|\/)/);
+
+    await expect(page.getByText(/voice note/i)).not.toBeVisible();
+  } finally {
+    await repo.cleanup();
+  }
+});

packages/app/e2e/fixtures.ts

@@ -0,0 +1,129 @@
+import { test as base, expect, type Page } from '@playwright/test';
+
+// Extend base test to provide dynamic baseURL from global-setup
+const test = base.extend({
+  baseURL: async ({}, use) => {
+    const metroPort = process.env.E2E_METRO_PORT;
+    if (!metroPort) {
+      throw new Error('E2E_METRO_PORT not set - globalSetup must run first');
+    }
+    await use(`http://localhost:${metroPort}`);
+  },
+});
+
+const consoleEntries = new WeakMap<Page, string[]>();
+
+test.beforeEach(async ({ page }) => {
+  const daemonPort = process.env.E2E_DAEMON_PORT;
+  const metroPort = process.env.E2E_METRO_PORT;
+  if (!daemonPort) {
+    throw new Error(
+      'E2E_DAEMON_PORT is not set. Refusing to run e2e against the default daemon (e.g. localhost:6767). ' +
+        'Ensure Playwright `globalSetup` starts the e2e daemon and exports E2E_DAEMON_PORT.'
+    );
+  }
+  if (daemonPort === '6767') {
+    throw new Error(
+      'E2E_DAEMON_PORT is 6767. Refusing to run e2e against the default local daemon. ' +
+        'Fix Playwright globalSetup to start an isolated test daemon and export its port.'
+    );
+  }
+  if (!metroPort) {
+    throw new Error(
+      'E2E_METRO_PORT is not set. Ensure Playwright `globalSetup` starts Metro and exports E2E_METRO_PORT.'
+    );
+  }
+
+  // Hard guardrail: never allow tests to hit the developer's default daemon.
+  // This blocks both HTTP and WS attempts to :6767 (before any navigation).
+  await page.route(/:(6767)\b/, (route) => route.abort());
+  await page.routeWebSocket(/:(6767)\b/, async (ws) => {
+    await ws.close({ code: 1008, reason: 'Blocked connection to localhost:6767 during e2e.' });
+  });
+
+  const entries: string[] = [];
+  consoleEntries.set(page, entries);
+
+  page.on('console', (message) => {
+    entries.push(`[console:${message.type()}] ${message.text()}`);
+  });
+
+  page.on('pageerror', (error) => {
+    entries.push(`[pageerror] ${error.message}`);
+  });
+
+  const nowIso = new Date().toISOString();
+  const seedNonce = Math.random().toString(36).slice(2);
+  const serverId = process.env.E2E_SERVER_ID;
+  if (!serverId) {
+    throw new Error('E2E_SERVER_ID is not set - expected from Playwright globalSetup.');
+  }
+  const testDaemon = {
+    serverId,
+    label: 'localhost',
+    connections: [
+      {
+        id: `direct:127.0.0.1:${daemonPort}`,
+        type: 'direct',
+        endpoint: `127.0.0.1:${daemonPort}`,
+      },
+    ],
+    preferredConnectionId: `direct:127.0.0.1:${daemonPort}`,
+    createdAt: nowIso,
+    updatedAt: nowIso,
+  };
+
+  const createAgentPreferences = {
+    // Ensure create flow never uses a remembered host from the developer's real app.
+    serverId: testDaemon.serverId,
+    // Keep e2e fast/cheap by default.
+    provider: 'claude',
+    providerPreferences: {
+      claude: { model: 'haiku' },
+      codex: { model: 'gpt-5.1-codex-mini' },
+    },
+  };
+
+  await page.addInitScript(
+    ({ daemon, preferences, seedNonce }) => {
+      // `addInitScript` runs on every navigation (including reloads). Some tests intentionally
+      // override storage and reload; they can opt out of seeding for the *next* navigation by
+      // setting this flag before the reload.
+      const disableOnceKey = '@paseo:e2e-disable-default-seed-once';
+      const disableValue = localStorage.getItem(disableOnceKey);
+      if (disableValue) {
+        localStorage.removeItem(disableOnceKey);
+        if (disableValue === seedNonce) {
+          return;
+        }
+      }
+
+      localStorage.setItem('@paseo:e2e', '1');
+      localStorage.setItem('@paseo:e2e-seed-nonce', seedNonce);
+
+      // Hard-reset anything that could point to a developer's real daemon.
+      localStorage.setItem('@paseo:daemon-registry', JSON.stringify([daemon]));
+      localStorage.removeItem('@paseo:settings');
+      localStorage.setItem('@paseo:create-agent-preferences', JSON.stringify(preferences));
+    },
+    { daemon: testDaemon, preferences: createAgentPreferences, seedNonce }
+  );
+});
+
+test.afterEach(async ({ page }, testInfo) => {
+  const entries = consoleEntries.get(page);
+  if (!entries || entries.length === 0) {
+    return;
+  }
+
+  if (testInfo.status === testInfo.expectedStatus) {
+    return;
+  }
+
+  await testInfo.attach('browser-console', {
+    body: entries.join('\n'),
+    contentType: 'text/plain',
+  });
+});
+
+export { test, expect, type Page };

packages/app/e2e/fixtures/recording.baseline.txt

@@ -0,0 +1,2 @@
+This is a voice note.
+

packages/app/e2e/git-diff-sticky-headers.spec.ts

@@ -0,0 +1,99 @@
+import path from 'node:path';
+import { appendFile } from 'node:fs/promises';
+import { test, expect, type Page } from './fixtures';
+import { ensureHostSelected, gotoHome, setWorkingDirectory } from './helpers/app';
+import { createTempGitRepo } from './helpers/workspace';
+
+test.describe.configure({ timeout: 90000 });
+
+function getChangesScope(page: Page) {
+  return page.locator('[data-testid="explorer-content-area"]:visible').first();
+}
+
+async function openChangesPanel(page: Page) {
+  const changesHeader = getChangesScope(page).getByTestId('changes-header');
+  if (!(await changesHeader.isVisible())) {
+    const explorerHeader = page.getByTestId('explorer-header');
+    if (await explorerHeader.isVisible()) {
+      await page.getByText('Changes', { exact: true }).click();
+    } else {
+      const overflowMenu = page.getByTestId('agent-overflow-menu').first();
+      await expect(overflowMenu).toBeVisible({ timeout: 10000 });
+      await overflowMenu.click();
+      await page.getByText('View Changes', { exact: true }).click();
+    }
+  }
+  await expect(changesHeader).toBeVisible();
+}
+
+async function refreshUncommittedMode(page: Page) {
+  const scope = getChangesScope(page);
+  const toggle = scope.getByTestId('changes-diff-status').first();
+  await expect(toggle).toBeVisible({ timeout: 30000 });
+
+  const currentLabel = (await toggle.innerText()).trim();
+  await toggle.click();
+  await expect.poll(async () => (await toggle.innerText()).trim()).not.toBe(currentLabel);
+
+  const nextLabel = (await toggle.innerText()).trim();
+  await toggle.click();
+  await expect.poll(async () => (await toggle.innerText()).trim()).not.toBe(nextLabel);
+}
+
+async function createAgentAndWait(page: Page, message: string) {
+  const input = page.getByRole('textbox', { name: 'Message agent...' });
+  await expect(input).toBeEditable();
+  await input.fill(message);
+  await input.press('Enter');
+  await expect(page).toHaveURL(/\/agent\//, { timeout: 120000 });
+  await expect(page.getByText(message, { exact: true })).toBeVisible();
+}
+
+test('keeps file header sticky while scrolling within a long diff', async ({ page }) => {
+  const repo = await createTempGitRepo('paseo-e2e-sticky-');
+
+  try {
+    await gotoHome(page);
+    await setWorkingDirectory(page, repo.path);
+    await ensureHostSelected(page);
+    await createAgentAndWait(page, 'Respond with exactly: READY');
+
+    await openChangesPanel(page);
+
+    const readmePath = path.join(repo.path, 'README.md');
+    const lines = Array.from({ length: 400 }, (_, idx) => `Sticky header line ${idx}\n`).join('');
+    await appendFile(readmePath, `\n${lines}`);
+
+    await refreshUncommittedMode(page);
+
+    const scope = getChangesScope(page);
+    await expect(scope.getByText('README.md', { exact: true })).toBeVisible({ timeout: 30000 });
+
+    const fileToggle = scope.getByTestId('diff-file-0-toggle').first();
+    await fileToggle.click();
+
+    const markerLine = scope.getByText('Sticky header line 250').first();
+    await expect(markerLine).toBeVisible({ timeout: 30000 });
+
+    const scroll = scope.getByTestId('git-diff-scroll').first();
+    await expect(scroll).toBeVisible();
+
+    await expect.poll(async () => {
+      return await scroll.evaluate((el) => (el.scrollHeight ?? 0) > (el.clientHeight ?? 0));
+    }).toBe(true);
+
+    await scroll.hover();
+    for (let i = 0; i < 12; i++) {
+      await page.mouse.wheel(0, 700);
+    }
+
+    await expect.poll(async () => {
+      return await scroll.evaluate((el) => el.scrollTop ?? 0);
+    }).toBeGreaterThan(0);
+
+    await expect(scope.getByText('Sticky header line 390').first()).toBeVisible({ timeout: 30000 });
+    await expect(fileToggle).toBeVisible();
+  } finally {
+    await repo.cleanup();
+  }
+});

packages/app/e2e/global-setup.ts

@@ -0,0 +1,246 @@
+import { spawn, type ChildProcess, execSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import net from 'node:net';
+import { Buffer } from 'node:buffer';
+import dotenv from 'dotenv';
+
+async function getAvailablePort(): Promise<number> {
+  return new Promise((resolve, reject) => {
+    const server = net.createServer();
+    server.once('error', reject);
+    server.listen(0, () => {
+      const address = server.address();
+      if (!address || typeof address === 'string') {
+        server.close(() => reject(new Error('Failed to acquire port')));
+        return;
+      }
+      server.close(() => resolve(address.port));
+    });
+  });
+}
+
+async function waitForServer(port: number, timeout = 15000): Promise<void> {
+  const start = Date.now();
+  while (Date.now() - start < timeout) {
+    try {
+      await new Promise<void>((resolve, reject) => {
+        const socket = net.connect(port, 'localhost', () => {
+          socket.end();
+          resolve();
+        });
+        socket.on('error', reject);
+      });
+      return;
+    } catch {
+      await new Promise((r) => setTimeout(r, 100));
+    }
+  }
+  throw new Error(`Server did not start on port ${port} within ${timeout}ms`);
+}
+
+let daemonProcess: ChildProcess | null = null;
+let metroProcess: ChildProcess | null = null;
+let paseoHome: string | null = null;
+let relayProcess: ChildProcess | null = null;
+
+type OfferPayload = {
+  v: 2;
+  serverId: string;
+  daemonPublicKeyB64: string;
+  relay: { endpoint: string };
+};
+
+function stripAnsi(input: string): string {
+  return input.replace(/\u001b\[[0-9;]*m/g, '');
+}
+
+function decodeOfferFromFragmentUrl(url: string): OfferPayload {
+  const marker = '#offer=';
+  const idx = url.indexOf(marker);
+  if (idx === -1) {
+    throw new Error(`missing ${marker} fragment: ${url}`);
+  }
+  const encoded = url.slice(idx + marker.length);
+  const json = Buffer.from(encoded, 'base64url').toString('utf8');
+  const offer = JSON.parse(json) as Partial<OfferPayload>;
+  if (offer.v !== 2) throw new Error('offer.v missing/invalid');
+  if (!offer.serverId) throw new Error('offer.serverId missing');
+  if (!offer.daemonPublicKeyB64) throw new Error('offer.daemonPublicKeyB64 missing');
+  if (!offer.relay?.endpoint) throw new Error('offer.relay.endpoint missing');
+  return offer as OfferPayload;
+}
+
+export default async function globalSetup() {
+  const repoRoot = path.resolve(__dirname, '../../..');
+  const envTestPath = path.join(repoRoot, '.env.test');
+  if (existsSync(envTestPath)) {
+    dotenv.config({ path: envTestPath });
+  }
+
+  const port = await getAvailablePort();
+  const relayPort = await getAvailablePort();
+  const metroPort = await getAvailablePort();
+  paseoHome = await mkdtemp(path.join(tmpdir(), 'paseo-e2e-home-'));
+
+  const relayDir = path.resolve(__dirname, '..', '..', 'relay');
+  relayProcess = spawn(
+    'npx',
+    ['wrangler', 'dev', '--local', '--ip', '127.0.0.1', '--port', String(relayPort)],
+    {
+      cwd: relayDir,
+      env: { ...process.env },
+      stdio: ['ignore', 'pipe', 'pipe'],
+      detached: false,
+    }
+  );
+
+  relayProcess.stdout?.on('data', (data: Buffer) => {
+    const lines = data.toString().split('\n').filter((l) => l.trim());
+    for (const line of lines) {
+      console.log(`[relay] ${line}`);
+    }
+  });
+  relayProcess.stderr?.on('data', (data: Buffer) => {
+    const lines = data.toString().split('\n').filter((l) => l.trim());
+    for (const line of lines) {
+      console.error(`[relay] ${line}`);
+    }
+  });
+
+  await waitForServer(relayPort, 30000);
+
+  // Start Metro bundler on dynamic port
+  const appDir = path.resolve(__dirname, '..');
+  metroProcess = spawn('npx', ['expo', 'start', '--web', '--port', String(metroPort)], {
+    cwd: appDir,
+    env: {
+      ...process.env,
+      BROWSER: 'none', // Don't auto-open browser
+    },
+    stdio: ['ignore', 'pipe', 'pipe'],
+    detached: false,
+  });
+
+  metroProcess.stdout?.on('data', (data: Buffer) => {
+    const lines = data.toString().split('\n').filter((l) => l.trim());
+    for (const line of lines) {
+      console.log(`[metro] ${line}`);
+    }
+  });
+
+  metroProcess.stderr?.on('data', (data: Buffer) => {
+    console.error(`[metro] ${data.toString().trim()}`);
+  });
+
+  const serverDir = path.resolve(__dirname, '../../..', 'packages/server');
+  const tsxBin = execSync('which tsx').toString().trim();
+
+  let offerPayload: OfferPayload | null = null;
+  let offerResolve: (() => void) | null = null;
+  const offerPromise = new Promise<void>((resolve) => {
+    offerResolve = resolve;
+  });
+
+  daemonProcess = spawn(tsxBin, ['src/server/index.ts'], {
+    cwd: serverDir,
+    env: {
+      ...process.env,
+      PASEO_HOME: paseoHome,
+      PASEO_SERVER_ID: 'srv_e2e_test_daemon',
+      PASEO_LISTEN: `0.0.0.0:${port}`,
+      PASEO_RELAY_ENDPOINT: `127.0.0.1:${relayPort}`,
+      PASEO_CORS_ORIGINS: `http://localhost:${metroPort}`,
+      // Keep e2e bootstrap fast and deterministic; terminal/sidebar tests do not need speech.
+      PASEO_DICTATION_ENABLED: "0",
+      PASEO_VOICE_MODE_ENABLED: "0",
+      PASEO_LOCAL_AUTO_DOWNLOAD: "0",
+      NODE_ENV: 'development',
+    },
+    stdio: ['ignore', 'pipe', 'pipe'],
+    detached: false,
+  });
+
+  let stdoutBuffer = '';
+  daemonProcess.stdout?.on('data', (data: Buffer) => {
+    stdoutBuffer += data.toString('utf8');
+    const lines = stdoutBuffer.split('\n');
+    stdoutBuffer = lines.pop() ?? '';
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      if (!offerPayload) {
+        const clean = stripAnsi(trimmed);
+        try {
+          const obj = JSON.parse(clean) as { msg?: string; url?: string };
+          if (obj.msg === 'pairing_offer' && typeof obj.url === 'string') {
+            offerPayload = decodeOfferFromFragmentUrl(obj.url);
+            offerResolve?.();
+          }
+        } catch {
+          const match = clean.match(/https?:\/\/[^\s"]+#offer=[A-Za-z0-9_-]+/);
+          if (match && clean.includes('pairing_offer')) {
+            try {
+              offerPayload = decodeOfferFromFragmentUrl(match[0]);
+              offerResolve?.();
+            } catch {
+              // ignore parsing failures
+            }
+          }
+        }
+      }
+      console.log(`[daemon] ${trimmed}`);
+    }
+  });
+
+  daemonProcess.stderr?.on('data', (data: Buffer) => {
+    console.error(`[daemon] ${data.toString().trim()}`);
+  });
+
+  // Wait for both daemon and Metro to be ready
+  await Promise.all([
+    waitForServer(port),
+    waitForServer(metroPort, 120000), // Metro can take longer to start
+  ]);
+
+  // Wait for daemon to emit a pairing offer (includes relay session ID).
+  await Promise.race([
+    offerPromise,
+    new Promise((_, reject) =>
+      setTimeout(() => reject(new Error('Timed out waiting for pairing_offer log')), 15000)
+    ),
+  ]);
+  if (!offerPayload) {
+    throw new Error('pairing_offer was not parsed from daemon logs');
+  }
+  const offer = offerPayload as OfferPayload;
+
+  process.env.E2E_DAEMON_PORT = String(port);
+  process.env.E2E_RELAY_PORT = String(relayPort);
+  process.env.E2E_SERVER_ID = offer.serverId;
+  process.env.E2E_RELAY_DAEMON_PUBLIC_KEY = offer.daemonPublicKeyB64;
+  process.env.E2E_METRO_PORT = String(metroPort);
+  console.log(`[e2e] Test daemon started on port ${port}, Metro on port ${metroPort}, home: ${paseoHome}`);
+
+  return async () => {
+    if (daemonProcess) {
+      daemonProcess.kill('SIGTERM');
+      daemonProcess = null;
+    }
+    if (metroProcess) {
+      metroProcess.kill('SIGTERM');
+      metroProcess = null;
+    }
+    if (relayProcess) {
+      relayProcess.kill('SIGTERM');
+      relayProcess = null;
+    }
+    if (paseoHome) {
+      await rm(paseoHome, { recursive: true, force: true });
+      paseoHome = null;
+    }
+    console.log('[e2e] Test daemon stopped');
+  };
+}