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.

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.moveCursorToText	Move cursor to text
command.moveCursorToTextAndLeftClick	Move cursor to text and left click
command.moveCursorToTextAndRightClick	Move cursor to text and right click
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.moveAndFocusToWindow	Move and focus to window
command.moveAndFocusToPreviousWindow	Move and focus to previous window
command.enterTextMode	Enter Input Mode
command.enterRawInputMode	Enter Raw Input Mode
command.enterScrollMode	Enter scroll mode
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.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