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
Section titled “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.
Numeric Parameters
Section titled “Numeric Parameters”Some commands accept a number before their command sequence. The command determines what the number does.
For click commands, type the number and the full sequence in Command Mode, then choose a target in the mode that opens. For example, if you assign f to command.moveCursorToElementAndLeftClick:
| Input | Action after selecting a target |
|---|---|
f | Left-click the target once |
2f | Move to the target and double-click |
3f | Move to the target and click three times |
0f | Skip clicking and move the pointer if the target supports pointer movement |
These click commands accept a count of up to 50. A prefix of 1 uses the command default, just as omitting the prefix does. Single-click commands start with one click and dedicated double-click commands default to two. In the mode that opens, press Option + 0–9 to replace the prefix before confirming the target. See how to set the click 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.
For command.moveAndFocusToWindow, the number selects a favorite window. If your Window Mode command sequence is w, type 2w to jump straight to favorite window 2.
Interacting with the System and Foreground Apps
Section titled “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 \ .
Existing Commands
Section titled “Existing Commands”Command identifiers use the command.* or trigger.* format. You can customize their command sequences or keyboard shortcuts in Settings.
Commands
Section titled “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
Section titled “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 |