Skip to content

AI iPhone agent FAQ

With the app: no. Use a computer once to install the board firmware in your browser. Then the app and board handle the task together.

With the CLI: yes. Your agent runs on the computer and uses Bluetooth to reach the board. See CLI & AI agents for the demo, setup, and release availability.

The App Store release is in review; the public beta is on TestFlight now. Getting started walks through joining the beta and setting up the app.

Yes. A free AI service is available in the app, so you can start there. You can also connect your own image-capable, OpenAI-compatible service. An API key is only needed when configuring your own service.

We plan to offer a subscription AI service in the future to make getting started even easier. See the privacy policy for how each service handles screenshots and tasks.

Yes. Pause or stop from the app or the Dynamic Island. If a task needs your help, the app can send a notification: press and hold it to continue, skip a step, stop, or take over.

To review sensitive steps before they happen, open Settings → Runs → Ask me first and choose Payments only (default), Payments, sending, deleting, or Never. See Intents & recording.

Your iPhone joins the board’s Wi-Fi so it can mirror the screen. That Wi-Fi connection has no internet; the app reaches your AI service over cellular data. Screen Mirroring stays on the local connection; model requests use cellular data. Keep cellular data enabled while running a task.

My iPhone stays on home Wi-Fi and the board’s hotspot is missing

Section titled “My iPhone stays on home Wi-Fi and the board’s hotspot is missing”

The board is probably in station mode, where it joins an existing network instead of opening its hotspot. It remembers that mode across restarts and updates. Switch it back: iPhone joins home Wi-Fi instead of the ESP32 Agent hotspot.

Bluetooth will not pair, or only works very close to the phone

Section titled “Bluetooth will not pair, or only works very close to the phone”

Check that the included Wi-Fi/Bluetooth antenna is connected to the board. Without an antenna, Bluetooth may fail or work only with the board right beside the phone. Attach it, keep the board close to the iPhone, and try Plug Me In again.

For the connector location, see Attach the antenna.

How do I find the board’s Wi-Fi password?

Section titled “How do I find the board’s Wi-Fi password?”

View it in ESP32 Agent, or read it over the board’s USB serial connection:

  1. Connect the prepared board to a computer by USB. Open its normal running serial port at 115200 baud. If no serial port shows up, read the password in the app instead.
  2. Send one line: 0 netinfo.
  3. For the board hotspot, confirm mode is ap, then use ssid and pass in the iPhone’s Wi-Fi settings.
  4. Move the board back to the iPhone and start Screen Mirroring again. Simply reconnecting power does not change the saved hotspot password.

Keep the full serial response private: it also contains an access token. If mode is sta, the credentials describe the network the board joined, rather than its own hotspot.

With Manina AI CLI 0.1.2 and board firmware v0.2.3, esp32agent net shows the hotspot name and password over the paired Bluetooth link. With firmware v0.2.2, use the app or USB serial as above.

The board is missing from Screen Mirroring

Section titled “The board is missing from Screen Mirroring”
  1. Plug in the board. For the app, finish its Bluetooth pairing; for the CLI, use esp32agent pair on your computer.
  2. Keep the board close to the phone and join its Wi-Fi. CLI users can do this directly in Settings → Wi-Fi; find the hotspot password first. App users can follow the join prompt or the manual password shown there.
  3. Open Control Center → Screen Mirroring → ESP32 Agent.
  4. Keep your iPhone unlocked.

ESP32 Agent is the receiver name to look for in Screen Mirroring.

If joining the board’s Wi-Fi fails, move the board right beside the phone and try again. The board’s hotspot uses reduced transmit power; this is separate from Bluetooth pairing. See the connection discussion.

Mirroring is connected, but the picture is stuck

Section titled “Mirroring is connected, but the picture is stuck”

A frozen preview, err no video at the start of a task, or runs that repeat actions and look very slow were reported in issues #25, #29, and #44. App 1.0 and board firmware 0.2.2 fix the known causes: the video resumes on its own after a reconnect, also after a long still screen.

  1. Check the versions. The app version is in Settings → About; the board firmware is in Settings → Board. Update the board if offered: Firmware updates.
  2. Reconnect mirroring. Stop the task, turn Screen Mirroring off, and pick ESP32 Agent again. Keep the iPhone unlocked and on the board’s Wi-Fi.
  3. Change screens and check that the preview follows.
  4. Retry the task.

If it persists, open the run in Runs and choose ⋯ → Export trace, and check Settings → Diagnostics → Video while mirroring is on. Send both, with your versions, to [email protected].

If the picture moves but is very slow, the app may lack Local Network permission and be using Bluetooth for video: see Video is slow.

Can I mirror from a Mac instead of the iPhone?

Section titled “Can I mirror from a Mac instead of the iPhone?”

No. Screen Mirroring from macOS is not supported. The handshake can look fine while the board never receives video. Mirror from the iPhone the board is plugged into. See No video from Screen Mirroring.

Turn on Settings → Accessibility → Touch → AssistiveTouch, keep the pointer visible, and keep your iPhone in portrait. In the app, complete Let Me Use the Pointer. With the CLI, run esp32agent calibrate; you do not need the app for calibration.

Calibration finishes, but the accuracy stays at ±5% or more

Section titled “Calibration finishes, but the accuracy stays at ±5% or more”

Settings → Calibration shows how far the last check tap landed from its target, as a share of the screen. Under ±2% is normal. If it stays at ±5% or more after you calibrate again, the cause is usually an AssistiveTouch setting:

  1. Set Tracking Speed to the middle. Go to Settings → Accessibility → Touch → AssistiveTouch → Tracking Speed. Near the slow end, iOS speeds up fast pointer moves much more than slow ones, so the app’s measurements no longer fit together and taps land off target.
  2. Turn off Pointer Animations in Settings → Accessibility → Pointer Control.
  3. Keep these settings after you calibrate. Tracking Speed changes how far the pointer moves. If you change it, calibrate again.
  4. Calibrate again: Settings → Calibration → Calibrate. Keep the iPhone in portrait, keep Screen Mirroring on, and don’t touch the screen until it finishes.

If the number is still high, send diagnostics and include your iPhone model, iOS version, app version and board firmware version.

Start with one clear destination, such as “Open Settings and go to Wi-Fi.” Once that works, try a longer task. A model that understands images and follows instructions well helps; each step also depends on your model’s response time and network connection.

Watch the first run. If it goes off track, stop and make the goal more specific. You can replay the run on your phone to see where it went wrong.

Keep the phone unlocked and in portrait. Locking stops Screen Mirroring. iOS does not mirror passcode entry, Apple Pay, or DRM-protected video. For Chinese, add the phone’s Pinyin keyboard: the app switches between English and Pinyin by itself (ctrl+space). Start with a short phrase and check the result. Through the CLI, your agent selects the intended candidate. The CLI’s own limits are listed in CLI & AI agents.

Can I charge the phone while the board is connected?

Section titled “Can I charge the phone while the board is connected?”

On a USB-C iPhone, the board occupies the USB port and draws power from the phone, so there is no simultaneous wired charging. If your phone cannot charge wirelessly, take that into account before planning a long run. See the charging discussion.

On a Lightning iPhone, a Lightning to USB 3 Camera Adapter with a charger in its Lightning port powers both the board and the phone. See Lightning iPhone.

From the app, over the board’s Wi-Fi: Settings → Board. The App Store and TestFlight apps each use their own firmware channel. See Update ESP32 Agent firmware.

In the app, open Settings → About → Logs and use Send diagnostics to the developer or Export all logs. With the CLI, run esp32agent logs --save. In the web installer, click Download log. Send the result to [email protected]. Details: Debugging & logs.

Manina AI sends screenshots to the AI service you choose so it can decide the next action. Read the privacy policy for what is sent, how it is stored, and your choices. You can replay and export run history on the phone. If you use your own API key, it is stored in the iOS Keychain.

With the CLI, screenshots and history are saved on your computer. Your computer agent may send screenshots to its chosen model provider. Check that agent’s permissions and data policy; the phone app’s free AI service does not supply the computer agent’s model.

Is there an official Manina device I can buy?

Section titled “Is there an official Manina device I can buy?”

Not yet. The open-source project uses a Seeed Studio XIAO ESP32S3 that you buy and flash. The Manina device is a different, plug-and-play unit. It is not for sale, it has no final price, and it has no ship date. Join the Manina device waitlist. Early birds may get a unique invite code. Joining is not an order and does not reserve one.