avr cursor

Opens the current project in Cursor, attached to its Linux environment. It works exactly like avr code, with Cursor’s launcher in place of VS Code’s.

  1. Help
  2. Examples
  3. What it does
  4. Exit status
  5. Errors
    1. cursor is not on your PATH
    2. takes no arguments

Help

This is exactly what avr help cursor or avr cursor --help prints.

Usage:
  avr [selector flags] cursor

Open the current project in Cursor attached to its Linux environment: over Remote-SSH on macOS, through Cursor's WSL integration on Windows. Needs the `cursor` command on your PATH.

`cursor` is an avar command, so it does not reach the guest: to run a program called `cursor` in Linux, use `avr -- cursor`.

Selector flags such as --arch and --distro must come before the command; run `avr --help` to see them.

Examples

avr cursor                    # this project, in its usual environment
avr --distro debian cursor    # this project, in Debian
avr -- cursor                 # a program called cursor inside Linux, not this command

What it does

The same steps as avr code: find the cursor launcher first, prepare the environment as avr does, then open Cursor on the current directory inside Linux. While a Cursor window is connected, idle auto-stop leaves the environment running, as described for avr code.

Host Connection
macOS Remote-SSH, through avar’s SSH configuration and the one-time Include line described on the avr code page
Windows Cursor’s WSL integration

Cursor provides its own remote extensions. avar does not check for them.

Exit status

The same as avr code.

Errors

cursor is not on your PATH

avr: the `cursor` command was not found on your PATH (<cause>). Open Cursor, press Cmd+Shift+P and run "Shell Command: Install 'cursor' command in PATH", then open a new terminal.

That is the macOS hint. On Windows, re-run Cursor’s installer with its “Add to PATH” option. No environment is started. Exit status 1.

takes no arguments

avr: `avr cursor` takes no arguments, but got "<args>"; it opens the current project in Cursor attached to the target Linux environment

Exit status 2.