Sign in

Search⌘K

Getting Started

OverviewInstallationQuick StartFirst TestPlansFAQ

Personal

Preview uploads & sharingApp Store screenshots

CI & GitHub

GitHub PR PreviewsTests in CITest Results

Cloud (beta)

OverviewJS ClientLimits & Pricing

Testing

OverviewMaestro SuitesDetox SuitesPlain-Language Tests

Guides

ConfigurationWrap Existing AppReporting IssuesTroubleshootingMCP

Agents

SetupCLI UseAgent Devtool (Inspect)

REST API

OverviewAuthenticationPreviewsBuildsTest RunsCloud SessionsBilling & LimitsRate LimitsErrors

API

ConfigSettingsMetro PluginOne PluginAgent SkillsTest BridgeDetox DriverMaestro Driver

Compatibility

OverviewCustom Stubs

[ Documentation ]

peach shell

peach shell

Top-level shell controls for app launch, home/switcher transitions, and simulator-owned chrome such as appearance and lock state.

terminal

peach shell launch <appId> [waitMs] [--clear-state]
peach shell home [waitMs]
peach shell switcher [waitMs]
peach shell open-card <appId> [waitMs]
peach shell appearance <light|dark|auto|toggle>
peach shell lock
peach shell shake

Examples

terminal

peach shell launch photos
peach shell home
peach shell switcher 800
peach shell appearance dark
peach shell lock

+
do
+
debug

previous

wait

next

mode