Skip to main content
The run.cloud app for ChatGPT lets ChatGPT start iOS simulators and Android emulators on your run.cloud account, put an app or a web page on them, and drive them for you. The simulator appears live in the chat, so you can watch what ChatGPT does and take over at any time.

What you can ask for

  • “Start an iPhone simulator and open https://example.com.”
  • “Install this .app and tap through the onboarding. Tell me where it breaks.”
  • “Build this Xcode project for the simulator and launch it.”
  • “Record a video of the sign-up flow on Android.”
  • “Which simulators are running? Stop them.”

Connect

  1. In ChatGPT, open the apps directory and choose run.cloud.
  2. Select Connect. A run.cloud page opens.
  3. Sign in, or create a run.cloud account.
  4. Review what ChatGPT asks for, choose the organization that sessions are billed to, and select Approve.
ChatGPT returns to the chat, connected. The connection can use simulators, uploaded apps, and simulator builds. It cannot see your API keys, secrets, billing settings, or other run.cloud products.

Tools

ChatGPT picks the tools itself. You do not call them by name. Sessions
  • start_simulator: Start an iOS simulator or Android emulator.
  • list_simulators, get_simulator: See running sessions and their state.
  • keep_simulator_alive: Keep an idle session open a little longer.
  • set_simulator_tags: Label a session.
  • stop_simulator: End a session.
Apps and URLs
  • upload_app, list_apps, download_app, delete_app: Manage app builds you upload.
  • install_app, launch_app, reload_app: Put an app on a device and run it.
  • get_app_launch: Check the progress of an install and launch.
  • open_url: Open a web page or deep link.
Seeing the screen
  • take_screenshot: Capture the screen.
  • read_screen: Read the on-screen elements and their labels.
  • get_device_logs: Read device and app logs.
Interacting
  • tap, swipe, scroll, gesture: Touch input.
  • type_text, press_key, toggle_keyboard: Keyboard input.
  • press_button: Hardware buttons such as Home.
  • rotate_device: Orientation.
  • simulate_memory_warning, set_render_debug: Debugging aids.
Recordings and media
  • start_recording, stop_recording: Record the screen.
  • list_recordings, get_recording, download_recording: Get recordings.
  • inject_camera_video, inject_microphone_audio: Feed media into the camera or microphone.
Xcode builds
  • start_xcode_build, rebundle_xcode_build: Build a source archive for the simulator.
  • get_xcode_build, list_xcode_builds: Check build status.
  • get_xcode_build_logs, get_xcode_build_events: Read the build log.
  • download_build_artifact: Get the built app.
  • cancel_xcode_build: Stop a build.

Xcode builds are simulator-only

From ChatGPT, run.cloud builds for the iOS Simulator only. It does not sign builds, create IPAs for devices or the App Store, or accept certificates, provisioning profiles, or passwords. Use the CLI for signed builds.

Billing

Simulators that ChatGPT starts are billed to the organization you chose when you connected, at the normal run.cloud rate. See pricing. To keep forgotten sessions from running up usage, every session started from ChatGPT closes after 5 minutes without activity and after 30 minutes at most. While ChatGPT is starting simulators, you can have at most 3 running at once in that organization, counting ones you started elsewhere. Ask ChatGPT to stop one, or start a new one when a session has closed.

Disconnect

Open ChatGPT settings, go to the connected apps, choose run.cloud, and disconnect. This revokes ChatGPT’s access immediately. Your run.cloud account, apps, and builds are not deleted.

Troubleshooting

For anything else, see support or email [email protected].