/ios-log

Stream and analyze logs from a USB-connected iOS device running Zedra.

Run the script

./scripts/ios-log.sh tail [--filter <pattern>] [--select-device] [--simulator]

Physical devices stream via `idevicesyslog` over USB (no sudo required); `--simulator` streams a booted simulator via `simctl` instead.

• `--filter <pattern>` — extra grep pattern on top of the default Zedra filter
• `--select-device` — ignore saved device pref and re-prompt
• `--simulator` — target a booted simulator instead of a USB device

**Device preference** is one machine-global target (`/tmp/zedra-ios-device`, shared across checkouts, shared with `/ios-dev`, `devtool.sh`, `ios-log.sh daemon`). The script handles selection automatically — read the pref file, prompt if missing, save choice.

For background capture queryable by time range, see `./scripts/ios-log.sh daemon`/`query`/`wait`.

Log format

Rust logs via `IosLogger` (NSLog):

Mar  4 17:42:55 Zedra(Zedra.debug.dylib)[PID] <Notice>: [I zedra::module] message

Level prefix: `[I`=Info `[W`=Warn `[E`=Error `[D`=Debug `[T`=Trace

Crash analysis

Fetch crash report from device:

xcrun devicectl device copy from --device <UDID> \
  "/var/mobile/Library/Logs/CrashReporter/" /tmp/ios-crashes/
# or:
/opt/homebrew/bin/idevicecrashreport -e /tmp/ios-crashes/

Early startup crashes (before NSLog is set up) — capture stderr directly:

xcrun devicectl device process launch --console --device <UDID> dev.zedra.app

Screenshot

/opt/homebrew/bin/idevicescreenshot /tmp/zedra-screen.png