Guide
Automation and link scheme
Let your work move your windows: run a layout when a focus interval starts, when your AI agent starts working, when a display connects, or from any script.
On this page
With Neurova Awake
Neurova Awake keeps your Mac running while AI agents work, and has a focus timer. It can tell Neurova Tiles to arrange one of your layouts at two moments:
- When a focus interval starts, for example a Focus layout with only your editor and notes.
- When an AI tool starts working, for example an Agent desk layout with the agent’s terminal large and your chat beside it. It runs when the first tool starts, not again for each prompt.
Set it up:
- In Neurova Tiles, save the layout.
- In Neurova Awake, open Settings, then General. Under Arrange windows with Neurova Tiles, type the layout’s name next to When a focus interval starts or When an AI tool starts working.
Leave a field empty to do nothing. Neurova Awake opens the layout’s link in the background, so nothing jumps to the front.
When displays connect
A layout can run by itself when your displays change to the set it was saved with: plug in at your desk and your desk layout appears; unplug and the laptop layout comes back. Arrange when displays connect.
The link scheme
Anything that can open a link can drive Neurova Tiles: Terminal, a script, an AI agent’s hook, Shortcuts, Raycast or Alfred.
| Link | What it does |
|---|---|
neurova-tiles://layout?name=Focus |
Arranges the layout called Focus. |
neurova-tiles://action?name=left-half |
Runs one window action on the front window. |
neurova-tiles://action?name=left-half&app=com.apple.Terminal |
Runs the action on that app’s window, without bringing it to the front. |
neurova-tiles://stash?side=left |
Stashes the front window on the left (side=right for the right). |
neurova-tiles://unstash |
Brings back every stashed window. |
- Layout names don’t care about capitals or accents. Write spaces as
%20:?name=Agent%20desk. Settings, then Layouts, shows each layout’s link ready to copy. - app is the app’s bundle ID. Find it in Terminal with
osascript -e 'id of app "Safari"'. - If Neurova Tiles isn’t running, the link opens it. Links never open a window and can’t change your settings.
- A link Neurova Tiles doesn’t understand does nothing. An unknown layout name, or an app or window that isn’t there, makes the Mac beep.
Action names
| Group | Names |
|---|---|
| Halves | left-half, right-half, center-half, top-half, bottom-half |
| Quarters | top-left, top-right, bottom-left, bottom-right |
| Thirds | first-third, center-third, last-third, first-two-thirds, last-two-thirds |
| Sixths | top-left-sixth, top-center-sixth, top-right-sixth, bottom-left-sixth, bottom-center-sixth, bottom-right-sixth |
| Size | maximize, almost-maximize, maximize-height, center, restore, larger, smaller |
| Displays | next-display, previous-display |
| Move | move-left, move-right, move-up, move-down |
The names use American spelling (center, maximize), like Rectangle’s. Sending the same action
again cycles sizes, as a repeated shortcut does.
From Terminal and scripts
open -g passes the link without bringing Neurova Tiles to the front:
open -g "neurova-tiles://layout?name=Coding"
open -g "neurova-tiles://action?name=left-half&app=com.apple.Terminal"
open -g "neurova-tiles://action?name=right-half&app=com.google.Chrome"
From an AI agent’s hooks
Coding agents such as Claude Code can run a command when a prompt starts. Neurova Awake already uses that to arrange a layout when an agent starts working. Without Neurova Awake, add a hook yourself that runs, for example:
open -g "neurova-tiles://layout?name=Agent%20desk"
From Shortcuts
In the Shortcuts app, add the action Open URLs with a neurova-tiles:// link, such as
neurova-tiles://layout?name=Focus. Run it from the menu bar, a keyboard shortcut, or a Focus
mode automation, so choosing a Focus mode also arranges your windows.
Last updated 18 November 2026
Can't find it here? See Support and FAQ or email support@neurova-ai.com. We reply by email, usually within two working days.