source-command-ios-logs

Use this skill when the user asks to run the migrated source command ios-logs.

Command Template

iOS Logs

Stream and search logs from a connected iOS device using idevicesyslog.

Prerequisites

• libimobiledevice installed (brew install libimobiledevice)
• Physical iOS device connected via USB (not network-only)
• Device must be paired/trusted

Find Device UDID

First, list available devices:

idevice_id -l

This returns UDIDs of devices visible to libimobiledevice. Note: Newer devices using CoreDevice protocol may not appear here.

Stream All Logs

Stream all logs from a device (replace UDID):

/opt/homebrew/bin/idevicesyslog -u <UDID>

Stream Filtered Logs

Filter by process name (e.g., ActualChat):

/opt/homebrew/bin/idevicesyslog -u <UDID> -p ActualChat

Filter by message content:

/opt/homebrew/bin/idevicesyslog -u <UDID> -m "error\|warning\|VoIP"

Combine process and message filters:

/opt/homebrew/bin/idevicesyslog -u <UDID> -p ActualChat -m "INF\|error"

Capture for Duration

Capture logs for a specific duration (e.g., 10 seconds):

/opt/homebrew/bin/idevicesyslog -u <UDID> -p ActualChat &
PID=$!
sleep 10
kill $PID 2>/dev/null
wait $PID 2>/dev/null

Common Filters for ActualChat

Search for VoIP/PushKit logs:

-m "voip\|VoIP\|PushKit\|DidUpdate"

Search for application INFO logs:

-m "INF \[ActualChat"

Search for errors:

-m "error\|Error\|ERR\|Exception"

Log Format

ActualChat app logs appear as:

Mar 16 18:15:46.425 ActualChat[2869:195195] INF [Namespace.ClassName] Message

• Timestamp
• Process name and PID
• Log level (INF, DBG, WRN, ERR)
• Logger class name in brackets
• Message

Troubleshooting

If no logs appear:

• Verify device UDID with idevice_id -l
• Try without -p filter to see all logs
• Check device is connected via USB, not just WiFi
• Newer iOS devices (iOS 17+) may require Xcode Console instead