List every macOS Space (desktop) on every display: desktop number, name, note, the apps with windows on it, and which one is active. Read-only. Call this first to get valid Space numbers and names for the other tools. Fails if Spacepal is not running or has not written its list yet.

Return the Space the user is on now: its name and desktop number (one per display). Read-only and cheaper than list_spaces when you only need the active Space.

Show another Space on the user's screen, instantly and without the slide animation. Give a desktop number or name from list_spaces, or "next", "previous" (neighbouring desktop) or "back" (the Space shown before). Changes only what is visible; no windows move. Undo with space="back". Returns the Space now shown; fails if no Space has that name.

Move the user's frontmost window to another Space; the window keeps its size and position. Target is a desktop number or name from list_spaces, or "next"/"previous". The frontmost window is the one the user last focused: from a terminal client that is usually the window they worked in, from Claude Desktop it is Claude's own window. On macOS 14.0-14.4 and 26.4+ the window moves directly; on other versions Spacepal drags it, which takes a moment. Depending on the user's settings the screen may follow the window. Undo by moving it back. Fails if no Space has that name.

Set the name Spacepal shows for a Space in its menu bar, overview and Mission Control. Replaces the old name; an empty name goes back to "Desktop N". The name stays with the Space even if desktops are reordered. Reversible: call again with the old name (get it from list_spaces first). Fails if the Space does not exist.

Set the short note that says what a Space is for, e.g. "Client B invoices"; list_spaces returns it and Spacepal shows it in its overview. Replaces any existing note; empty text removes the note. Reversible by setting the old note again (read it from list_spaces first). Fails if the Space does not exist.

Show Spacepal's full-screen overview of every Space with live previews, for the user to look at and pick from. It is a toggle: calling it while the overview is open closes it. Changes nothing else. Needs Spacepal's trial or a license; without one Spacepal shows its license window instead. To get the Space list as data, use list_spaces.

List the names of the user's saved Spacepal profiles. A profile is a saved set of Space names, colours, notes and automations, such as "Work" and "Home". Read-only. Use it to get a valid name for apply_profile.

Switch to one of the user's saved profiles, replacing the names, colours, notes and automations of every Space with the profile's. If a profile was active, Spacepal first saves the current set under it, so the user can switch back. If none was active, the current names are not saved anywhere and are lost, so ask the user to save them as a profile first. Windows and desktops are not changed. Unlike apply_template, which uses built-in starter names, this uses the user's own saved sets. Get valid names from list_profiles; fails with the list of names if the profile does not exist. Ask the user first.

Name and colour the user's desktops from one of Spacepal's built-in starter templates: Developer, Designer, Freelancer, Student, Streamer. Overwrites the names, colours and notes of the desktops it covers, so ask the user first; to keep the current names they can save them as a profile in Spacepal. If the template needs more desktops than exist, Spacepal shows a dialog on screen asking the user whether to add them. For the user's own saved sets use apply_profile instead.

Switch to a Space and open the apps, URLs and files its Spacepal automation lists, even if they were opened before. Entering the Space also runs its usual on-enter actions, such as a Shortcut. Use it to prepare a workspace; to only change the visible Space use switch_space. Opens apps on the user's Mac, so it cannot be undone automatically. Does nothing beyond switching if the Space has no automation. Fails if the Space does not exist.

Record which Space and screen position every open window has, for the current display setup, so restore_window_layout can put them back. Overwrites the previous manual save for these displays (Spacepal also saves automatically in the background). Moves nothing.

Move open windows back to the Spaces and positions recorded by save_window_layout (or Spacepal's automatic save) for the current display setup. Moving windows between Spaces only works on macOS 14.0-14.4 and 26.4+; on other versions positions are restored but windows stay on their Space. Windows of apps that are not open are skipped; to reopen terminals and Chrome windows use restore_sessions. Spacepal shows how many windows it moved.

Save the terminal windows (with their folders) and Chrome windows (with their tabs) on one Space, or on every Space with all=true, so restore_sessions can reopen them on the right Space after a restart. Replaces the earlier save for those Spaces and drops windows that were closed. Needs Spacepal's trial or a license; without one nothing is saved.

Reopen the terminal and Chrome windows saved by save_sessions, each on the Space it was saved from. Opens new windows, so calling it twice can open duplicates. Needs Spacepal's trial or a license. To move windows that are already open, use restore_window_layout instead.

Resize and move the user's frontmost window on its current display: a half, a quarter, maximized or centred; or, with "next-display", move it to the next display. It stays on the same Space. The frontmost window is the one the user last focused (from Claude Desktop that is Claude's own window). Needs the Accessibility permission Spacepal already asks for. Not undoable as one step; place it again to change it. Use move_window_to_space to send a window to another Space instead. Needs Spacepal 1.2.8 or later.

Turn Spacepal's presentation mode on or off. While it is on, Spacepal shows "Desktop N" instead of Space names and hides notes, badges and window previews in its overview, menu bar and Mission Control, so a screen share shows nothing private. Names and notes are kept and come back when it is turned off; list_spaces still returns the real names. Reversible by calling it again. Needs Spacepal 1.2.8 or later.

Create a new empty desktop at the end of the display the pointer is on. Mission Control opens for a moment while Spacepal adds it. Undo with remove_desktop. Returns the new number of Spaces once Spacepal confirms it.

Close a desktop, as with its close button in Mission Control. Its windows move to another desktop and are not closed, but its Spacepal name, note and automation are lost and cannot be restored automatically. Full-screen Spaces cannot be removed this way. Always ask the user before calling this. Fails if the Space does not exist.