# Pair Roblox Studio

> Link a Roblox Studio session to your RoGenie account with a pairing code, switch between several Studios, and unpair.

Pairing links one Roblox Studio session to your RoGenie account, so the agent can act in the place you have open. You need the [plugin installed](https://rogenie.ai/docs/install-plugin) first.

## Pair with a code

1. Open Roblox Studio and open a place.
2. On the **Plugins** tab, click **RoGenie** to open the RoGenie panel.
3. Click **Connect**. The panel shows **PAIRING CODE** and eight digits (six on a plugin older than 1.1.151). You can click the code to select it, then press `Ctrl+C` (`Cmd+C` on Mac) to copy it.
4. In the RoGenie app, click the **Studio** button in the top bar and choose **Pair Studio** (or open the first-run guide's **Pair** button).
5. Type or paste the digits into **Enter the pairing code** and click **Pair**.
6. Back in Studio, the panel asks **CONFIRM PAIRING** with your account name. Click **Confirm pairing** (plugin 1.1.151 and later). If you did not enter this Studio's code yourself, click **Cancel**: nothing is kept, and that account cannot use your Studio.

The plugin panel switches to **PAIRED** ("Paired as" your name), and the app's top bar shows *Studio: Linked* with the name of your place.

> **Note**
> A pairing code is valid for **5 minutes**. If it expires, the panel says "Code expired. Click 'Get a new code' to try again." The plugin fetches one fresh code by itself after the first expiry; after two unused codes it waits for you to click **Get a new code**.

The same pairing window also accepts the code shown by the [RoGenie Bridge](https://rogenie.ai/docs/bridge).

## After pairing

- **Auto-connect on start.** With this setting on in the plugin panel, Studio reconnects to your account by itself the next time it starts, so you only pair once per computer.
- **What RoGenie can see.** Once linked, RoGenie reads the live scene of the place that is open, follows your Studio selection, and can change instances and scripts in that place.
- **Closing Studio keeps the pairing.** When you close Studio the app shows *Studio: Closed*. Open your place again and the plugin reconnects with the same pairing (with Auto-connect off, click **Connect**). If Studio shows a pairing code instead, click **Enter a pairing code** in the app and type it there.
- **Status in the app.** The Studio button shows *Studio: Linked — your place*, *Studio: Closed* (paired, Studio not open), *Studio: Not linked* (no Studio paired yet), or *Studio: Update needed* when the plugin is older than RoGenie needs.

## Several Studio sessions

You can pair more than one Studio, for example two places open at once or Studio on two computers.

1. Click the **Studio** button in the top bar.
2. Under **Connected Studio sessions**, choose the one RoGenie should act in.

Each browser tab works in the Studio you choose there. A run stays on the Studio it started in, and if that Studio drops mid-run, RoGenie waits up to 3 minutes for it to reconnect and carries on. The Studio menu also shows whether the [RoGenie Bridge](https://rogenie.ai/docs/bridge) is connected, how many characters of [project notes](https://rogenie.ai/docs/memory#project-notes) the place has, and a shortcut to the [IDE](https://rogenie.ai/docs/ide).

> **Tip**
> If several Studios are connected and none is chosen, features that read one specific place (like project notes) ask you to link one in the Studio menu first.

## Stop what RoGenie is doing in Studio

While RoGenie runs something in Studio, the plugin panel shows what it is doing and a **Stop** button. It stops the running Studio action at its next safe point. To stop the whole run, use **Stop** in the app instead; see [Stop, queue and steer](https://rogenie.ai/docs/stop-and-steer).

## Unpair

Click **Unpair Studio** in the plugin panel. RoGenie removes that Studio's pairing from your account and can no longer act in that Studio until you pair it again with a new code. Studios on your other computers keep theirs.

## Problems?

See [Studio won't connect](https://rogenie.ai/docs/troubleshooting-studio).
