[ Documentation ]
peach desktop

peach desktop

Launch the optional desktop companion from the standalone CLI, or install it when missing. Profiles map to Electron partitions, so cookies and app storage stay isolated per profile.

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

Options

flagdescription
--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
--ephemerallaunch with a temporary isolated storage profile
-y, --yesfor install: skip confirmation and install immediately
--forcefor install: reinstall even if the companion is present

Examples

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

Desktop Companion Role

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

  • +
    a tray or login-item style workflow
  • +
    a window that stays inspectable over the same bridge host
  • +
    an installed local companion that peach open can prefer automatically

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