High-risk tools in Omarchy-MCP

ONE-CALL agent workspace orchestration. For

Select an exactly enumerated local output sink or input source, move active streams through Omarchy, verify the default, and roll back on mismatch. Supports dry-run.

Cycle to Omarchy

Raise, lower or toggle mute, verify the exact expected PipeWire transition, and restore prior volume/mute state whenever the mutation is not confirmed.

Build current-theme thumbnails locally through Omarchy and verify its signature, rows and output files afterwards.

Move the bar to an exact screen edge and verify shell.json afterwards.

Explicitly show or hide the bar, then verify the on-disk visibility flag.

Move an existing widget to an exact bar section/index and verify its final location.

Connect to or disconnect a known device by MAC address using Omarchy

Use Omarchy

Read or adjust brightness on the focused display and report the measured value afterwards.

Launch Omarchy

Run any Hyprland dispatcher via the Omarchy Lua API. Expression must start with

Convert an absolute local PNG or SVG with Omarchy

Read or explicitly enable/disable the locally detected touchpad or touchscreen using Omarchy

Dispatch an installed local app through Omarchy with detached closed stdio, then verify a new mapped window or a matching existing window gaining focus. Browser URLs and Discord...

Force an explicit C x R cell grid on the active workspace (e.g. 4x4). Omit both to return to aspect-aware auto sizing.

Switch the active workspace between layout modes of the native Lua grid:

Choose which side of the focused tile the NEXT opened window will occupy. Chain with open_window for split layouts, e.g. preselect

Exchange the grid/master placement order of two windows by their positions in layout_order (1-based). Verified with fresh geometry afterwards.

Flip the split orientation of the active workspace (horizontal <-> vertical).

In master mode, move the Nth window (see layout_order) into the full-height left column; the remaining windows stack in the right column.

Launch a supported local TUI in Omarchy

Open About or Files using local installed commands, or focus an exact existing class. An optional Files directory is validated and always opens a new window.

Cycle the active local MPRIS media source forward/backward, optionally transferring playback, with before/after shell status evidence. Supports dry-run.

Transcode one absolute local media path directly with ImageMagick or ffmpeg using Omarchy-equivalent format/resolution settings. No clipboard, notifications, shell, network, ove...

Toggle microphone mute, confirm mute inversion with unchanged PipeWire source volume, and restore the exact prior source state on any failed mutation or verification.

Dismiss visible notifications whose headline contains the supplied substring.

Send a local desktop notification and return the daemon-assigned ID. Click commands, remote images, and arbitrary notify-send options are intentionally unsupported.

Launch the default coding agent in a terminal [group:agent] Args: [--inline] [--pick]

Diagnose a crashed process with the default coding agent [group:agent] Args: <pid> [comm] [exe] [signal]

Launch the default coding agent with a prompt [group:agent] Args: [--inline] <prompt...>

Toggle microphone mute. Drives the hardware mic-mute LED on laptops that expose one. [group:audio]

Set the default audio input and move active streams [group:audio] Args: <node-id> <source-name>

Set the default audio output and move active streams [group:audio] Args: <node-id> <sink-name>

Switch between audio outputs while preserving the mute status [group:audio]

Adjust output volume and show the Omarchy OSD [group:audio] Args: <raise|lower|mute-toggle|+N|-N>

Cycle to the next media source and transfer playback when the current source is playing [group:audio] Args: [next|previous]

Manage the speaker tuning for this laptop [group:audio] Args: <on|off|status|match|fronted-sink> [--force]

Control a Bluetooth device [group:bluetooth] Args: [pair|connect|disconnect|forget] <address>

Turn Bluetooth on or off, remembered across reboots [group:bluetooth] Args: <on|off|toggle|is-on>

Show or adjust brightness on the focused display. [group:brightness] Args: [--no-osd] [--monitor name] [+N%|N%-|N%|off|on]

Show or adjust Apple Studio Display and Apple XDR Display brightness using asdcontrol. [group:brightness] Args: [--no-osd] [+N%|N%-|N%]

Show or adjust DDC/CI display brightness for a Hyprland monitor. [group:brightness] Args: <monitor> [+N%|N%-|N%]

Adjust keyboard backlight brightness using available steps. [group:brightness] Args: [--no-osd] <up|down|cycle|off|restore>

Set the mic-mute indicator LED on laptops that expose a platform::micmute LED node. [group:brightness] Args: <on|off>

Start or stop screen recording [group:capture] Args: [--fullscreen] [--with-desktop-audio] [--with-microphone-audio] [--with-webcam] [--webcam-device=<device>] [--webcam-size=<s...

Pick a webcam and start a screen recording with it [group:capture]

Resize the active webcam recording overlay [group:capture] Args: <smaller|larger|reset|small|medium|large>

Set and launch the default coding agent [group:default] Args: [pi|omp|opencode|claude|codex|grok|gemini|copilot|crush]

Measure Omarchy CLI response times [group:dev] Args: [--repeat=<count>]

Measure theme switcher cache and selector prep times [group:dev] Args: [--repeat=<count>] [--keep-cache]

Install and enable ydotool mouse automation for Omarchy development [group:dev] [sudo]

Point Omarchy at a local checkout after reboot [group:dev] Args: <path-to-checkout> [--no-reboot]

Build and install an Omarchy package from a local checkout [group:dev] Args: [package-name] [path-to-checkout]

Preview an Omarchy theme palette in the terminal [group:dev] Args: [theme-name|theme-dir|colors.toml] [--no-color] [--no-osc|--osc]

Open the omarchy-shell dev gallery (qs.Ui kit preview) [group:dev] Args: [section]

Measure live disk read and write speed [group:disk] Args: [target-dir]

Set a new encryption password for a drive selected. [group:drive] [sudo]

Scan-validated generic executor for the 356 installed

Set up hibernation with swap and boot resume configuration [group:hibernation] Args: [--force] [--no-rebuild] [sudo]

Run a named hook from ~/.config/omarchy/hooks/<name> and ~/.config/omarchy/hooks/<name>.d/. [group:hook] Args: [name] [args...]

Clear the internal-monitor-disable toggle if no external display is connected. [group:hw]

Focus a Hyprland window by application identity [group:hyprland] Args: <app-name>

Enable, disable, toggle, or recover the internal laptop display [group:hyprland] Args: <on|off|toggle|recover>

Enable, disable, toggle, or recover mirroring the internal display to an external monitor [group:hyprland] Args: <on|off|toggle|recover>

Show, set, or adjust focused Hyprland monitor scaling [group:hyprland] Args: [up|down|SCALE]

Watch Hyprland monitor events and recover monitor toggles when a monitor is removed [group:hyprland]

Toggle permanent Hyprland flags by copying them into a directory that

Toggles the window gaps globally between no gaps and the default. [group:hyprland]

Toggle to pop-out a tile to stay fixed on a display basis. [group:hyprland] Args: [width height x y]

Toggle single-window square aspect ratio. [group:hyprland]

Toggle tiled fullscreen for the focused Hyprland window [group:hyprland]

Toggles transparency for the currently focused window. [group:hyprland]

Save or restore the focused Hyprland window width [group:hyprland] Args: <save|restore>

Toggle the layout on the current active workspace between dwindle and scrolling [group:hyprland]

Install the ChatGPT desktop app [group:install] [sudo]

Install a packaged app and launch it once it finishes [group:install] Args: <display-name> <packages> <desktop-id>

Install a packaged app, surfacing the install in a floating terminal [group:install] Args: <display-name> <packages>

Install a supported browser [group:install] Args: <chrome|brave|brave-origin|edge|firefox|zen>

Install the native messaging host for the Copy URL Chromium extension [group:install]

Allow Chromium to sign in to Google accounts by adding the required OAuth credentials [group:install]

Install the native messaging host for the yt-dlp Chromium extension [group:install]

Install a supported development environment [group:install] Args: <ruby|node|bun|deno|go|laravel|symfony|php|python|elixir|phoenix|rust|java|zig|ocaml|dotnet|clojure|scala> [sudo]

Install one of the supported databases in a Docker container with the suitable development options. [group:install] [sudo]

Install Emacs with Omarchy theme and font integration via the omarchy-emacs AUR package [group:install]

Install Helix and configure it to use the current Omarchy theme [group:install]

Install VS Code and configure Omarchy defaults for secrets, updates, and theme [group:install]

Install Zed Editor and configure it with the current Omarchy theme [group:install]

Install a Nerd Font package and switch the system to it [group:install] Args: <display-name> <package> <family>

Install Battle.net standalone via umu-launcher + GE-Proton (no Steam, no Lutris, no Heroic). [group:install] [sudo]

Install and launch Geforce Now. [group:install]

Install lib32 graphics drivers (Vulkan + NVIDIA) for any detected GPUs. [group:install] [sudo]

Install Heroic Games Launcher (Epic, GOG, Amazon Prime Gaming) with graphics drivers. [group:install] [sudo]

Install Lutris with Wine + DXVK for running Windows games (Battle.net, EA, Ubisoft Connect, etc.) [group:install] [sudo]

Install RetroArch with the full libretro core set plus FBNeo and a ~/Games ROM directory. [group:install]

Install Steam and graphics drivers selected for this system [group:install] [sudo]

Install Xbox Cloud Gaming as a web app and launch it. [group:install]

Install support for using Xbox controllers with Steam/RetroArch/etc. [group:install] [sudo]

Restore the preinstalled Omarchy applications (web apps, TUIs, and selected packages). [group:install] [sudo]

Install 1Password and its Chromium extension. [group:install] [sudo]

Install and start the Dropbox service. Must then be authenticated via the web. [group:install]

Install the NordVPN service with optional GUI. [group:install] [sudo]

Install the ONCE service, enable its background service, and launch the TUI. [group:install] [sudo]

Install Signal and launch it. [group:install] [sudo]

Install Spotify. [group:install] [sudo]

Install Sunshine and open Moonlight streaming ports for LAN and Tailscale. [group:install] [sudo]

Install the Tailscale mesh VPN service and a web app for the Tailscale Admin Console. [group:install] [sudo]

Install one of the approved terminals and set it as the default for Omarchy (Super + Return etc). [group:install] Args: <alacritty|foot|ghostty|kitty> [sudo]

Launch 1Password or start its installer when missing. [group:launch]

Launch the fastfetch TUI that gives information about the current system. [group:launch]

Launch the installed Battle.net client via umu-launcher + GE-Proton. [group:launch] Args: [--with-mangohud]

Launch the default browser as determined by xdg-settings. [group:launch] Args: [url]

Open a config file in the user

Open the Omarchy Discord community in the Discord app or a browser. [group:launch]

Launch the default editor selected via Omarchy defaults. [group:launch] Args: [--inline] <path>

Launch a floating terminal with the Omarchy presentation wrapper [group:launch] Args: <command>

Launch Files [group:launch]

Launch Files in the active terminal

Launch an app or focus an existing window matching a pattern [group:launch] Args: <window-pattern> <launch-command>

Launch a TUI or focus an existing terminal window for it [group:launch] Args: [--app-id=<app-id>] <command> [args...]

Launch or focus on a given web app identified by the window-pattern. [group:launch] Args: <window-pattern> <url-and-flags...>

Launch the Omarchy screensaver in the default terminal on the system with the correct font configuration. [group:launch]

Launch Signal or start its installer when missing. [group:launch]

Launch Spotify or start its installer when missing. [group:launch]

Launch a terminal in the active terminal

Launch or attach to the persistent herdr session in a terminal [group:launch]

Launch or attach to the Work tmux session in a terminal [group:launch]

Launch a TUI command in the default terminal with Omarchy styling [group:launch] Args: [--app-id=<app-id>] <command> [args...]

Launch a URL as a web app in the default supported browser [group:launch] Args: <url>

Control the Omarchy menu (toggle / summon / close / refresh) [group:menu] Args: [toggle|summon|close|refresh|ping] [route]

Launch the clipboard manager [group:menu]

Launch emojis [group:menu]

Pick a file from a menu [group:menu] Args: label paths formats [menu args...]

Prompt for text input from a menu [group:menu] Args: prompt [menu args...]

Pick a shell plugin to enable, disable, clone, or remove [group:menu] Args: <enable|disable|clone|remove>

Pick one option from a menu [group:menu] Args: prompt [option...] [-- menu args...]

Run pending Omarchy migrations. [group:migrate] Args: [--pending]

Install a small mise-backed wrapper for a given tool. [group:mise] Args: <package> [command-name [bin-name]]

Measure live internet speed for one direction [group:network] Args: [down|up]

Dismiss a notification by summary substring. Used by the first-run notifications to dismiss them after clicking for action. [group:notification] Args: <summary>

Send an Omarchy desktop notification [group:notification] Args: [--app-name <app-name>] [-g <glyph>] [-u <low|normal|critical>] [-i <icon>] [-t <ms>] [-r <id>] [-p] [--image <pa...

Toggle the current weather panel [group:notification]

Show the Omarchy Quickshell on-screen display [group:osd] Args: [-i|--icon <icon>] [-m|--message <text>] [-p|--progress <0-100>] [-d|--duration <ms>]

Install Arch packages if they are missing [group:pkg] Args: <packages...> [sudo]

Add the named packages to the system from the AUR if they

Show a fuzzy-finder TUI for picking new AUR packages to install. [group:pkg] [sudo]

Show a fuzzy-finder TUI for picking new Arch and OPR packages to install. [group:pkg] [sudo]

Add a shell plugin from git [group:plugin] Args: [git-url] [--enable] [--yes]

Disable a shell plugin [group:plugin] Args: <id>

Enable a shell plugin [group:plugin] Args: <id> [placement]

Update installed git-managed plugins [group:plugin] Args: [id] [--yes]

Preview a Plymouth boot screen with custom colors and logo [group:plymouth] Args: <background-hex> <text-hex> <path-to-logo.png> <output-path>

Restore the default Omarchy Plymouth boot theme and SDDM login screen [group:plymouth] [sudo]

Set the Plymouth boot theme from an Omarchy theme [group:plymouth] Args: <theme-name> [sudo]

Open the Plymouth unlock screen switcher [group:plymouth]

Set the correct power profile on boot based on current AC/battery state. [group:powerprofiles]

Set and remember the power profile for AC or battery use [group:powerprofiles] Args: [autodetect|ac|battery] [power-saver|balanced|performance]

Ensure default application launchers and mise wrappers are installed. [group:refresh]

Overwrite the user config for hyprsunset with the Omarchy default and restart the service. [group:refresh]

Overwrite the package configuration for /etc/pacman with the Omarchy default of using its dedicated mirrors and repositories, then update all packages. [group:refresh] [sudo]

Refresh the SDDM theme from default [group:refresh] [sudo]

Reinstall all default Omarchy packages from the stable channel [group:reinstall] [sudo]

Restart an application by killing it and relaunching via uwsm. [group:restart] Args: <application-name> [application-args...]

Restart audio services and recover stuck USB audio devices. [group:restart]

Unblock and restart the bluetooth service. [group:restart]

Reload btop configuration (used by the Omarchy theme switching). [group:restart]

Reload Helix configuration [group:restart]

Reload herdr if running with the latest configuration [group:restart]

Reload hyprland configuration (used by the Omarchy theme switching). [group:restart]

Restart the hyprsunset service (used for blue light filtering/night light). [group:restart]

Reload opencode configuration (used by the Omarchy theme switching). [group:restart]

Restart the Omarchy shell [group:restart]

Reload supported terminal emulators after config changes [group:restart]

Restart tmux if running with the latest configuration [group:restart]

Reset the trackpad by unbinding and rebinding its driver. [group:restart] [sudo]

Unblock and restart the Wi-Fi service. [group:restart]

Restart the XCompose input method service (fcitx5) to apply new compose key settings. [group:restart]

Run the Omarchy screensaver using random effects from TTE. [group:screensaver]

Add or remove an EFI boot entry for the Omarchy UKI, allowing the system to boot directly [group:setup] [sudo]

Set up FIDO2 authentication for sudo and polkit [group:setup] [sudo]

Set up fingerprint authentication for sudo, polkit, and lock screen [group:setup] [sudo]

Set up the OpenSSH server, open the firewall, and authorize an SSH key [group:setup] Args: [--key=<public-key>] [sudo]

Enable sudoless Docker by adding your user to the docker group (root-equivalent!) [group:setup] [sudo]

Share clipboard, files, or folders with LocalSend [group:share] Args: <clipboard|file|folder> [path...]

Send an IPC call to the running Omarchy shell [group:shell] Args: [-q] <target> <method> [args...]

Display the Omarchy logo in the terminal using green color. [group:show]

Prompt for sudo once and keep the credential alive in the background. [group:sudo] [sudo]

Toggle passwordless sudo for the current user. [group:sudo] Args: [MINUTES] [sudo]

Lock the computer and turn off the display [group:system]

Log out after closing application windows [group:system]

Wake displays and restore brightness after idle [group:system]

Cache background switcher thumbnails for the current theme [group:theme]

Open the Omarchy background switcher [group:theme]

Install a theme from a git repository [group:theme] Args: [git-repo-url]

Refresh the current theme from its templates. [group:theme]

Apply an Omarchy theme [group:theme] Args: <theme-name>

Open the Omarchy theme switcher [group:theme]

Toggle Omarchy features between enabled and disabled [group:toggle] Args: <flag-name> [toggle|on|off]

Toggle bar visibility without killing the Omarchy shell [group:toggle] Args: [toggle|on|off]

Toggle dedicated vs integrated GPU mode via supergfxd (for hybrid gpu laptops, like Asus G14). [group:toggle] [sudo]

Toggle idle behavior so the system either idles normally or stays awake [group:toggle] Args: [toggle|stay-awake|allow-idle|status]

Toggle nightlight screen temperature [group:toggle] Args: [--status]

Toggle notification do-not-disturb mode [group:toggle]

Toggle screensaver availability [group:toggle]

Toggle suspend availability in the system menu [group:toggle]

Enable, disable, or toggle the touchpad [group:toggle] Args: [on|off|toggle]

Enable, disable, or toggle the touch functionality of the screen [group:toggle] Args: [on|off|toggle]

Transcode pictures and videos for sharing [group:transcode] Args: [--path path] [input] [format] [resolution]

Update Omarchy and system packages [group:update] Args: [-y] [sudo]

Update AUR packages if any are installed [group:update]

Prompt for confirmation before starting an update [group:update]

Update system firmware using fwupd. Ensures the fwupd EFI binary is installed [group:update] [sudo]

Ensure the Omarchy and Arch keyring packages are installed and populated [group:update] [sudo]

Update mise-managed tools [group:update]

Prompt for required reboot or service restarts after updates [group:update]

Update system packages with pacman [group:update] [sudo]

Restart system time synchronization [group:update] [sudo]

Upgrade a legacy Omarchy install to the package-backed Omarchy quattro layout. [group:upgrade] Args: [--yes] [--reboot] [--dev] [--channel stable|rc|edge] [--user USER] [sudo]

Install and configure Voxtype dictation [group:voxtype] [sudo]

Open HEY webmail and translate mailto links [group:webapp] Args: [url]

Open Zoom web meetings from browser protocol links [group:webapp] Args: [url]

Install, launch, stop, inspect, or remove the Windows VM [group:windows] Args: <install|remove|launch|stop|status> [options] [sudo]

Preselect a split direction and launch a command, then VERIFY on-screen that the new window actually tiled into that split. Returns the landed window

Display a local Omarchy on-screen message or 0-100 progress value and verify that the OSD opened.

Install packages through Omarchy, then verify that all are present. Requires enableDangerous.

Install AUR packages through Omarchy, then verify that all are present. Requires enableDangerous.

Enable an already-discovered plugin. Bar widgets require an exact section/index; bar replacements are refused. Defaults to dry-run.

Set and remember a profile for the detected, AC, or battery power source; verify active and persistent state, with exact failure rollback. Defaults to dry-run.

Start a non-interactive full-screen recording with closed inherited stdio, then confirm one recorder PID, its Omarchy marker/output relationship, and a nonempty regular MP4. Nev...

Stop only the exact recorder PID/start-time identity whose Omarchy marker and output path match. Signals never use global pkill; unrelated recorders are not touched. Requires a ...

Float + pin + resize + position OUR OWN host window (found via PID lock) to a corner of a monitor, then verify the result. corner: tl=tr/bl=br or center. No focus stealing; targ...

Lock is always available. Reboot and shutdown require enableDangerous because they terminate the desktop session.

Switch to the next background, verify it, and automatically restore the prior theme and content-identical wallpaper after any mutation failure.

Toggle or explicitly enable/disable nightlight, screensaver availability, or suspend availability. Handles Omarchy 4

Run the full Omarchy update workflow. It can take many minutes and requires enableDangerous.

Resize the active screen-recording webcam overlay and report its geometry before and after.

Activate a saved NetworkManager Wi-Fi connection by its connection name and verify it becomes active. Does not accept or create passwords.

Turn Wi-Fi on or off and verify the radio state afterwards. Turning it off may disconnect the MCP client.

Toggle a window between floating and tiling. Defaults to the focused window; pass address/match for an explicit target.

Move focus to the neighboring window in a direction.

Toggle fullscreen (real) or maximized (fake). Defaults to the focused window; pass address/match for an explicit target.

One-shot keyboard shortcuts to ANY window: resolve + verify-focus target, then inject keys via wtype. Each step is a keysym with optional modifiers joined by

Resize by pixel deltas, e.g. x=100 grows right side, x=-100 shrinks. relative=true is implied. Optionally pass address/match to resize an explicit window instead of the focused ...

Float + pin + resize + position ANY window to a corner of the focused monitor, then verify on-screen. Target by exact address or by class/title substring match (e.g. match=

Swap a tiled window with its neighbor using a locked address target, then verify geometry changed.

Move a window to another workspace, optionally following focus. Defaults to the focused window; pass address/match for an explicit target.

One-shot text input to ANY window: resolve target (match/address), focus it with measured verification, then type via wtype. Defaults to the currently focused window if no targe...

Switch a workspace between the MCP grid, Hyprland dwindle, master, or scrolling tiling engine and verify tiledLayout. Use dwindle before layout_preselect/open_window_split; use ...