> ## 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.

# Cursor

> Connect to Ona environments using Cursor editor.

[Cursor](https://www.cursor.com/) connects to Ona environments using the same [Ona extension](https://marketplace.visualstudio.com/items?itemName=gitpod.gitpod-flex) as VS Code. All [VS Code features](/ona/editors/vscode) (environment details, rebuild, port forwarding, automations) work in Cursor.

<Note>When reaching out to support, specify that you are using Cursor as your editor.</Note>

## Prerequisites

1. [Cursor](https://www.cursor.com/) installed on your machine.
2. The [Ona extension](https://marketplace.visualstudio.com/items?itemName=gitpod.gitpod-flex) installed in Cursor.
3. The [Remote - SSH](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh) extension installed in Cursor.

## Opening an environment

Select **Cursor** from the editor dropdown by clicking the dropdown arrow next to the Open button on the action bar.

Cursor opens via the `cursor://` URI handler. On first use, Cursor prompts you to install the Ona extension and authenticate. This is the same flow as [VS Code setup](/ona/editors/vscode#first-time-setup).

## Cursor AI works over SSH

Cursor's AI features work in Ona environments as they do locally:

* **Tab**: inline code completions
* **Agent**: multi-file AI edits
* **Chat** (⌘L / Ctrl+L): context-aware code chat
* **⌘K / Ctrl+K**: inline code generation and editing

Cursor AI communicates with Cursor's cloud services directly over the SSH connection. No Ona-specific configuration is needed.

## Extension and settings

Extensions configured via `customizations.vscode.extensions` in your `devcontainer.json` apply to Cursor. See [VS Code and forks](/ona/editors/overview#vs-code-and-forks) for details.

## Troubleshooting

<Accordion title="Cursor does not open">
  The `cursor://` URI handler is not registered on your system, or Cursor is not installed.

  * **Linux**: Verify a Cursor desktop entry exists in `~/.local/share/applications` or `/usr/share/applications`. If missing, reinstall Cursor.
  * **All platforms**: Refresh the browser page, or test in a different browser to rule out browser-specific issues.
</Accordion>

<Accordion title="Connection issues">
  The [VS Code troubleshooting guide](/ona/editors/vscode#troubleshooting) applies to Cursor, including log export (`Ona: Export all logs`) and authentication issues.
</Accordion>

<Accordion title="General issues">
  1. Check the `Ona` output view for errors.
  2. Check your network settings. VPN or firewall can interfere.
  3. When sharing reports with support:
     * Set log level to Trace via `Developer: Set Log Level...`
     * Use `Ona: Export all logs` from the problematic window.
</Accordion>