peach desktop

Launch or install the native app on macOS arm64 and Linux x64, or Electron on Windows. Profiles keep cookies and app storage isolated.

terminal

peach desktop [--port <number>] [--profile <id>]
peach desktop install [options]
peach desktop uninstall

Options

flag	description
`--port <number>`	open a local app server through the peach shell, for example Metro on 8081
`--profile <id>`	launch with an isolated persistent storage profile
`--ephemeral`	launch with a temporary isolated storage profile
`-y, --yes`	for install: skip confirmation and install immediately
`--force`	for install: reinstall even if the companion is present
`--electron`	launch or install Electron on Windows; use the native app on Mac and Linux
`--native`	launch or install the native desktop host (default app on macOS arm64; on Linux x64 installs the headless host that headless `peach open` draws through, see Tests in CI)
`--channel <name>`	for install —native: production (default) or staging

terminal

peach desktop
peach desktop --port 8081
peach desktop --profile qa
peach desktop install --yes
peach desktop install --native --yes

The desktop companion is the persistent local host option. It is the right fit when you want:

The CLI command here is intentionally thin. Its job is to find or install the companion and launch it with the right URL.

support

daemon