Pepper

Capture and read app console output — both print() (stdout) and os_log/NSLog (stderr). Start, then log to read. System framework noise is filtered by default. Tip: use `timeline(last_seconds=30)` to see console events correlated with network and screen transitions.

Interact with dialogs. For system permission prompts (notifications, location, photos, etc.) ALWAYS use action='dismiss_system' — these are SpringBoard dialogs that 'dismiss' and 'tap' cannot reach. 'dismiss' with button= only works for in-app UIAlertControllers.

Flip a switch or change a segmented control by accessibility ID. Prefer over tap for switches. Shows screen state after.

Primary observation tool — returns all interactive elements with tap commands, plus visible text. Call before acting to know what's available.

Use this to interact with a button, link, or any tappable element on screen. Resolves the element by text label, icon_name, heuristic, or coordinate, then synthesizes a real touch via HID. Specify exactly one targeting method. Shows screen state after.

Use this to browse content that extends beyond the visible screen area. Scrolls by direction and amount via touch synthesis, or pass target to scroll until specific text is visible. Use parent_of to scroll a nested container (e.g. a horizontal list inside a vertical page). Shows screen state after.

Enter or replace text in a field. Focuses the field and types in one step — don't tap first. Shows screen state after.

Jump to a specific screen via deeplink or switch tabs. Use list_deeplinks=true to see available destinations. Shows screen state after.

Go back one screen in a navigation stack. For modals/sheets use dismiss; for jumping to a screen use navigate.

Close a modal, sheet, popover, or overlay. For navigation stack screens use back; for system dialogs use dialog.

Use this for quick flick gestures — swiping between pages, dismissing cards, or pull-to-refresh. Synthesizes a fast directional flick via HID. For slow content browsing, use scroll instead. Shows screen state after.

Identify which screen is currently displayed. Returns screen name and view controller class — no element data.

Dismiss the on-screen keyboard. Call after input_text when you need to tap elements the keyboard covers.

Save a named baseline of screen state and compare later. Use snapshot for named baselines you want to compare later or assert on with assert_no_diff.

Record the simulator screen as mp4 or GIF. Start, interact, then stop with an output path.

Record, replay, and manage action sequences.

Send a raw dylib command. NOT a code evaluator. Send cmd='help' to list valid commands. Prefer dedicated tools; use this for commands without one (batch, deeplinks, identify_selected, identify_icons, memory, scroll_to, watch, unwatch).

Control the iOS Simulator environment via simctl — permissions, GPS, biometrics, installed apps, and device lifecycle.

Check or change ViewModel @Published properties at runtime — no rebuild needed.

Check Pepper connection health — MCP server version, bundle ID, app version, port, connections, current screen. Add memory=true for process memory stats.

Use this for multi-touch gestures like pinch-to-zoom or two-finger rotation on maps, images, or zoomable views. Synthesizes two-finger touch events via HID injection. Shows screen state after.

Build the iOS app for a physical device connected via USB/WiFi. Not for simulators — use app_build instead.

Build, install, and launch the app with Pepper injected. Returns screen state. Pass build_only=True to compile without deploying.