Skip to content

Input Mode

In general, the claw machine starts in Command Mode. If you want to type normally, there are two options:

  1. Exit the claw machine directly.
  2. Enter Input Mode.

If you want to keep the claw machine active while typing normally, enter Input Mode. Input Mode temporarily disables claw machine behaviors so you can type text normally. After you finish typing, press Control + Esc to exit Input Mode and return to Command Mode.

You can enter Input Mode by triggering command.enterTextMode. You can also assign a dedicated shortcut for this mode.

Raw Input Mode is a variant of Input Mode. You can enter it with command.enterRawInputMode, whose default command sequence is I .

In Raw Input Mode, all Input Mode shortcuts are disabled, including the Nano-style shortcuts below. This makes it better for terminals, shells, editors, and other places where the foreground app should receive every key combination directly.

When a secure input field is active, macOS does not let keyboard events flow into Cursor Crane. Cursor Crane will show a secure-input status hint in that situation.

Input Mode now has a richer Nano-style shortcut layer. These shortcuts are disabled in Raw Input Mode, and each one can be customized in Settings > Input.

The Nano shortcut actions are:

ActionDescription
Exit Input ModeExit Input Mode and return to Command Mode
Move LeftMove one character left
Move RightMove one character right
Move UpMove one line up
Move DownMove one line down
Move To Line StartMove to the start of the current line
Move To Line EndMove to the end of the current line
Move To Previous WordMove to the previous word
Move To Next WordMove to the next word
Move To Document StartMove to the start of the document
Move To Document EndMove to the end of the document
Delete BackwardDelete the previous character
Delete ForwardDelete the next character
Delete To Line StartDelete back to the start of the current line
Delete To Line EndDelete forward to the end of the current line
Scroll Cursor To Visible CenterScroll the text cursor back to the visible center
Select Text At CursorSelect the text at the current text cursor location
Move Mouse To CursorMove the mouse to the current text cursor position
Left Click CursorLeft-click at the current text cursor position
Command Left Click CursorCommand-left-click at the current text cursor position
Option Left Click CursorOption-left-click at the current text cursor position
Control Left Click CursorControl-left-click at the current text cursor position
Right Click CursorRight-click at the current text cursor position
Move Cursor To Visible Middle Line StartMove the text cursor to the start of the visible middle line
Show Cursor PositionShow the current text cursor line and column

This page intentionally does not list default bindings. Check Settings > Input for the current shortcuts, especially if you have customized them.

Input Mode also changes the behavior of Page Up and Page Down to use shorter scroll distances for more precise scrolling while typing.

If the focused control is a text area, you can open its content in an external editor with command.createTextAreaPortal.

In Settings > Input, you can choose whether this opens in:

  • A regular app such as TextEdit or another editor that can open plain text files.
  • A terminal app such as Terminal, iTerm2, Warp, Hyper, Kitty, or Ghostty.

When using a terminal target, you can also customize the launch command template.

  • Press Control + Esc to exit Input Mode.
  • Press Shift + Control + Esc to exit the claw machine.