brand compatibility tool for Hyprland background Computer Use, including browser/Chromium control through Hyprland. Prefer app plus get_app_state/screenshot coordinates; target/x/y global coordinates are only the low-level fallback. Do not use Browser MCP when the user explicitly asks for brand. Do not use the obsolete hyprcum namespace.

List running Hyprland apps/windows available to brand. Start here before choosing a target app unless the user explicitly asks to launch a new app/window.

Open or launch an app through Hyprland and return a window selector. By default this reuses an already running matching window; set reuse_existing=false only when the user explicitly asks for a new instance/window. For browser tasks, use this instead of Browser MCP only when an app launch/open is requested.

Compatibility alias for launch_app.

Get a target app/window screenshot, accessibility tree, and uiHints. Call this before action tools, then use element_index or screenshot/window-relative coordinates. uiHints separates AT-SPI menu entries from tab/ribbon/toolbar controls; do not substitute a same-named menu for a requested tab.

Compatibility alias for get_app_state.

Capture an unoccluded screenshot for an app/window, or the visible compositor if no app is passed. Prefer app over low-level target.

Compatibility alias for screenshot.

Return the current cursor position in monitor, screenshot, or window-relative coordinates.

Compatibility alias for list_apps.

Click a visible element by index, accessible name/text, or screenshot/window-relative coordinates. Element clicks use the native pointer path so the visible agent cursor overlay appears.

Invoke a secondary AT-SPI action exposed by an element.

Activate a global app-menu item from get_app_state. Uses DBusMenu/GMenu when the app exposes a menu model; this is independent of AT-SPI menu roles.

Scroll an element or coordinate in a direction by pages.

Drag from one screenshot/window-relative coordinate to another.

Compatibility alias for click with the left button.

Compatibility alias for click with the right button.

Compatibility alias for click with the middle button.

Compatibility alias for a double left click.

Compatibility alias for a triple left click.

Compatibility alias: move the background pointer to an element or coordinate without clicking.

Compatibility alias for hover.

Compatibility alias for drag using start_coordinate and coordinate.

Type literal text into the target app. Use paste_text for multiline, tabular, CSV/TSV, Unicode-heavy, or long text. method=auto prefers a focused AT-SPI editable control, then uses isolated background key/paste input; method=atspi explicitly requests accessibility text insertion.

Compatibility alias for type_text.

Paste text through the clipboard into the target app. Prefer this for multiline, tabular, CSV/TSV, Unicode-heavy, or long text because it is much faster than key-by-key typing.

Press a key or key-combination, using xdotool-style syntax such as ctrl+v, Return, alt+left, or super+c.

Compatibility alias for press_key. Accepts key, keys, modifiers, keycode, or text.

Set the value of a settable accessibility element.

Compatibility alias: wait for a short duration.

Wait for a Hyprland window or same-process related popup/dialog to appear, then return its app state. Use after actions expected to open dialogs or new windows.

Wait for a target window/dialog to close. If related_to is provided, return the surviving related/root app state.

Return the active desktop-control security policy and readiness diagnostics without exposing secrets.

Create a pending challenge bound to an exact high-risk call. A person must approve it from an independent local TTY before it can authorize the action.

Immediately cancel active background operations. panic latches writes off; cancel is one-shot; resume clears the latch; status is read-only.

Preflight the redacted audit journal and optionally replay only entries that remain safe after identity and policy validation.

Run a local OCR backend on a newly captured, privacy-filtered target screenshot. Returns normalized confidence 0..1, screenshot pixel boxes, and an opaque short-lived ocr_id.

Click OCR text from an opaque current ocr_id. The server revalidates screenshot hash, process identity, and geometry before input.

Render a non-destructive numbered Set-of-Marks overlay for a bound target screenshot and return an opaque marks_id mapping.

Click one bound Set-of-Marks id after live identity, geometry, and screenshot-hash validation.

Atomically resolve and verify an editable target, focus it, refresh state, then input text using auto/AT-SPI/paste/keys.

Run an ordered action sequence. Every step re-enters the ordinary single-tool policy, confirmation, confinement, lease, and audit gateway; nested sequences are rejected.

Targeted, verified Hyprland window management: focus/close/move/resize/minimize/maximize/fullscreen/floating/pin/move_to_workspace.

List Hyprland workspaces; special workspaces are included by default and explicitly identified by Hyprland.

Verified Hyprland workspace switch/create-or-activate/rename and targeted window move. special: selectors retain Hyprland special-workspace semantics.