OpenParable
Skip to content
← Back to skills

IOS Watch Logs

Apps & Automation
ios-watch-logs

IOS Watch Logs is an Agent Skill for apps & automation published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Start real-time log streaming from connected iPhone to console and file. Shows only app's explicit log messages with [APP] prefix. Use when monitoring app behavior, debugging, or viewing logs.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/data/ios-watch-logs/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/ios-watch-logs, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

iOS Watch Logs

Overview

Streams logs from a USB-connected iPhone in real-time using pymobiledevice3, filtering to show only the app's explicit log messages (those with [APP] prefix).

When to Use

Invoke this skill when the user:

  • Asks to "watch iOS logs"
  • Wants to "see what the app is doing"
  • Says "monitor the iPhone"
  • Asks to "stream logs from iPhone"
  • Wants to debug or see real-time app behavior
  • Says "show me the logs"

Prerequisites

  • iPhone connected via USB
  • pymobiledevice3 installed (pip3 install pymobiledevice3)
  • Device must be trusted
  • App must be running on the device to see logs

Option 1: Use Screen Capture App (Recommended)

The iPhone screen capture app has an integrated console:

cd miso/platforms/ios/development/screen-capture/imp
./iphone_screencap.sh

Click the ">" button to open the live log console.

Option 2: Terminal Streaming

Stream logs directly in terminal:

pymobiledevice3 syslog live 2>/dev/null | grep "\[APP\]"

Option 3: Claude Reading Logs

Claude can read recent logs with:

timeout 3 pymobiledevice3 syslog live 2>/dev/null | grep "\[APP\]" | tail -30

Log Format

The app's Logger class prefixes messages with [APP]:

NoobTest{...}[12345] <INFO>: [APP] [PostView] Loading post 14
NoobTest{...}[12345] <DEBUG>: [APP] [Network] Response: 200 OK

Adding Logs in Code

Use the app's Logger class in Swift:

Logger.shared.info("[MyFeature] Something happened")
Logger.shared.debug("[MyFeature] Debug info: \(value)")
Logger.shared.error("[MyFeature] Error: \(error)")

Common Issues

No logs appearing:

  • Ensure the app is running on the device
  • Check that logs use [APP] prefix
  • Verify pymobiledevice3 is installed: pip3 install pymobiledevice3
  • Device must be trusted and unlocked

pymobiledevice3 not found:

  • Install: pip3 install pymobiledevice3

Only system logs showing:

  • The app's Logger must prefix messages with [APP]
  • This filters out thousands of framework/system messages

Notes

  • The [APP] prefix filters out thousands of system messages
  • Screen capture app console auto-scrolls to latest logs
  • Use timeout command to get a snapshot without blocking