Scripting FAST
Clicks, keyboard shortcuts, Shortcuts actions, Siri, URLs and the bundled fastctl CLI all execute the same typed actions. Placement behaves identically everywhere, and Undo works no matter where the command came from.
One action model, four surfaces
Most window managers bolt automation on afterwards, which is why their CLI and their UI slowly disagree about what a command means. In FAST there is one action layer underneath, and every surface is a way of naming an action in it. A Scene restored from a Stream Deck button and the same Scene restored from the menu bar go through identical code, keep identical Undo snapshots, and produce identical geometry.
The command line
fastctl ships with the app as Tools/fastctl. It is a thin zsh adapter: every command below opens the matching fast:// URL, which is why the CLI and the URL scheme can never drift apart. The complete command set:
| Command | What it does |
|---|---|
fastctl arrange | Arrange open windows into the current layout |
fastctl undo | Undo the last geometry-changing action |
fastctl zoom | Toggle Focus Mode for the focused window |
fastctl stack | Show the next window in the current zone |
fastctl focus <left|right|up|down> | Move the focus one tile in that direction |
fastctl move <left|right|up|down> | Move the focused window one tile |
fastctl scene <scene-uuid> | Restore a Scene by its UUID |
The URL scheme
Anything that can open a URL can drive FAST — a bookmark, a note, a Keyboard Maestro macro, another app. Scenes can be addressed by UUID or by name here; fastctl scene takes the UUID.
| URL | What it does |
|---|---|
fast://action/arrange | Arrange open windows into the current layout |
fast://action/undo | Undo the last geometry-changing action |
fast://action/zoom | Toggle Focus Mode |
fast://action/stack | Show the next window in the current zone |
fast://action/focus/left | Move the focus one tile left |
fast://action/move/right | Move the focused window one tile right |
fast://scene/<uuid-or-name> | Restore a Scene |
Shortcuts and Siri
FAST publishes its actions to the Shortcuts app, which also makes them available to Siri. There are four: Arrange into Zones, Focus Mode, Undo and Open Scene. Chain them with the rest of your automation — open the morning Scene when the first calendar event of the day starts, or arrange into zones when you connect to the office display.
Undo covers automation too
A scripted Scene restore is still a geometry change, so it still leaves an Undo snapshot in the same 30-step history as everything else. If a Shortcut fires at the wrong moment, ⌃⌥Z — fast://action/undo, or fastctl undo — puts your windows back.
Every window, exactly where it belongs.
One-time purchase from €29 · 14-day money-back guarantee · macOS 14+