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

# Supported editors

> IDEs & Editors supported by Ona

Ona environments connect to your editor over SSH. Most editors support **one-click open** from the dashboard. Click the Open button and you're connected. Editors like Zed require manual SSH configuration.

## Supported editors

| Editor | Connection | One-click open | Browser mode | Ona extension | devcontainer customizations | Prebuild warmup | Policy support |
| - | - | - | - | - | - | - | - |
| [VS Code](https://ona.com/docs/ona/editors/vscode.md) | SSH via extension | | - | | `vscode.extensions`, `vscode.settings` | - | |
| [VS Code Browser](https://ona.com/docs/ona/editors/vscode-browser.md) | Browser | | | | `vscode.extensions`, `vscode.settings` | - | |
| [Cursor](https://ona.com/docs/ona/editors/cursor.md) | SSH via extension | | - | | `vscode.extensions`, `vscode.settings` | - | |
| [Windsurf](https://ona.com/docs/ona/editors/windsurf.md) | SSH via extension | | - | | `vscode.extensions`, `vscode.settings` | - | |
| [JetBrains](https://ona.com/docs/ona/editors/jetbrains.md) | Toolbox plugin | | - |  (Toolbox) | `jetbrains.plugins` | | |
| [Zed](https://ona.com/docs/ona/editors/zed.md) | SSH (manual) | - | - | - | - | - | - |

## VS Code and forks

[VS Code](https://ona.com/docs/ona/editors/vscode.md), [Cursor](https://ona.com/docs/ona/editors/cursor.md), and [Windsurf](https://ona.com/docs/ona/editors/windsurf.md) all use the same [Ona extension](https://marketplace.visualstudio.com/items?itemName=gitpod.gitpod-flex). The extension connects to your environment over SSH and provides:

* **One-click rebuild**: apply devcontainer changes without leaving the editor
* **Port forwarding**: access services running in your environment
* **Automations management**: start/stop services and tasks
* **Browser handling**: URLs opened in the environment automatically open in your local browser

Cursor and Windsurf are AI-native editors built on VS Code. Their AI features work in Ona environments as they do locally, operating over the SSH connection independently of the Ona extension. See the [Cursor](https://ona.com/docs/ona/editors/cursor.md#cursor-ai-works-over-ssh) and [Windsurf](https://ona.com/docs/ona/editors/windsurf.md#windsurf-ai-works-over-ssh) pages for specifics.

Extensions configured via `customizations.vscode.extensions` in your `devcontainer.json` are installed in all VS Code-based editors, including Cursor and Windsurf.

## JetBrains

[JetBrains IDEs](https://ona.com/docs/ona/editors/jetbrains.md) connect through JetBrains Toolbox with the [Ona plugin](https://plugins.jetbrains.com/plugin/26960-ona). Supported IDEs: IntelliJ IDEA Ultimate, GoLand, PyCharm Professional, PhpStorm, WebStorm, RubyMine, CLion, RustRover, and Rider.

JetBrains is the only editor family that supports [prebuild warmup](https://ona.com/docs/ona/projects/prebuilds.md#jetbrains-warmup). Warmup pre-installs the IDE backend and builds project indexes during prebuilds, reducing startup time.

Plugins are configured via `customizations.jetbrains.plugins` in your `devcontainer.json`.

## SSH-based editors

[Zed](https://ona.com/docs/ona/editors/zed.md) and any other SSH-capable editor can connect to Ona environments using the [CLI](https://ona.com/docs/ona/integrations/cli.md). Run `ona env ssh-config` to set up your local SSH configuration, then connect using the environment's SSH host (`<environment-id>.ona.environment`).

SSH-based editors do not appear in the Ona dashboard editor selector and are not covered by [organization editor policies](https://ona.com/docs/ona/organizations/overview.md).

## Browser handling

VS Code, VS Code forks (Cursor, Windsurf), and JetBrains have built-in browser handlers that automatically open URLs in your local browser when triggered by scripts or commands. See [opening a port and previewing in the browser](https://ona.com/docs/ona/integrations/ports.md#opening-a-port-and-previewing-in-the-browser) for details.


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