Commands and IPC

Grid Screen has no separate command-line interface. The Svelte frontend calls Tauri commands through src/lib/commands.ts.

Command	Purpose
bootstrap	Load settings and layouts, enumerate screens and eligible windows, and return system status.
refresh_windows	Re-enumerate and filter windows for the current workspace.
arrange_windows	Validate a layout, screen, and assignments, then ask the adapter to move each window.
save_layout	Validate and persist a layout.
delete_layout	Remove a layout by id.
get_settings	Read persisted settings.
update_settings	Persist settings from the Settings view.
save_defaults	Persist the current default gap and margin.
get_diagnostics	Return a text report of version, session, window manager, EWMH, XRandR, workspace, and screens.

arrange_windows returns an ArrangeResult with overall success and a per-window status. It can fail before movement for an unknown layout, unknown screen, invalid geometry, a stale window, or an ineligible window.