Commands

Every action has a text form. That’s what config.json binds keys to, and what app/scripts/spacetile-ctl sends:

app/scripts/spacetile-ctl place left

Keys are written modifier-modifier-key in config.json, for example "alt-shift-h": "swap west". Modifiers are ctrl, alt (or opt), shift and cmd. The default keys follow one pattern:

Settings → Keys shows every action grouped by family. Click a shortcut to re-record it, or click a group’s prefix keycaps, hold new modifiers and release to move the whole group.

Other key binders

Raycast, skhd and Karabiner-Elements can run Spacetile’s commands too. To bind them only there, turn off Use Spacetile’s shortcuts at the top of Settings → Keys. Spacetile then registers no shortcuts and keeps yours for when you turn it back on.

From a shell, the app binary passes its arguments to the running Spacetile and exits straight away:

/Applications/Spacetile.app/Contents/MacOS/Spacetile focus west

Link it onto your PATH to call it spacetile:

ln -s /Applications/Spacetile.app/Contents/MacOS/Spacetile /usr/local/bin/spacetile

Raycast

The Spacetile extension has a command for every action in Settings → Keys, each with Raycast’s alias and hotkey fields. Run Command sends any other command, such as load Work.

skhd

In ~/.skhdrc:

alt - h : spacetile focus west
alt - 1 : spacetile space 1
alt + shift - 1 : spacetile send 1
alt + ctrl - h : spacetile place left

Karabiner-Elements

Add a rule under Complex Modifications. Karabiner runs commands without your shell’s PATH, so use the full path:

{
  "description": "Spacetile: ⌥H focuses the window on the left",
  "manipulators": [
    {
      "type": "basic",
      "from": { "key_code": "h", "modifiers": { "mandatory": ["option"] } },
      "to": [{ "shell_command": "/Applications/Spacetile.app/Contents/MacOS/Spacetile focus west" }]
    }
  ]
}

Spaces

Focus

Move

Layout

Place and size

These give the focused window a region of the Space. The other windows keep their own arrangement in what’s left. Where there aren’t enough windows to fill the shape, empty “holes” stand in (see Spaces and layouts). On a floating window they set its frame directly, as Raycast does. They do nothing on a stack-layout Space.

Full screen

Full-screen apps get a Space of their own, which Spacetile shows between the Desktops but doesn’t tile (see Spaces and layouts).

Preselect

Profiles

Spacetile

Unbound by default

Bind any of these in Settings → Keys, or in config.json:

• display next|prev and send display next|prev

• join west|south|north|east

• fullscreen pair and space fullscreen next|prev

• layout float

• rotate 90|180

• retile

• close

• the fixed-fraction and sixth place commands

• the border nudges

Shortcuts from other tools

Settings → Keys → Use Shortcuts From swaps in another window manager’s default shortcuts, mapped onto Spacetile’s commands. Spacetile’s own shortcuts stay for everything the tool doesn’t bind. The few whose keys the tool uses move to new ones in the tool’s style. Edit → Undo takes it back. The maps live in KeyPresets.swift.

No preset:

• Raycast, Moom and yabai ship no default shortcuts. Raycast’s own presets copy Rectangle, Magnet and Spectacle, so choose Rectangle or Spectacle.
• macOS’s built-in tiling uses fn⌃ chords, which global hotkeys can’t register. They work with Spacetile: see macOS tiling.

The other direction: none of these tools’ defaults cover preselect, stack cycling, mirror, rotate, balance, the split toggle, join (except AeroSpace’s service mode), sending across displays while keeping the Desktop, or applying profiles. Those keep Spacetile’s shortcuts.