When something works in the builder preview or Expo Go but breaks in TestFlight, the answer is almost always in your device’s logs. This page covers how to pull them. The recommended path is Apple’s Console app on a Mac. If you don’t own a Mac, the on-device options below get you the same information.Documentation Index
Fetch the complete documentation index at: https://www.anything.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Recommended: Console on a Mac
Console.app ships with macOS. It streams live logs from any iPhone or iPad you plug in. The steps below get you from raw stream to the exact slice you’ll paste into the builder.Open Console and pick your phone
Spotlight (
cmd-space) and search Console. In the left sidebar, click your iPhone under Devices.Sort by time, oldest first
Click the Time column header until newest entries land at the bottom. This matches the order you’ll experience the bug, so the failure shows up at the end of your stream.
Filter to your app
In the search bar at the top, type
process:YourAppName and press Enter. Use your app’s display name (the one on the iPhone home screen) without spaces. For auth bugs, add a second term: subsystem:com.apple.AuthenticationServices. Each term should appear as a separate pill in the search bar.Start streaming and reproduce the bug
Click Start streaming, then trigger the broken flow on your phone. New lines appear at the bottom in real time.
Pause and find the failure line
Click Pause as soon as the bug hits. Scroll to the bottom of the stream. Look for the first red Fault or Error line that lines up with what you saw on screen. Note its timestamp.
Select the right slice
Click a log line about 5 to 10 seconds before the error timestamp. Scroll down and shift-click a line 5 to 10 seconds after the error. That’s your slice: the failure plus the context around it. Aim for 30 to 100 lines, not the whole stream.
Copy and paste into builder chat
Right-click the selection and choose Copy (or
cmd-C). Switch to the builder, open chat in Discussion mode, and paste. Wrap the pasted log in a triple-backtick code block so the agent reads it cleanly. The full prompt template is in Give the logs to the agent below.No Mac? Three options that work from your phone
You don’t need a computer to get useful logs off your device. These options work from the iPhone alone.1. TestFlight feedback (easiest)
This is the fastest path and it’s built into TestFlight.Reproduce the bug in the TestFlight build
Hit the failure on purpose so the system captures it fresh.
Take a screenshot
Press the side button + volume up. TestFlight detects the screenshot and offers to send beta feedback.
2. Crash reports from Analytics Data
Every crash on your phone writes a small.ips file you can grab directly.
Find your app's crash
Scroll for a filename that starts with your app’s name and ends in
.ips. The newest entries are at the bottom.An
.ips file only exists if the app actually crashed. If your bug is “I tap the button and nothing happens,” skip to sysdiagnose below.3. Sysdiagnose (full diagnostic bundle)
A sysdiagnose is the closest thing to “everything Console.app would have shown, packaged up.” It’s heavier (200 to 400 MB) but it captures the full system log around the moment you triggered it.Trigger the diagnostic
Immediately press and hold both volume buttons + the side button for about 1.5 seconds. You’ll feel a short vibration. Release. Don’t hold longer or you’ll get the power-off screen.
Reading logs from Windows or Linux
If you want to inspect logs yourself instead of sending them on, both Windows and Linux have options. Windows- iMazing has a built-in device console that mirrors Console.app. The free tier is enough to stream logs and export crash reports.
- The “Apple Devices” app from the Microsoft Store only handles sync and backups. It does not show logs.
libimobiledeviceis open source.idevicesyslogstreams live device logs over USB.idevicecrashreport -e ./outpulls all crash reports off the phone.
.logarchive format, you still need a Mac (or a cloud Mac for an hour).
Give the logs to the agent for a fix
Once you have a log, the goal is to get the relevant part in front of the builder agent with enough context that it can identify the cause.The builder chat doesn’t accept raw log files yet (no
.ips, .tar.gz, or .txt drops). You can paste a pastebin or GitHub Gist link and the agent will fetch the URL, but long content often gets truncated on read. Pasting the relevant slice directly into chat is the most reliable path on every plan and every mode.Pull the right slice (not the whole log)
A focused 30 to 100 lines around the failure beats a 10,000-line dump every time. The agent does better work with a small, on-target excerpt. For a Console.app slice, follow the steps above. For other sources:- From a
.ipscrash report: open the file in any text editor. Copy the top metadata block (Exception Type, Exception Codes, Termination Reason) plus the Crashed Thread backtrace. Skip the other threads unless you know they matter. - From iMazing on Windows: the device console works the same way as Console.app. Filter by process, reproduce, pause, select the lines around the failure, and copy.
- From
idevicesyslogon Linux: pipe to a file (idevicesyslog > log.txt), reproduce the bug, stop the stream withctrl-C, then open the file and pull the lines around your failure timestamp. - From a sysdiagnose: open
system_logs.logarchivein iMazing (Windows) orlog show --archive(Mac), filter the same way, and copy the relevant lines. The full bundle is too big to paste.
How to frame it in chat
Use Discussion mode so the agent investigates without changing your code. Paste the slice and frame it like this:What to send to support
If the bug isn’t something the agent can fix from a prompt, email hello@anything.com with:- What you did, step by step, and what you expected to happen
- A screenshot or screen recording of the failure
- The log file (TestFlight feedback,
.ipscrash report, or sysdiagnose) - Your TestFlight build number (visible in TestFlight under your app’s name)
.ips file or a sysdiagnose bundle.
Related
Testing
Preview your mobile app on a real device
App Store submission
The full TestFlight and App Store publishing flow
Get help
How we triage and what to send
Verify Apple Developer account
Make sure your account is active and ready