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:

  1. In Neurova Tiles, save the layout.
  2. 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.

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.