Verify that Hammerspoon is running and reachable, and report its version. Call this first when any other tool fails, because it distinguishes a setup problem from a tool problem.

Search Hammerspoon's own API documentation for functions, methods, constants, and modules. Returns exact signatures. Use this before writing Lua so calls are correct the first time, rather than discovering a wrong name from a runtime error.

List every visible window with its id, owning application, title, frame, and screen. Window ids are what hs_focus_window and hs_move_window operate on, so call this first.

Bring a window to the front, selected by id (exact) or by a substring of its title. The matched window is returned so you can confirm the right one was chosen.

Set the position and/or size of a window by id, in screen pixels. Omitted fields keep their current value. Use hs_screens to learn the available coordinate space.

Snap a window to a named position such as left-half or quarter-top-left, computed from the screen size so no pixel arithmetic is needed. Defaults to the focused window. Positions respect the menu bar and Dock.

List running applications with pid, bundle identifier, window count, and which one is frontmost.

Launch an application by name, or focus it if it is already running. Use the name as it appears in Finder, for example "Safari".

Bring an already-running application to the front. Unlike hs_launch_app this never starts anything, so it fails if the application is not running.

List connected screens with their coordinate frames. frame excludes the menu bar and Dock, fullFrame includes them. Use these bounds when computing arguments for hs_move_window.

Return the most recent lines from the Hammerspoon console. This is where Lua errors and print output from the user configuration appear, so it is the first place to look when a config change misbehaves.

Display a transient alert on screen through Hammerspoon. Useful for telling the user something without stealing focus.

Reload ~/.hammerspoon/init.lua. Use after editing the user configuration. The reload is scheduled a moment ahead so this call can return first, and it resets all in-memory state held by the configuration.