Command Mode

After you start Cursor Crane, it enters Command Mode by default. In this mode, you can hold Space to enter Mouse Control Mode if that setting is enabled, or trigger specific actions by entering command sequences.

If you want to type text, you can either enter Input Mode or exit Cursor Crane.

Press Control + Esc to exit Command Mode. To close the whole claw machine from Command Mode, press Shift + Control + Esc .

Command Sequences

Command sequences are usually composed of letters and are case-sensitive. For example, if one command sequence is c c , entering c twice in a row will trigger it.

A command sequence cannot be the prefix of another command sequence, so once you finish a full sequence, its command will be triggered automatically.

Tip

If you do not like the default command sequences, you can customize them in Settings. Please make sure your new command sequences do not conflict with existing ones.

You can also assign a keyboard shortcut to each command, and use those shortcuts to trigger commands directly even when Cursor Crane is not running.

Numeric Parameters

Some commands accept a number before their command sequence. Type the number and the full sequence first, then select a target in the mode that opens. The number is not part of the target’s hint.

For example, if you assign f to command.moveCursorToElementAndLeftClick:

Input	Action after selecting a target
f	Move to the target and left-click once
2f	Move to the target and double-click
3f	Move to the target and click three times
0f	Move the pointer to the target without clicking

f is an example custom assignment; use your configured sequence. Enter the number with the sequence in Command Mode, rather than after a standalone keyboard shortcut.

These commands accept a click count of up to 50. Without a number, single-click commands click once and double-click commands click twice. An explicit number replaces that default count.

Commands	Supported click actions
command.moveCursorToElementAndLeftClick, command.moveCursorToElementAndDoubleLeftClick, command.moveCursorToElementAndMiddleClick, command.moveCursorToElementAndRightClick	Left, double-left, middle, or right click after moving to an element
command.moveCursorToTextAndLeftClick, command.moveCursorToTextAndRightClick	Left or right click after moving to text
command.enterGridModeAndLeftClick, command.enterGridModeAndDoubleLeftClick, command.enterGridModeAndMiddleClick, command.enterGridModeAndRightClick	Left, double-left, middle, or right click at a selected grid location

A count of 0 skips clicking and only performs the pointer movement supported by the target. For targets that only support an Accessibility action without pointer movement, that action is also skipped.

Arrow-key commands trigger.up, trigger.down, trigger.left, and trigger.right also accept a repeat count, up to 50. For example, if you assign j to trigger.down, 5j sends five Down Arrow presses. You can keep typing while the repetitions run.

For trigger.scrollUp, trigger.scrollDown, trigger.scrollLeft, and trigger.scrollRight, the number sets the scroll distance in units of 50 pixels. For example, if you assign s to trigger.scrollDown, 3s scrolls down 150 pixels.

Interacting with the System and Foreground Apps

When holding Command , Control , or Option , letter input will not be captured as command sequences, but will be passed as part of a key combination to the system or foreground applications, so you can still use shortcuts like Command + C to copy text or Command + W to close a window.

At the same time, the system can still recognize other keys, such as arrow keys, Enter , Tab , etc., so you can continue using those keys to interact with foreground applications.

The Space key is a bit special. If you want to send a Space key event while staying in Command Mode, press \ .

Caution

This fallback key may change in future versions.

Existing Commands

Command identifiers use the command.* or trigger.* format. You can customize their command sequences or keyboard shortcuts in Settings.

Commands

CommandIdentifier	Action
command.revertCursorLocation	Revert cursor location
command.moveCursorToElement	Move cursor to element
command.moveCursorToElementAndLeftClick	Move cursor to element and left click
command.moveCursorToElementAndDoubleLeftClick	Move cursor to element and double left click
command.moveCursorToElementAndMiddleClick	Move cursor to element and middle click
command.moveCursorToElementAndRightClick	Move cursor to element and right click
command.dragCursorToElement	Drag from the current cursor position to an element
command.moveCursorToText	Move cursor to text
command.moveCursorToTextAndLeftClick	Move cursor to text and left click
command.moveCursorToTextAndRightClick	Move cursor to text and right click
command.dragCursorToText	Drag from the current cursor position to text
command.toggleDrag	Toggle drag
command.enterGridModeAndLeftClick	Enter Grid Mode and left click
command.enterGridModeAndDoubleLeftClick	Enter Grid Mode and double left click
command.enterGridModeAndMiddleClick	Enter Grid Mode and middle click
command.enterGridModeAndRightClick	Enter Grid Mode and right click
command.enterGridModeAndMoveCursor	Enter Grid Mode and move cursor
command.enterGridModeAndDragCursor	Enter Grid Mode and drag from the current cursor position
command.moveAndFocusToWindow	Move and focus to window
command.moveAndFocusToPreviousWindow	Move and focus to previous window
command.enterMoveStage	Enter Mouse Control Mode
command.enterTextMode	Enter Input Mode
command.enterRawInputMode	Enter Raw Input Mode
command.enterScrollMode	Enter scroll mode
command.enterElementMenuModeForFocusedWindow	Enter element menu for focused window
command.enterElementMenuModeForElementBelowCursor	Enter element menu for element below cursor
command.createTextAreaPortal	Edit focused text area in external editor

Key Triggers

CommandIdentifier	Action
trigger.up	Press Up Arrow
trigger.down	Press Down Arrow
trigger.left	Press Left Arrow
trigger.right	Press Right Arrow
trigger.leftClick	Left click
trigger.rightClick	Right click
trigger.middleClick	Middle click
trigger.scrollDown	Scroll down
trigger.scrollUp	Scroll up
trigger.scrollLeft	Scroll left
trigger.scrollRight	Scroll right
trigger.scrollTop	Scroll to top
trigger.scrollBottom	Scroll to bottom
trigger.zoomIn	Zoom in
trigger.zoomOut	Zoom out
trigger.rotateClockwise	Rotate clockwise
trigger.rotateCounterClockwise	Rotate counter-clockwise
trigger.smartZoom	Smart zoom
trigger.forceClick	Force click