skwallace36

skwallace36 / Pepper

Public

iOS dynamic library MCP for agents

ios llm-agent mcp mcp-server swift
47
3
100% credibility
Found Mar 29, 2026 at 47 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Swift
AI Summary

Pepper lets you inspect and automate interactions with iOS Simulator apps using simple tools that AI agents or humans can control.

How It Works

1
🔍 Discover Pepper

You hear about Pepper, a helpful tool that lets you peek inside and control iOS apps running in the simulator without writing any code.

2
📦 Get it set up

With one simple command, you add Pepper to your computer, ready to work with your favorite apps.

3
🚀 Start your app

You launch your iOS app in the simulator, and Pepper quietly connects inside it to watch and help.

4
👀 Look around

Ask Pepper to show you what's on the screen – buttons, text, lists – everything lights up clearly.

5
🖱️ Interact easily

Tap buttons, scroll lists, type text, or swipe – Pepper makes your app respond just like a real user.

6
🤖 Team up with AI

Connect your AI helper, and it uses Pepper's view to automate tasks smoothly and reliably.

✅ Perfect control

Your app flows perfectly under control, tests pass every time, and you save hours of manual work.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 47 to 47 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is Pepper?

Pepper injects a Swift dynamic library into iOS Simulator apps via DYLD_INSERT_LIBRARIES, launching a WebSocket MCP server for AI agents to control the runtime. Agents get 50+ tools: inspect view hierarchies with "look", simulate taps/swipes/scrolls/gestures, input text, intercept network traffic, monitor console/heap leaks, and auto-dismiss permission dialogs. Install via pip pepper-ios for pepper-mcp server and pepper-ctl CLI—pairs with iOS GitHub projects for automated testing.

Why is it gaining traction?

It bridges AI agents to real iOS app behavior, handling UIKit/SwiftUI identically through HID events and accessibility trees—no framework-specific hacks. Stands out with auto-tagging unlabeled elements for reliable taps, dialog interception, and deep introspection like renders/timelines/perf metrics. Devs dig the generic mode plus app adapters for custom tab bars/deeplinks in iOS GitHub test suites.

Who should use this?

iOS devs building agent-driven E2E tests for complex apps like Wikipedia feeds or SwiftUI lists. Teams automating simulator workflows in iOS GitHub Actions/Copilot without devices. Automation enthusiasts scripting iOS GitHub IPA deploys or heap debugging via MCP clients like Claude Desktop.

Verdict

Solid prototype for agent iOS control at 47 stars and 1.0% credibility—quick make deploy/smoke tests show polish, but fork/customize for production. Worth it if simulator agents are your jam.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.