> ## Documentation Index
> Fetch the complete documentation index at: https://docs.run.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Use run.cloud in ChatGPT

> Start, watch, and drive cloud iOS simulators and Android emulators from ChatGPT, and build simulator apps with Xcode.

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](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](https://docs.run.cloud/ios/build-with-xcode.md) 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](https://run.cloud/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

| Problem | What to do |
| - | - |
| "This connection request has expired" | Start the connection again from ChatGPT. |
| The live view says "This viewer link expired" | Ask ChatGPT to show the simulator again. |
| The live view says "Session ended" | The session closed after the idle or maximum time. Ask ChatGPT to start a new one. |
| ChatGPT says you already have 3 running simulators | Ask ChatGPT to list your simulators and stop one you no longer need. |
| ChatGPT reports a spending or credit limit | Check your organization's usage and limits in the [run.cloud dashboard](https://run.cloud/dashboard/). |
| An uploaded app does not install | iOS simulators need a simulator build (`.app`), not an IPA. Android needs an `.apk`. |
| An Xcode build fails | Ask ChatGPT to read the build log. It points to the first error. |

For anything else, see [support](https://run.cloud/support/) or email
[support@run.cloud](mailto:support@run.cloud).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.