Skip to main content

Bitrise VS Code plugin

The Bitrise VS Code plugin brings Remote Dev Environments into your editor. Instead of connecting to an existing session, you start from a local repository, and the plugin creates the session, clones your repository into it, and connects VS Code — so you edit, run terminals, and debug as if the code were on your own machine.

Before you startClick to copy link​

You need:

  • A Bitrise workspace with RDE access.
  • VS Code. The plugin depends on the Remote - SSH extension, which it installs automatically.
  • For private repositories, a local SSH key so the session can clone your repository.

Installing the pluginClick to copy link​

Install Bitrise from the VS Code Marketplace, or search for Bitrise in the Extensions view in VS Code. After it installs, a Bitrise icon appears in the activity bar.

Signing inClick to copy link​

  1. Open the Bitrise view from the activity bar.
  2. Click Sign in to Bitrise. This opens your browser to authenticate.
  3. Select the workspace to use. Your sessions appear once you select a workspace with RDE access.

Opening a repository in a new sessionClick to copy link​

Use Open Repo in New Session — the + in the Sessions view — to create a session from a local repository. The plugin walks you through:

  1. A name for the session.
  2. The local repository to open.
  3. The branch to work on.
  4. The stack for the machine.
  5. The machine type.

The plugin then creates the session, clones your repository into it, and opens a remote VS Code window connected to the session.

Only pushed commits are cloned

The plugin clones the pushed state of the branch you select. Local commits and uncommitted changes that you haven't pushed are not transferred to the session.

Managing sessionsClick to copy link​

The Sessions view lists the sessions in your workspace. From it you can:

  • Open a running session in a remote window, or restore and open a terminated one.
  • Stop a running session.
  • Open a session in the Bitrise RDE UI.
  • Search your sessions.

Quick configurationClick to copy link​

The Configuration view helps you set up your environment once, so new sessions are ready to use:

  • Passwordless SSH: registers your SSH public key as a saved input so you connect without a password.
  • Claude Code: saves a Claude Code credential so new sessions start with Claude Code already authenticated.
  • SSH agent forwarding: lets a session use your local Git keys to push and pull.