Skip to main content
Ona environments connect to your editor over SSH. Most editors support one-click open from the Ona dashboard. Click the editor button, and you’re connected. Some editors require manual SSH configuration.

Supported editors

EditorConnectionOne-click openBrowser modeOna extensiondevcontainer customizationsPrebuild warmupPolicy support
VS CodeSSH via extension-vscode.extensions, vscode.settings-
VS Code InsidersSSH via extension-vscode.extensions, vscode.settings-
VS Code BrowserBrowservscode.extensions, vscode.settings-
CursorSSH via extension-vscode.extensions, vscode.settings-
WindsurfSSH via extension-vscode.extensions, vscode.settings-
JetBrainsToolbox plugin- (Toolbox)jetbrains.plugins
ZedSSH (manual)------

VS Code and forks

VS Code, Cursor, and Windsurf all use the same Ona extension. The extension connects to your environment over SSH and provides:
  • Environment details panel: status, branch, and logs
  • 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 and Windsurf 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 connect through JetBrains Toolbox with the Ona plugin. 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. 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 and any other SSH-capable editor can connect to Ona environments using the CLI. Run gitpod env ssh-config to set up your local SSH configuration, then connect using the environment’s SSH host (<environment-id>.gitpod.environment). SSH-based editors do not appear in the Ona dashboard editor selector and are not covered by organization editor policies.

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 for details.