oslog

# oslog Read, stream, and analyze Apple unified logs for iOS/macOS apps. ## When to Use Activate when the user asks to: - Check, read, show, or debug app logs - Stream logs in real time - Analyze `.logarchive` files - Filter system logs by process, subsystem, or message content - Investigate crashes, errors, or unexpected behavior via logs ## Step 1 — Detect Subsystem Auto-detect the OSLog subsystem from the project. Try these sources in order: 1. **Source code** — search for `Logger(subsystem:` in Swift files to find the actual subsystem string used in code 2. **`project.pbxproj`** — fall back to `PRODUCT_BUNDLE_IDENTIFIER` build setting (common convention is to use bundle ID as subsystem) 3. **`Info.plist`** — read `CFBundleIdentifier` value (resolve `$(PRODUCT_BUNDLE_IDENTIFIER)` if needed) 4. **Ask the user** — if all detection fails, ask for the subsystem string Store the detected subsystem for reuse within the session. ## Step 2 — Determine Mode ### Mode A: Show Recent Logs Query recent logs from the live system log store. ```bash /usr/bin/log show --last <N>m --info --debug --no-pager \ --predicate 'subsystem == "<SUBSYSTEM>"' | head -100 ``` - Default to `--last 5m`, adjust based on user request - Always pipe through `head` on first query to avoid flooding output - Increase `head` limit or remove it only if the user asks for more ### Mode B: Stream Live Logs Stream logs in real time from a running app. ```bash /usr/bin/log stream --info --debug \ --...