Pepper FAQs

Question 1

What is Pepper and its primary use?

Accepted Answer

Pepper is a tool that empowers AI agents to dynamically interact with and inspect iOS Simulator apps. It allows agents to 'see' the screen, perform user actions, and debug app states without requiring any source code changes or a build step.

Question 2

What kind of debugging and inspection capabilities does Pepper offer?

Accepted Answer

Pepper allows for deep inspection and mutation of live runtime objects, Core Data stores, UserDefaults, and other application states. It can also capture console output, intercept network traffic, read crash logs, and control simulator environment settings.

Question 3

Is Pepper difficult to install or does it require complex setup?

Accepted Answer

Pepper is designed for easy installation, typically via pip (`pip install pepper-ios`) or Homebrew. It works by injecting a lightweight dylib into the simulator process without source changes or a build step, opening a WebSocket server for your AI agent to connect.

Question 4

How does Pepper enable AI agents to 'see' the screen?

Accepted Answer

Instead of just screenshots, Pepper provides AI agents with a structured view hierarchy. This means the agent understands every label, button, text field, their frames, traits, and accessibility identifiers, allowing for comprehensive screen analysis.

Question 5

Can AI agents interact with the app like a real user?

Accepted Answer

Yes, AI agents can simulate a wide range of user interactions including taps, scrolls, swipes, typing, toggling switches, and dismissing keyboards. These interactions go through the same IOHIDEvent injection path as real user input.

Pepper

Pepper

Key Features

Use Cases

Key Features

Use Cases