Action Syntax

Two protocols for sending input: type:// for literal text and macro:// for keystroke combos.

type:// Protocol

Sends literal text — characters are typed verbatim. No key-name parsing, no combo recognition.

actions:
  tap: "type://hello world"
  tap: "type://🔥"
  tap: "type://:smile:"

macro:// Protocol

Sends keystroke combos and named keys with optional delays.

Single Keys

actions:
  tap: "macro://Escape"
  tap: "macro://Tab"
  tap: "macro://Return"
  tap: "macro://space"
  tap: "macro://Up"
  tap: "macro://Down"
  tap: "macro://Left"
  tap: "macro://Right"

Key Combinations

actions:
  tap: "macro://ctrl+c"
  tap: "macro://ctrl+shift+p"
  tap: "macro://cmd+space"

Platform-Specific

Different shortcuts per OS:

actions:
  tap: 'macro://{"all":"ctrl+shift+p","osx":"cmd+shift+p","windows":"ctrl+shift+p"}'

Delay

Insert delays between actions:

actions:
  tap: "macro://ctrl+a; delay(100ms); ctrl+c; delay(50ms); Down; ctrl+v"

Modifier Keys

• ctrl or control
• alt
• shift
• cmd → Command (macOS), Control (Linux)
• super or win

Key Names

Named keys use XKB names (case-insensitive):

Label	Valid names
Escape	Escape, esc, escape
Tab	Tab, tab
Return/Enter	Return, enter
Backspace	BackSpace, backspace, bs
Delete	Delete, del, delete
Space	space
Home/End	Home, End
Arrow keys	Up, Down, Left, Right
Page Up/Dn	Page_Up, Page_Down
Insert	Insert, ins
Function	F1–F24
Symbols	comma, period, slash, minus, plus, equal, grave, semicolon, apostrophe, bracketleft, bracketright, backslash

Common Shortcuts

Action	Linux	macOS	Windows
Copy	ctrl+c	cmd+c	ctrl+c
Paste	ctrl+v	cmd+v	ctrl+v
Cut	ctrl+x	cmd+x	ctrl+x
Save	ctrl+s	cmd+s	ctrl+s
Open	ctrl+o	cmd+o	ctrl+o
Close	ctrl+w	cmd+w	ctrl+w
Quit	ctrl+q	cmd+q	alt+f4
Command Palette	ctrl+shift+p	cmd+shift+p	ctrl+shift+p