What you can ask for
- “Start an iPhone simulator and open https://example.com.”
- “Install this
.appand 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
- In ChatGPT, open the apps directory and choose run.cloud.
- Select Connect. A run.cloud page opens.
- Sign in, or create a run.cloud account.
- Review what ChatGPT asks for, choose the organization that sessions are billed to, and select Approve.
Tools
ChatGPT picks the tools itself. You do not call them by name. Sessionsstart_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.
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.
take_screenshot: Capture the screen.read_screen: Read the on-screen elements and their labels.get_device_logs: Read device and app logs.
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.
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.
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].