# Bitrise RDE UI

The Bitrise RDE UI is the web interface for Remote Dev Environments. It's the visual way to create and manage sessions, templates, and saved inputs, and it includes a built-in terminal so you can work in a session without leaving the browser.

Open the **Remote Dev Environments** section of the Bitrise app to get started. If you don't see it, you don't have the **RDE User** role yet: ask a workspace owner or manager to grant it. See [Managing RDE access](/bitrise-rde/configuration/managing-rde-access).

## Authentication

You can configure your Claude Code credentials and passwordless SSH access on the **Saved inputs** page. Saved inputs are reusable credentials and values you store once and map into sessions. See [Saved inputs](/bitrise-rde/configuration/saved-inputs) for details.

## Creating a session

1. In the Remote Dev Environments section, click **New session**.
1. Set a session title, and optionally a description.

   The session title must be unique. 
1. Optionally, enter an AI prompt to start Claude Code automatically when the session boots. This requires saved Claude Code credentials.
1. Choose when the session should auto-terminate.
1. Choose a template, or select **No template** and pick a stack and a machine type directly.
1. If a [warm pool](/bitrise-rde/configuration/warm-pools) of that template exists, **Start from warm pool** lets you claim a pre-booted session from it instead of booting a new machine.
1. Fill in any required inputs. You can type a value or select an existing saved input.
1. Click **Create**.

The session starts within a short while. When it's running, open it to connect.

To boot an iOS simulator or Android emulator with the session, use the device section of the form, which appears once the selected stack or template supports a device. See [Device sessions](/bitrise-rde/devices/device-sessions).

{/* TODO: screenshot of the New session form (capture at 1728×875 per the Style Guide) */}

## Managing sessions

The **Sessions** list shows every session in the workspace, grouped by status, with search. From a session you can:

- Restore a terminated session, or terminate a running one.
- Permanently delete a terminated session.
- Edit its name and description, and change its auto-terminate setting.

## Connecting to a session

The session detail page is your connection hub. From it you can:

- Open the **built-in web terminal**, with support for multiple tabs.
- Copy the **SSH** and **VNC** credentials to connect from your own tools.
- Use **Open in VS Code** to connect with the VS Code Remote - SSH extension.
- Use **workspace-link buttons** to open a specific folder in your IDE.
- Click **Open device view** in the **Device** row to watch and control the session's simulator or emulator, when the session boots one.

For details on each method, see [Connecting to a session](/bitrise-rde/rde-options/connecting-to-a-session).

## Templates

You can create and manage reusable session configurations from the UI: see [Templates](/bitrise-rde/configuration/templates).

## Warm pools

The **Warm pools** page lists the pools that keep sessions booted for the workspace. Create one with **New warm pool**, and from a pool's page change its size, edit its configuration, claim a session, or delete it. See [Warm pools](/bitrise-rde/configuration/warm-pools).

## Workspace usage

The **Usage** page shows what the workspace's active sessions consume right now: session counts, vCPU and memory totals split by OS, and a per-user breakdown. Only workspace owners and members who can manage billing see the page. The same report is available programmatically: see [Workspace usage report](/bitrise-rde/configuration/rde-api#workspace-usage-report).