New Your team’s decisions, in one playbook every coding agent works from. Never answer your agent twice
// SCAN REPORT

Omarchy-MCP

466 tools. 398 can modify or destroy data without limits.

43 destructive tools with no built-in limits. Policy required.

Last updated:

398 can modify or destroy data
68 read-only
466 tools total

Community server · catalogue entry checked 02/10/2026

How to control Omarchy-MCP ↓

TOOL MAP

What Omarchy-MCP exposes to your agents

Read (68) Write / Execute (355) Destructive / Financial (43)

Running more than one server? Check your whole stack →

MOST DANGEROUS TOOLS
Critical Risk

The most dangerous Omarchy-MCP tools

Destructive · High omarchy_tui_remove_all Irreversibly deletes all installed terminal user interfaces without undo capability. Destructive · High omarchy_webapp_remove_all Irreversibly deletes all installed web applications without per-item confirmation or undo capability. Destructive · Medium reminder_clear Irreversibly deletes all reminders without selective recovery mechanism. Destructive · High omarchy_hibernation_remove Irreversibly removes system hibernation configuration and swap settings; cannot be undone without reinstallation.

398 of Omarchy-MCP's 466 tools can modify, destroy, or commit something on every call — and an agent calls them with no built-in limits.

POLICY

How to control Omarchy-MCP

PolicyLayer is an MCP gateway — it sits between your AI agents and Omarchy-MCP, and nothing reaches the server without passing your rules. These are the rules we recommend:

Deny destructive operations
{
  "omarchy_display_text_size": {
    "deny_if": [
      {
        "conditions": [],
        "on_deny": "Blocked by default. Requires approval."
      }
    ]
  }
}

Destructive tools should never be available to autonomous agents without human approval.

Rate limit write operations
{
  "background_current_details": {
    "limits": [
      {
        "counter": "background_current_details_per_hour",
        "window": "hour",
        "max": 30,
        "scope": "grant"
      }
    ]
  }
}

Prevents bulk unintended modifications from agents caught in loops.

Cap read operations
{
  "audio_devices": {
    "limits": [
      {
        "counter": "audio_devices_per_minute",
        "window": "minute",
        "max": 60,
        "scope": "grant"
      }
    ]
  }
}

Controls API costs and prevents retry loops from exhausting upstream rate limits.

  1. Create a free account and register Omarchy-MCP — nothing to install.
  2. Add these rules — paste them, or build them visually. Tune the limits to your setup.
  3. Point your MCP client (Claude, Cursor, anything) at your gateway URL.
ENFORCE POLICY ON OMARCHY-MCP →

Instant setup, no code required.

FULL CATALOGUE

All 466 Omarchy-MCP tools

DESTRUCTIVE 43 tools
Destructive omarchy_display_text_size Scale text everywhere — omarchy shell, GTK apps, and terminals [group:display] Args: [size|reset] Destructive omarchy_hibernation_remove Remove hibernation setup including swap and boot resume settings [group:hibernation] [sudo] Destructive omarchy_pkg_drop Remove all the named packages from the system if they Destructive omarchy_pkg_remove Show a fuzzy-finder TUI for picking packages installed on the system to be removed. [group:pkg] [sudo] Destructive omarchy_plugin_remove Remove an installed shell plugin [group:plugin] Args: [id] [--yes] Destructive omarchy_refresh_herdr Overwrite the user herdr config with the Omarchy default and reload herdr. [group:refresh] Destructive omarchy_refresh_hyprland Overwrite all the user Hyprland Lua configs in ~/.config/hypr with the Omarchy defaults. [group:refresh] Destructive omarchy_refresh_limine Overwrite the user config for the Limine bootloader and rebuild it. [group:refresh] [sudo] Destructive omarchy_refresh_shell Reset shell.json to Omarchy defaults [group:refresh] Destructive omarchy_reinstall Reinstall Omarchy packages and reset default configs [group:reinstall] [sudo] Destructive omarchy_reinstall_configs Reset Omarchy user configs and shipped defaults in $HOME (destructive) [group:reinstall] Destructive omarchy_reminder Set and show lightweight desktop notification reminders [group:reminder] Args: [-i|--interactive] | <minutes> Destructive omarchy_remove_browser Remove a supported browser and clean up Omarchy browser defaults [group:remove] Args: <chrome|brave|brave-orig Destructive omarchy_remove_dev_env Remove a development environment that was previously installed via omarchy-install-dev-env. [group:remove] Arg Destructive omarchy_remove_gaming_battlenet Remove Battle.net, its Proton prefix, installed games, and desktop entry. [group:remove] Destructive omarchy_remove_gaming_geforce_now Remove the GeForce NOW Flatpak app and its data. [group:remove] Destructive omarchy_remove_gaming_heroic Remove Heroic Games Launcher and its game libraries, configs, and caches. [group:remove] [sudo] Destructive omarchy_remove_gaming_lutris Remove Lutris, Wine, umu-launcher, and all their configs and caches. [group:remove] [sudo] Destructive omarchy_remove_gaming_minecraft Remove the Minecraft launcher along with its worlds, mods, and caches. [group:remove] [sudo] Destructive omarchy_remove_gaming_retroarch Remove RetroArch, all libretro cores, and its config/saves. Leaves ~/Games/roms and ~/Games/bios alone. [group Destructive omarchy_remove_gaming_steam Remove Steam and all of its game libraries, configs, and caches. [group:remove] [sudo] Destructive omarchy_remove_gaming_xbox_cloud Remove the Xbox Cloud Gaming web app. [group:remove] Destructive omarchy_remove_gaming_xbox_controllers Remove the xpadneo Xbox controller driver and undo its module/blacklist config. [group:remove] [sudo] Destructive omarchy_remove_preinstalls Remove preinstalled Omarchy applications (web apps, TUIs, and selected packages). [group:remove] Destructive omarchy_remove_security_fido2 Remove FIDO2 authentication from sudo and polkit [group:remove] [sudo] Destructive omarchy_remove_security_fingerprint Remove fingerprint authentication from sudo, polkit, and lock screen [group:remove] [sudo] Destructive omarchy_remove_security_sshd Disable the OpenSSH server, close the firewall port, and optionally remove authorized keys [group:remove] [sud Destructive omarchy_remove_security_sudoless_docker Disable sudoless Docker by removing your user from the docker group [group:remove] [sudo] Destructive omarchy_remove_service_1password Remove 1Password and its Chromium extension. [group:remove] [sudo] Destructive omarchy_remove_service_dropbox Remove Dropbox and its bar plugin. [group:remove] [sudo] Destructive omarchy_remove_service_sunshine Remove Sunshine and close Omarchy-managed Moonlight streaming ports. [group:remove] [sudo] Destructive omarchy_remove_service_tailscale Remove Tailscale and its bar plugin. [group:remove] [sudo] Destructive omarchy_setup_factory_reset Factory-reset this machine back to its freshly-installed state [group:setup] [sudo] Destructive omarchy_theme_remove Remove a user-installed theme [group:theme] Args: [theme-name] Destructive omarchy_tui_remove Remove a terminal UI desktop launcher [group:tui] Args: [name] Destructive omarchy_tui_remove_all Remove all TUIs installed via omarchy-tui-install. [group:tui] Destructive omarchy_update_orphan_pkgs Review and optionally remove orphaned system packages after updates [group:update] [sudo] Destructive omarchy_update_pkg_prune Prune superseded versions from the pacman package cache [group:update] [sudo] Destructive omarchy_voxtype_remove Remove Voxtype dictation and its configuration [group:voxtype] [sudo] Destructive omarchy_webapp_remove Remove a web app desktop launcher [group:webapp] Args: [name] Destructive omarchy_webapp_remove_all Remove all web apps installed via omarchy-webapp-install. [group:webapp] Destructive refresh_config Reset one known Omarchy configuration target to packaged defaults. Omarchy creates its normal backup. Requires Destructive reminder_clear Clear all pending reminders and verify the store is empty.
EXECUTE 249 tools
Execute agent_grid ONE-CALL agent workspace orchestration. For Execute audio_device_set_default Select an exactly enumerated local output sink or input source, move active streams through Omarchy, verify th Execute audio_output_switch Cycle to Omarchy Execute audio_volume Raise, lower or toggle mute, verify the exact expected PipeWire transition, and restore prior volume/mute stat Execute background_thumbnail_cache_build Build current-theme thumbnails locally through Omarchy and verify its signature, rows and output files afterwa Execute bar_position_set Move the bar to an exact screen edge and verify shell.json afterwards. Execute bar_visibility_set Explicitly show or hide the bar, then verify the on-disk visibility flag. Execute bar_widget_move Move an existing widget to an exact bar section/index and verify its final location. Execute bluetooth_connect Connect to or disconnect a known device by MAC address using Omarchy Execute bluetooth_toggle Use Omarchy Execute brightness_display Read or adjust brightness on the focused display and report the measured value afterwards. Execute capture_region_clipboard Launch Omarchy Execute hypr_dispatch Run any Hyprland dispatcher via the Omarchy Lua API. Expression must start with Execute image_to_ascii Convert an absolute local PNG or SVG with Omarchy Execute input_device_control Read or explicitly enable/disable the locally detected touchpad or touchscreen using Omarchy Execute launch_app Dispatch an installed local app through Omarchy with detached closed stdio, then verify a new mapped window or Execute layout_grid Force an explicit C x R cell grid on the active workspace (e.g. 4x4). Omit both to return to aspect-aware auto Execute layout_mode Switch the active workspace between layout modes of the native Lua grid: Execute layout_preselect Choose which side of the focused tile the NEXT opened window will occupy. Chain with open_window for split lay Execute layout_swap_windows Exchange the grid/master placement order of two windows by their positions in layout_order (1-based). Verified Execute layout_togglesplit Flip the split orientation of the active workspace (horizontal <-> vertical). Execute layout_tomaster In master mode, move the Nth window (see layout_order) into the full-height left column; the remaining windows Execute local_tui_launch Launch a supported local TUI in Omarchy Execute local_utility_open Open About or Files using local installed commands, or focus an exact existing class. An optional Files direct Execute media_source_switch Cycle the active local MPRIS media source forward/backward, optionally transferring playback, with before/afte Execute media_transcode Transcode one absolute local media path directly with ImageMagick or ffmpeg using Omarchy-equivalent format/re Execute mic_mute_toggle Toggle microphone mute, confirm mute inversion with unchanged PipeWire source volume, and restore the exact pr Execute notification_dismiss Dismiss visible notifications whose headline contains the supplied substring. Execute notification_send Send a local desktop notification and return the daemon-assigned ID. Click commands, remote images, and arbitr Execute omarchy_agent Launch the default coding agent in a terminal [group:agent] Args: [--inline] [--pick] Execute omarchy_agent_crash Diagnose a crashed process with the default coding agent [group:agent] Args: <pid> [comm] [exe] [signal] Execute omarchy_agent_prompt Launch the default coding agent with a prompt [group:agent] Args: [--inline] <prompt...> Execute omarchy_audio_input_mute Toggle microphone mute. Drives the hardware mic-mute LED on laptops that expose one. [group:audio] Execute omarchy_audio_input_set_default Set the default audio input and move active streams [group:audio] Args: <node-id> <source-name> Execute omarchy_audio_output_set_default Set the default audio output and move active streams [group:audio] Args: <node-id> <sink-name> Execute omarchy_audio_output_switch Switch between audio outputs while preserving the mute status [group:audio] Execute omarchy_audio_output_volume Adjust output volume and show the Omarchy OSD [group:audio] Args: <raise|lower|mute-toggle|+N|-N> Execute omarchy_audio_source_switch Cycle to the next media source and transfer playback when the current source is playing [group:audio] Args: [n Execute omarchy_audio_tuning Manage the speaker tuning for this laptop [group:audio] Args: <on|off|status|match|fronted-sink> [--force] Execute omarchy_bluetooth_device Control a Bluetooth device [group:bluetooth] Args: [pair|connect|disconnect|forget] <address> Execute omarchy_bluetooth_power Turn Bluetooth on or off, remembered across reboots [group:bluetooth] Args: <on|off|toggle|is-on> Execute omarchy_brightness_display Show or adjust brightness on the focused display. [group:brightness] Args: [--no-osd] [--monitor name] [+N%|N% Execute omarchy_brightness_display_apple Show or adjust Apple Studio Display and Apple XDR Display brightness using asdcontrol. [group:brightness] Args Execute omarchy_brightness_display_ddc Show or adjust DDC/CI display brightness for a Hyprland monitor. [group:brightness] Args: <monitor> [+N%|N%-|N Execute omarchy_brightness_keyboard Adjust keyboard backlight brightness using available steps. [group:brightness] Args: [--no-osd] <up|down|cycle Execute omarchy_brightness_keyboard_mute Set the mic-mute indicator LED on laptops that expose a platform::micmute LED node. [group:brightness] Args: < Execute omarchy_capture_screenrecording Start or stop screen recording [group:capture] Args: [--fullscreen] [--with-desktop-audio] [--with-microphone- Execute omarchy_capture_screenrecording_with_webcam Pick a webcam and start a screen recording with it [group:capture] Execute omarchy_capture_webcam_resize Resize the active webcam recording overlay [group:capture] Args: <smaller|larger|reset|small|medium|large> Execute omarchy_default_agent Set and launch the default coding agent [group:default] Args: [pi|omp|opencode|claude|codex|grok|gemini|copilo Execute omarchy_dev_benchmark_cli Measure Omarchy CLI response times [group:dev] Args: [--repeat=<count>] Execute omarchy_dev_benchmark_theme_switcher Measure theme switcher cache and selector prep times [group:dev] Args: [--repeat=<count>] [--keep-cache] Execute omarchy_dev_install_ydoo Install and enable ydotool mouse automation for Omarchy development [group:dev] [sudo] Execute omarchy_dev_link Point Omarchy at a local checkout after reboot [group:dev] Args: <path-to-checkout> [--no-reboot] Execute omarchy_dev_pkg_test Build and install an Omarchy package from a local checkout [group:dev] Args: [package-name] [path-to-checkout] Execute omarchy_dev_theme_preview Preview an Omarchy theme palette in the terminal [group:dev] Args: [theme-name|theme-dir|colors.toml] [--no-co Execute omarchy_dev_ui_preview Open the omarchy-shell dev gallery (qs.Ui kit preview) [group:dev] Args: [section] Execute omarchy_disk_speedtest Measure live disk read and write speed [group:disk] Args: [target-dir] Execute omarchy_drive_password Set a new encryption password for a drive selected. [group:drive] [sudo] Execute omarchy_exec Scan-validated generic executor for the 356 installed Execute omarchy_hibernation_setup Set up hibernation with swap and boot resume configuration [group:hibernation] Args: [--force] [--no-rebuild] Execute omarchy_hook Run a named hook from ~/.config/omarchy/hooks/<name> and ~/.config/omarchy/hooks/<name>.d/. [group:hook] Args: Execute omarchy_hw_recover_internal_monitor Clear the internal-monitor-disable toggle if no external display is connected. [group:hw] Execute omarchy_hyprland_focus_app Focus a Hyprland window by application identity [group:hyprland] Args: <app-name> Execute omarchy_hyprland_monitor_internal Enable, disable, toggle, or recover the internal laptop display [group:hyprland] Args: <on|off|toggle|recover> Execute omarchy_hyprland_monitor_internal_mirror Enable, disable, toggle, or recover mirroring the internal display to an external monitor [group:hyprland] Arg Execute omarchy_hyprland_monitor_scaling Show, set, or adjust focused Hyprland monitor scaling [group:hyprland] Args: [up|down|SCALE] Execute omarchy_hyprland_monitor_watch Watch Hyprland monitor events and recover monitor toggles when a monitor is removed [group:hyprland] Execute omarchy_hyprland_toggle Toggle permanent Hyprland flags by copying them into a directory that Execute omarchy_hyprland_window_gaps_toggle Toggles the window gaps globally between no gaps and the default. [group:hyprland] Execute omarchy_hyprland_window_pop Toggle to pop-out a tile to stay fixed on a display basis. [group:hyprland] Args: [width height x y] Execute omarchy_hyprland_window_single_square_aspect_toggle Toggle single-window square aspect ratio. [group:hyprland] Execute omarchy_hyprland_window_tiled_fullscreen_toggle Toggle tiled fullscreen for the focused Hyprland window [group:hyprland] Execute omarchy_hyprland_window_transparency_toggle Toggles transparency for the currently focused window. [group:hyprland] Execute omarchy_hyprland_window_width Save or restore the focused Hyprland window width [group:hyprland] Args: <save|restore> Execute omarchy_hyprland_workspace_layout_toggle Toggle the layout on the current active workspace between dwindle and scrolling [group:hyprland] Execute omarchy_install_ai_chatgpt Install the ChatGPT desktop app [group:install] [sudo] Execute omarchy_install_and_launch Install a packaged app and launch it once it finishes [group:install] Args: <display-name> <packages> <desktop Execute omarchy_install_app Install a packaged app, surfacing the install in a floating terminal [group:install] Args: <display-name> <pac Execute omarchy_install_browser Install a supported browser [group:install] Args: <chrome|brave|brave-origin|edge|firefox|zen> Execute omarchy_install_chromium_copy_url Install the native messaging host for the Copy URL Chromium extension [group:install] Execute omarchy_install_chromium_google_account Allow Chromium to sign in to Google accounts by adding the required OAuth credentials [group:install] Execute omarchy_install_chromium_ytdlp Install the native messaging host for the yt-dlp Chromium extension [group:install] Execute omarchy_install_dev_env Install a supported development environment [group:install] Args: <ruby|node|bun|deno|go|laravel|symfony|php|p Execute omarchy_install_docker_dbs Install one of the supported databases in a Docker container with the suitable development options. [group:ins Execute omarchy_install_editor_emacs Install Emacs with Omarchy theme and font integration via the omarchy-emacs AUR package [group:install] Execute omarchy_install_editor_helix Install Helix and configure it to use the current Omarchy theme [group:install] Execute omarchy_install_editor_vscode Install VS Code and configure Omarchy defaults for secrets, updates, and theme [group:install] Execute omarchy_install_editor_zed Install Zed Editor and configure it with the current Omarchy theme [group:install] Execute omarchy_install_font Install a Nerd Font package and switch the system to it [group:install] Args: <display-name> <package> <family Execute omarchy_install_gaming_battlenet Install Battle.net standalone via umu-launcher + GE-Proton (no Steam, no Lutris, no Heroic). [group:install] [ Execute omarchy_install_gaming_geforce_now Install and launch Geforce Now. [group:install] Execute omarchy_install_gaming_gpu_lib32 Install lib32 graphics drivers (Vulkan + NVIDIA) for any detected GPUs. [group:install] [sudo] Execute omarchy_install_gaming_heroic Install Heroic Games Launcher (Epic, GOG, Amazon Prime Gaming) with graphics drivers. [group:install] [sudo] Execute omarchy_install_gaming_lutris Install Lutris with Wine + DXVK for running Windows games (Battle.net, EA, Ubisoft Connect, etc.) [group:insta Execute omarchy_install_gaming_retroarch Install RetroArch with the full libretro core set plus FBNeo and a ~/Games ROM directory. [group:install] Execute omarchy_install_gaming_steam Install Steam and graphics drivers selected for this system [group:install] [sudo] Execute omarchy_install_gaming_xbox_cloud Install Xbox Cloud Gaming as a web app and launch it. [group:install] Execute omarchy_install_gaming_xbox_controllers Install support for using Xbox controllers with Steam/RetroArch/etc. [group:install] [sudo] Execute omarchy_install_preinstalls Restore the preinstalled Omarchy applications (web apps, TUIs, and selected packages). [group:install] [sudo] Execute omarchy_install_service_1password Install 1Password and its Chromium extension. [group:install] [sudo] Execute omarchy_install_service_dropbox Install and start the Dropbox service. Must then be authenticated via the web. [group:install] Execute omarchy_install_service_nordvpn Install the NordVPN service with optional GUI. [group:install] [sudo] Execute omarchy_install_service_once Install the ONCE service, enable its background service, and launch the TUI. [group:install] [sudo] Execute omarchy_install_service_signal Install Signal and launch it. [group:install] [sudo] Execute omarchy_install_service_spotify Install Spotify. [group:install] [sudo] Execute omarchy_install_service_sunshine Install Sunshine and open Moonlight streaming ports for LAN and Tailscale. [group:install] [sudo] Execute omarchy_install_service_tailscale Install the Tailscale mesh VPN service and a web app for the Tailscale Admin Console. [group:install] [sudo] Execute omarchy_install_terminal Install one of the approved terminals and set it as the default for Omarchy (Super + Return etc). [group:insta Execute omarchy_launch_1password Launch 1Password or start its installer when missing. [group:launch] Execute omarchy_launch_about Launch the fastfetch TUI that gives information about the current system. [group:launch] Execute omarchy_launch_battlenet Launch the installed Battle.net client via umu-launcher + GE-Proton. [group:launch] Args: [--with-mangohud] Execute omarchy_launch_browser Launch the default browser as determined by xdg-settings. [group:launch] Args: [url] Execute omarchy_launch_config_editor Open a config file in the user Execute omarchy_launch_discord_community Open the Omarchy Discord community in the Discord app or a browser. [group:launch] Execute omarchy_launch_editor Launch the default editor selected via Omarchy defaults. [group:launch] Args: [--inline] <path> Execute omarchy_launch_floating_terminal_with_presentation Launch a floating terminal with the Omarchy presentation wrapper [group:launch] Args: <command> Execute omarchy_launch_nautilus Launch Files [group:launch] Execute omarchy_launch_nautilus_cwd Launch Files in the active terminal Execute omarchy_launch_or_focus Launch an app or focus an existing window matching a pattern [group:launch] Args: <window-pattern> <launch-com Execute omarchy_launch_or_focus_tui Launch a TUI or focus an existing terminal window for it [group:launch] Args: [--app-id=<app-id>] <command> [a Execute omarchy_launch_or_focus_webapp Launch or focus on a given web app identified by the window-pattern. [group:launch] Args: <window-pattern> <ur Execute omarchy_launch_screensaver Launch the Omarchy screensaver in the default terminal on the system with the correct font configuration. [gro Execute omarchy_launch_signal Launch Signal or start its installer when missing. [group:launch] Execute omarchy_launch_spotify Launch Spotify or start its installer when missing. [group:launch] Execute omarchy_launch_terminal Launch a terminal in the active terminal Execute omarchy_launch_terminal_herdr Launch or attach to the persistent herdr session in a terminal [group:launch] Execute omarchy_launch_terminal_tmux Launch or attach to the Work tmux session in a terminal [group:launch] Execute omarchy_launch_tui Launch a TUI command in the default terminal with Omarchy styling [group:launch] Args: [--app-id=<app-id>] <co Execute omarchy_launch_webapp Launch a URL as a web app in the default supported browser [group:launch] Args: <url> Execute omarchy_menu Control the Omarchy menu (toggle / summon / close / refresh) [group:menu] Args: [toggle|summon|close|refresh|p Execute omarchy_menu_clipboard Launch the clipboard manager [group:menu] Execute omarchy_menu_emoji Launch emojis [group:menu] Execute omarchy_menu_file Pick a file from a menu [group:menu] Args: label paths formats [menu args...] Execute omarchy_menu_input Prompt for text input from a menu [group:menu] Args: prompt [menu args...] Execute omarchy_menu_plugin Pick a shell plugin to enable, disable, clone, or remove [group:menu] Args: <enable|disable|clone|remove> Execute omarchy_menu_select Pick one option from a menu [group:menu] Args: prompt [option...] [-- menu args...] Execute omarchy_migrate Run pending Omarchy migrations. [group:migrate] Args: [--pending] Execute omarchy_mise_install Install a small mise-backed wrapper for a given tool. [group:mise] Args: <package> [command-name [bin-name]] Execute omarchy_network_speedtest Measure live internet speed for one direction [group:network] Args: [down|up] Execute omarchy_notification_dismiss Dismiss a notification by summary substring. Used by the first-run notifications to dismiss them after clickin Execute omarchy_notification_send Send an Omarchy desktop notification [group:notification] Args: [--app-name <app-name>] [-g <glyph>] [-u <low| Execute omarchy_notification_weather Toggle the current weather panel [group:notification] Execute omarchy_osd Show the Omarchy Quickshell on-screen display [group:osd] Args: [-i|--icon <icon>] [-m|--message <text>] [-p|- Execute omarchy_pkg_add Install Arch packages if they are missing [group:pkg] Args: <packages...> [sudo] Execute omarchy_pkg_aur_add Add the named packages to the system from the AUR if they Execute omarchy_pkg_aur_install Show a fuzzy-finder TUI for picking new AUR packages to install. [group:pkg] [sudo] Execute omarchy_pkg_install Show a fuzzy-finder TUI for picking new Arch and OPR packages to install. [group:pkg] [sudo] Execute omarchy_plugin_add Add a shell plugin from git [group:plugin] Args: [git-url] [--enable] [--yes] Execute omarchy_plugin_disable Disable a shell plugin [group:plugin] Args: <id> Execute omarchy_plugin_enable Enable a shell plugin [group:plugin] Args: <id> [placement] Execute omarchy_plugin_update Update installed git-managed plugins [group:plugin] Args: [id] [--yes] Execute omarchy_plymouth_preview Preview a Plymouth boot screen with custom colors and logo [group:plymouth] Args: <background-hex> <text-hex> Execute omarchy_plymouth_reset Restore the default Omarchy Plymouth boot theme and SDDM login screen [group:plymouth] [sudo] Execute omarchy_plymouth_set_by_theme Set the Plymouth boot theme from an Omarchy theme [group:plymouth] Args: <theme-name> [sudo] Execute omarchy_plymouth_switcher Open the Plymouth unlock screen switcher [group:plymouth] Execute omarchy_powerprofiles_init Set the correct power profile on boot based on current AC/battery state. [group:powerprofiles] Execute omarchy_powerprofiles_set Set and remember the power profile for AC or battery use [group:powerprofiles] Args: [autodetect|ac|battery] [ Execute omarchy_refresh_applications Ensure default application launchers and mise wrappers are installed. [group:refresh] Execute omarchy_refresh_hyprsunset Overwrite the user config for hyprsunset with the Omarchy default and restart the service. [group:refresh] Execute omarchy_refresh_pacman Overwrite the package configuration for /etc/pacman with the Omarchy default of using its dedicated mirrors an Execute omarchy_refresh_sddm Refresh the SDDM theme from default [group:refresh] [sudo] Execute omarchy_reinstall_pkgs Reinstall all default Omarchy packages from the stable channel [group:reinstall] [sudo] Execute omarchy_restart_app Restart an application by killing it and relaunching via uwsm. [group:restart] Args: <application-name> [appli Execute omarchy_restart_audio Restart audio services and recover stuck USB audio devices. [group:restart] Execute omarchy_restart_bluetooth Unblock and restart the bluetooth service. [group:restart] Execute omarchy_restart_btop Reload btop configuration (used by the Omarchy theme switching). [group:restart] Execute omarchy_restart_helix Reload Helix configuration [group:restart] Execute omarchy_restart_herdr Reload herdr if running with the latest configuration [group:restart] Execute omarchy_restart_hyprctl Reload hyprland configuration (used by the Omarchy theme switching). [group:restart] Execute omarchy_restart_hyprsunset Restart the hyprsunset service (used for blue light filtering/night light). [group:restart] Execute omarchy_restart_opencode Reload opencode configuration (used by the Omarchy theme switching). [group:restart] Execute omarchy_restart_shell Restart the Omarchy shell [group:restart] Execute omarchy_restart_terminal Reload supported terminal emulators after config changes [group:restart] Execute omarchy_restart_tmux Restart tmux if running with the latest configuration [group:restart] Execute omarchy_restart_trackpad Reset the trackpad by unbinding and rebinding its driver. [group:restart] [sudo] Execute omarchy_restart_wifi Unblock and restart the Wi-Fi service. [group:restart] Execute omarchy_restart_xcompose Restart the XCompose input method service (fcitx5) to apply new compose key settings. [group:restart] Execute omarchy_screensaver Run the Omarchy screensaver using random effects from TTE. [group:screensaver] Execute omarchy_setup_direct_boot Add or remove an EFI boot entry for the Omarchy UKI, allowing the system to boot directly [group:setup] [sudo] Execute omarchy_setup_security_fido2 Set up FIDO2 authentication for sudo and polkit [group:setup] [sudo] Execute omarchy_setup_security_fingerprint Set up fingerprint authentication for sudo, polkit, and lock screen [group:setup] [sudo] Execute omarchy_setup_security_sshd Set up the OpenSSH server, open the firewall, and authorize an SSH key [group:setup] Args: [--key=<public-key> Execute omarchy_setup_security_sudoless_docker Enable sudoless Docker by adding your user to the docker group (root-equivalent!) [group:setup] [sudo] Execute omarchy_share Share clipboard, files, or folders with LocalSend [group:share] Args: <clipboard|file|folder> [path...] Execute omarchy_shell Send an IPC call to the running Omarchy shell [group:shell] Args: [-q] <target> <method> [args...] Execute omarchy_sudo_keepalive Prompt for sudo once and keep the credential alive in the background. [group:sudo] [sudo] Execute omarchy_sudo_passwordless Toggle passwordless sudo for the current user. [group:sudo] Args: [MINUTES] [sudo] Execute omarchy_system_lock Lock the computer and turn off the display [group:system] Execute omarchy_system_logout Log out after closing application windows [group:system] Execute omarchy_system_wake Wake displays and restore brightness after idle [group:system] Execute omarchy_theme_bg_cache Cache background switcher thumbnails for the current theme [group:theme] Execute omarchy_theme_bg_switcher Open the Omarchy background switcher [group:theme] Execute omarchy_theme_install Install a theme from a git repository [group:theme] Args: [git-repo-url] Execute omarchy_theme_refresh Refresh the current theme from its templates. [group:theme] Execute omarchy_theme_set Apply an Omarchy theme [group:theme] Args: <theme-name> Execute omarchy_theme_switcher Open the Omarchy theme switcher [group:theme] Execute omarchy_toggle Toggle Omarchy features between enabled and disabled [group:toggle] Args: <flag-name> [toggle|on|off] Execute omarchy_toggle_bar Toggle bar visibility without killing the Omarchy shell [group:toggle] Args: [toggle|on|off] Execute omarchy_toggle_hybrid_gpu Toggle dedicated vs integrated GPU mode via supergfxd (for hybrid gpu laptops, like Asus G14). [group:toggle] Execute omarchy_toggle_idle Toggle idle behavior so the system either idles normally or stays awake [group:toggle] Args: [toggle|stay-awak Execute omarchy_toggle_nightlight Toggle nightlight screen temperature [group:toggle] Args: [--status] Execute omarchy_toggle_notification_silencing Toggle notification do-not-disturb mode [group:toggle] Execute omarchy_toggle_screensaver Toggle screensaver availability [group:toggle] Execute omarchy_toggle_suspend Toggle suspend availability in the system menu [group:toggle] Execute omarchy_toggle_touchpad Enable, disable, or toggle the touchpad [group:toggle] Args: [on|off|toggle] Execute omarchy_toggle_touchscreen Enable, disable, or toggle the touch functionality of the screen [group:toggle] Args: [on|off|toggle] Execute omarchy_transcode Transcode pictures and videos for sharing [group:transcode] Args: [--path path] [input] [format] [resolution] Execute omarchy_update Update Omarchy and system packages [group:update] Args: [-y] [sudo] Execute omarchy_update_aur_pkgs Update AUR packages if any are installed [group:update] Execute omarchy_update_confirm Prompt for confirmation before starting an update [group:update] Execute omarchy_update_firmware Update system firmware using fwupd. Ensures the fwupd EFI binary is installed [group:update] [sudo] Execute omarchy_update_keyring Ensure the Omarchy and Arch keyring packages are installed and populated [group:update] [sudo] Execute omarchy_update_mise Update mise-managed tools [group:update] Execute omarchy_update_restart Prompt for required reboot or service restarts after updates [group:update] Execute omarchy_update_system_pkgs Update system packages with pacman [group:update] [sudo] Execute omarchy_update_time Restart system time synchronization [group:update] [sudo] Execute omarchy_upgrade_to_quattro Upgrade a legacy Omarchy install to the package-backed Omarchy quattro layout. [group:upgrade] Args: [--yes] [ Execute omarchy_voxtype_install Install and configure Voxtype dictation [group:voxtype] [sudo] Execute omarchy_webapp_handler_hey Open HEY webmail and translate mailto links [group:webapp] Args: [url] Execute omarchy_webapp_handler_zoom Open Zoom web meetings from browser protocol links [group:webapp] Args: [url] Execute omarchy_windows_vm Install, launch, stop, inspect, or remove the Windows VM [group:windows] Args: <install|remove|launch|stop|sta Execute open_window_split Preselect a split direction and launch a command, then VERIFY on-screen that the new window actually tiled int Execute osd_show Display a local Omarchy on-screen message or 0-100 progress value and verify that the OSD opened. Execute pkg_add Install packages through Omarchy, then verify that all are present. Requires enableDangerous. Execute pkg_add_aur Install AUR packages through Omarchy, then verify that all are present. Requires enableDangerous. Execute plugin_local_enable Enable an already-discovered plugin. Bar widgets require an exact section/index; bar replacements are refused. Execute powerprofiles_set Set and remember a profile for the detected, AC, or battery power source; verify active and persistent state, Execute screenrecording_start Start a non-interactive full-screen recording with closed inherited stdio, then confirm one recorder PID, its Execute screenrecording_stop Stop only the exact recorder PID/start-time identity whose Omarchy marker and output path match. Signals never Execute self_window_snap Float + pin + resize + position OUR OWN host window (found via PID lock) to a corner of a monitor, then verify Execute system_power Lock is always available. Reboot and shutdown require enableDangerous because they terminate the desktop sessi Execute theme_bg_next Switch to the next background, verify it, and automatically restore the prior theme and content-identical wall Execute toggle_feature Toggle or explicitly enable/disable nightlight, screensaver availability, or suspend availability. Handles Oma Execute update_system Run the full Omarchy update workflow. It can take many minutes and requires enableDangerous. Execute webcam_overlay_resize Resize the active screen-recording webcam overlay and report its geometry before and after. Execute wifi_connect Activate a saved NetworkManager Wi-Fi connection by its connection name and verify it becomes active. Does not Execute wifi_toggle Turn Wi-Fi on or off and verify the radio state afterwards. Turning it off may disconnect the MCP client. Execute window_float_toggle Toggle a window between floating and tiling. Defaults to the focused window; pass address/match for an explici Execute window_focus Move focus to the neighboring window in a direction. Execute window_fullscreen Toggle fullscreen (real) or maximized (fake). Defaults to the focused window; pass address/match for an explic Execute window_keys One-shot keyboard shortcuts to ANY window: resolve + verify-focus target, then inject keys via wtype. Each ste Execute window_resize Resize by pixel deltas, e.g. x=100 grows right side, x=-100 shrinks. relative=true is implied. Optionally pass Execute window_snap Float + pin + resize + position ANY window to a corner of the focused monitor, then verify on-screen. Target b Execute window_swap Swap a tiled window with its neighbor using a locked address target, then verify geometry changed. Execute window_to_workspace Move a window to another workspace, optionally following focus. Defaults to the focused window; pass address/m Execute window_type One-shot text input to ANY window: resolve target (match/address), focus it with measured verification, then t Execute workspace_layout Switch a workspace between the MCP grid, Hyprland dwindle, master, or scrolling tiling engine and verify tiled
WRITE 106 tools
Write background_current_details Report the current background Write background_set_local Set one strictly validated absolute local image as the background and confirm the Omarchy state symlink. Never Write bar_transparency_set Set bar transparency explicitly (never toggle blindly), then verify shell.json. Write display_text_size Read, preview, set, or reset Omarchy Write font_set Resolve an installed font, apply and verify its exact canonical name, and automatically restore the prior exac Write local_config_open Open one existing readable local file in a supported configured terminal editor under a deterministic Omarchy Write notification_dnd_set Set Omarchy notification silencing explicitly and verify the resulting state. Write omarchy_agent_usage_update Regenerate the AI agent usage data files [group:agent] Args: [--force] [--limits-only] [--except <agent>] [age Write omarchy_audio_output_sink Print the sink whose volume and mute a given output really uses [group:audio] Args: [sink-name] Write omarchy_audio_sink_availability Print PulseAudio sink availability for the shell [group:audio] Write omarchy_bar Configure the bar and its widget layout [group:bar] Args: use <id> | reset | defaults | position <top|bottom|l Write omarchy_battery_present Returns true if a battery is present on the system. [group:battery] Write omarchy_branding_about Edit, set, or reset About branding [group:branding] Args: <image|text|reset> Write omarchy_branding_screensaver Edit, set, or reset screensaver branding [group:branding] Args: <image|text|reset> Write omarchy_capture_qr Decode a QR code from a screenshot region [group:capture] Write omarchy_capture_text Extract text from a screenshot region with OCR [group:capture] Write omarchy_channel_current Print the active Omarchy package channel [group:channel] Write omarchy_channel_set Set the Omarchy package channel. [group:channel] Args: <stable|rc|edge|dev> [sudo] Write omarchy_cmd_missing Check whether any required commands are missing [group:cmd] Write omarchy_cmd_present Check whether all required commands are available [group:cmd] Write omarchy_default_browser Set the default browser for Omarchy and XDG handlers [group:default] Args: [chromium|chrome|brave|brave-origin Write omarchy_default_editor Set the default editor used by omarchy-launch-editor [group:default] Args: [code|cursor|zed|sublime_text|helix Write omarchy_default_set Set a locally available browser, editor, terminal, or coding-agent default with before/after verification and Write omarchy_default_terminal Set the default terminal used by xdg-terminal-exec [group:default] Args: [alacritty|foot|ghostty|kitty] Write omarchy_dev_add_migration Create a new Omarchy migration in the current source tree. [group:dev] Args: [--no-edit] Write omarchy_dev_font Add branded glyphs to the Omarchy icon font [group:dev] Args: [list|add] <name> <svg-file-or-url> [--codepoint Write omarchy_dev_unlink Restore Omarchy to the package install after reboot [group:dev] Args: [--no-reboot] Write omarchy_dns Show or configure the system DNS provider [group:dns] Args: [Cloudflare|Google|DHCP|Custom] Write omarchy_drive_info Print drive information such as size, model, and mount details [group:drive] Args: <drive> Write omarchy_drive_select Select a drive from a list with info that includes space and brand. Used by omarchy-drive-password. [group:dri Write omarchy_file_select Pick files with the desktop file chooser [group:file] Args: [--title <title>] [--multiple] [--directory] [--ex Write omarchy_font_set Set the system monospace font [group:font] Args: <font-name> Write omarchy_games_retro_install Create a desktop launcher for a RetroArch game [group:games] Args: [core path-to-game] Write omarchy_hibernation_available Check if hibernation is supported [group:hibernation] Write omarchy_hook_install Install a hook into ~/.config/omarchy/hooks/<type>.d/ [group:hook] Args: <type> <file> Write omarchy_hw_asus_expertbook_b9406 Detect ASUS ExpertBook B9406 series laptops on Intel Panther Lake. [group:hw] Write omarchy_hw_asus_rog Detect whether the computer is an Asus ROG machine. [group:hw] Write omarchy_hw_asus_zenbook_ux5406aa Detect ASUS Zenbook UX5406AA series laptops on Intel Panther Lake. [group:hw] Write omarchy_hw_dell_xps_haptic_touchpad Match Dell XPS systems with the Synaptics haptic touchpad. [group:hw] Write omarchy_hw_dell_xps_oled Match Dell XPS systems with LG OLED panel on Intel Panther Lake (Xe3) GPU. [group:hw] Write omarchy_hw_display Print the most likely display backlight device. [group:hw] Write omarchy_hw_external_monitors Returns true when an external monitor is physically connected. [group:hw] Write omarchy_hw_framework16 Detect whether the computer is a Framework Laptop 16. [group:hw] Write omarchy_hw_hybrid_gpu Detect whether the system has an active hybrid GPU configuration [group:hw] Write omarchy_hw_intel Detect whether the computer has an Intel CPU. [group:hw] Write omarchy_hw_intel_ptl Detect whether the computer has an Intel Panther Lake GPU. [group:hw] Write omarchy_hw_intel_sof Detect an Intel SOF-capable audio DSP [group:hw] Write omarchy_hw_laptop Returns true when running on a laptop (has a lid or laptop chassis). [group:hw] Write omarchy_hw_match Match against the computer Write omarchy_hw_nvidia Detect whether the computer has an NVIDIA GPU. [group:hw] Write omarchy_hw_nvidia_gsp Detect whether the computer has an NVIDIA GPU with GSP firmware (Turing or newer). [group:hw] Write omarchy_hw_nvidia_without_gsp Detect whether the computer has an NVIDIA GPU without GSP firmware (Maxwell/Pascal/Volta). [group:hw] Write omarchy_hw_surface Detect whether the computer is a Microsoft Surface device. [group:hw] Write omarchy_hw_touchpad Print the detected Hyprland touchpad or trackpad device name [group:hw] Write omarchy_hw_touchscreen Print the detected Hyprland touchscreen or tablet device name [group:hw] Write omarchy_hw_vulkan Detect whether Vulkan is available. [group:hw] Write omarchy_hw_webcam Check whether a webcam is available [group:hw] Write omarchy_hyprland_toggle_disabled Check if a Hyprland toggle is currently disabled (missing). [group:hyprland] Args: <flag-name> Write omarchy_hyprland_toggle_enabled Check if a Hyprland toggle is currently enabled. [group:hyprland] Args: <flag-name> Write omarchy_hyprland_window_close_all Close all open windows [group:hyprland] Write omarchy_menu_timezone Select and set the system timezone [group:menu] Write omarchy_migrate_notify Notify the user when Omarchy has pending migrations [group:migrate] Write omarchy_network_password Print the active Wi-Fi connection Write omarchy_network_qr Generate a Wi-Fi QR matrix for the shell [group:network] Args: [--meta] [interface] Write omarchy_pkg_aur_accessible Returns true if the AUR is up and available. [group:pkg] Write omarchy_pkg_missing Returns true if any of the named packages are missing from the system (or false if they Write omarchy_pkg_present Returns true if all of the named packages are installed on the system (or false if any of them are missing). [ Write omarchy_plugin_clone Clone a built-in Omarchy shell plugin into your own config [group:plugin] Args: <source-id> [--edit] Write omarchy_plymouth_set Set the Plymouth boot theme colors and logo [group:plymouth] Args: <background-hex> <text-hex> <path-to-logo.p Write omarchy_power_present Returns true if external power is connected. [group:power] Write omarchy_refresh_chromium Refresh the ~/.config/chromium-flags.conf file from the Omarchy defaults. [group:refresh] Write omarchy_refresh_config Copy a shipped user config from $OMARCHY_PATH/config into ~/.config (backs up your version). [group:refresh] A Write omarchy_refresh_plymouth Overwrite the user config for the Plymouth drive decryption and boot sequence with the Omarchy default and reb Write omarchy_refresh_tmux Overwrite the user tmux config with the Omarchy default and reload tmux. [group:refresh] Write omarchy_system_reboot Reboot after closing application windows [group:system] Write omarchy_system_shutdown Shut down after closing application windows [group:system] Write omarchy_system_stats Print CPU and memory stats for the shell [group:system] Args: [--bar-widget] Write omarchy_tailscale_receive Save incoming Taildrop files and announce them [group:tailscale] Args: [--once] [directory] Write omarchy_tailscale_send Send files to a machine on your tailnet with Taildrop [group:tailscale] Args: <machine> [file...] Write omarchy_theme_bg_install Open the current theme Write omarchy_theme_bg_next Cycle to the next background for the current theme [group:theme] Write omarchy_theme_bg_set Set the current background image [group:theme] Args: <path-to-image> Write omarchy_theme_dir Print the directory holding a theme, preferring a user-installed copy [group:theme] Args: <theme-name> Write omarchy_theme_update Update user-installed git themes [group:theme] Write omarchy_toggle_crash_capture Toggle crash capture notifications [group:toggle] Write omarchy_toggle_enabled Check if a toggle is enabled (flag file exists) [group:toggle] Args: <flag-name> Write omarchy_transcode_ascii Transcode an image into ASCII/Unicode art text [group:transcode] Args: <input-image.svg|png> <output-path> [-- Write omarchy_tui_install Create a desktop launcher for a terminal UI app [group:tui] Args: [name command window-style icon-url-or-name] Write omarchy_update_analyze_logs Check the update log for known failure conditions [group:update] Write omarchy_update_available Check whether Omarchy updates are available. [group:update] Write omarchy_update_dev Update the active Omarchy dev checkout [group:update] Write omarchy_version Print the installed Omarchy version [group:version] Write omarchy_version_channel Print the active Omarchy mirror and package channel [group:version] Write omarchy_version_pkgs Print when system packages were last upgraded [group:version] Write omarchy_voxtype_config Open Voxtype configuration [group:voxtype] Write omarchy_voxtype_model Open Voxtype AI model setup [group:voxtype] Write omarchy_weather_icon Returns a weather condition icon, adjusted for live sunrise and sunset. [group:weather] Write omarchy_weather_location Show or set the location used for weather reports [group:weather] Write omarchy_webapp_install Create a desktop launcher for a web app [group:webapp] Args: [name url icon-url-or-name [custom-exec] [mime-ty Write plugin_local_clone Clone a stock non-service UI plugin from packaged files into the user Write plugin_local_detail Inspect one already-discovered local plugin, its sanitized manifest, runtime state, and bar location. No URLs Write plugin_local_disable Disable a reversible local plugin and verify catalog/bar state. Critical first-party services and active bars Write reminder_set Set a notification reminder after N minutes and verify it appears in the reminder store. Write system_info Print Omarchy debug/system information using safe non-sudo flags. Write theme_set Resolve an installed theme, apply its canonical slug, verify it, and automatically restore the prior theme and Write window_close Close a window by explicit address/match, or the currently focused window if omitted. REFUSES to close this ag
READ 68 tools
Read audio_devices List PipeWire/PulseAudio output sinks and real input sources with stable node IDs, availability, active ports, Read audio_sink_availability List local PulseAudio/PipeWire sinks and whether their ports are available, respecting Omarchy speaker-tuning Read background_thumbnail_cache_status Verify the current theme Read bar_state Read visibility, position, transparency, active bar, and widget layout without changing anything. Read battery_status Return Omarchy Read bluetooth_devices List known Bluetooth devices. Read-only. Read bluetooth_status Report whether the default Bluetooth adapter is powered. Read-only. Read capture_screenshot Take a screenshot. region/windows require an interactive selection. save returns and verifies a PNG path; copy Read desktop_status Read-only snapshot of the desktop: monitors, workspaces and the currently focused window. Call this before/aft Read font_list List monospace fonts available for the terminal/UI in Omarchy. Read hardware_readiness Read battery/power, external-monitor, backlight, hybrid-GPU, and hibernation readiness using only local Omarch Read health_check Diagnose local dependencies, Omarchy/Hyprland runtime access, custom grid-layout installation, and the destruc Read hypr_status Get current Hyprland workspaces and the focused window. Read keyboard_backlight Read or adjust a detected keyboard-backlight LED using Omarchy Read layout_order Debug view: the placement order (and titles) of tiled windows on the active workspace. Position 1 becomes the Read monitor_panel_state Read Omarchy Read notification_dnd_status Read the Omarchy shell notification-silencing state without changing it. Read notification_time Show Omarchy Read omarchy_battery_status Returns a formatted battery status string with percentage and power draw/charge. [group:battery] Args: [--shel Read omarchy_capture_screenshot Take a screenshot [group:capture] Args: [smart|region|windows|fullscreen] [slurp|copy|save] [--editor=<name>] Read omarchy_commands Search the machine-readable command catalog from the installed Omarchy version. Useful for discovering the cor Read omarchy_defaults Read the current browser, editor, terminal, and coding-agent defaults plus locally available supported choices Read omarchy_dev_status Show the current Omarchy dev-link state [group:dev] Read omarchy_font_current Show current monospace font [group:font] Read omarchy_font_list List available monospace fonts [group:font] Read omarchy_games_retro_cores List installed RetroArch core names [group:games] Read omarchy_hyprland_monitor_focused Print the name of the currently focused Hyprland monitor. [group:hyprland] Read omarchy_hyprland_monitor_focused_apple Return success if the focused or named Hyprland monitor is an Apple display. [group:hyprland] Args: [monitor] Read omarchy_hyprland_monitor_laptop Print the name of the built-in laptop display, including disabled outputs. [group:hyprland] Read omarchy_menu_herdr_keybindings Display annotated Herdr keybindings using an interactive search menu. [group:menu] Args: [--print|-p] [--confi Read omarchy_menu_images Open a generic image selector menu [group:menu] Args: [--selected <image>] [--print-name] [--show-labels] [--f Read omarchy_menu_keybindings Display Hyprland keybindings defined in your configuration using an interactive search menu. [group:menu] Read omarchy_menu_tmux_keybindings Display annotated Tmux keybindings using an interactive search menu. [group:menu] Args: [--print|-p] [--config Read omarchy_monitor_state Print monitor panel state for the shell [group:monitor] Read omarchy_network_band Show or pin the Wi-Fi band for the active connection [group:network] Args: [auto|2.4|5|6] Read omarchy_network_status Print active network status for the shell [group:network] Args: [--verbose] Read omarchy_notification_battery Show the current battery status notification [group:notification] Read omarchy_notification_time Show the current time and date notification [group:notification] Read omarchy_plugin_list List discovered shell plugins [group:plugin] Args: [--json] Read omarchy_plugin_validate Validate a plugin folder against the Omarchy plugin manifest schema [group:plugin] Args: <plugin-folder> Read omarchy_plymouth_current Show which theme is styling the Plymouth boot screen [group:plymouth] Read omarchy_plymouth_list List themes that can style the Plymouth boot screen [group:plymouth] Read omarchy_powerprofiles_list Returns a list of all the available power profiles on the system. [group:powerprofiles] Args: [--active-state] Read omarchy_show_done Display a \\\ Read omarchy_snapshot Create or restore system snapshots with snapper [group:snapshot] Args: <create|restore> [sudo] Read omarchy_system_scan Enumerate the 356 installed omarchy routes vs the 108 wrapped MCP tools, plus /usr/share/omarchy/bin count. Re Read omarchy_theme_bg_current Show current background [group:theme] Read omarchy_theme_current Show current theme [group:theme] Read omarchy_theme_extras List the user-installed themes that came from a git clone [group:theme] Read omarchy_theme_list List available themes [group:theme] Read omarchy_toggle_status Read normalized enabled/disabled state for an allow-listed Omarchy feature without changing it. Idle enabled m Read omarchy_version_info Read the installed Omarchy version, active channel, configured mirror/package channel, and timestamp of the la Read omarchy_voxtype_status Stream voxtype --follow status as bar-friendly JSON [group:voxtype] Read omarchy_weather_status Returns a formatted weather status string with temperature and wind speed. [group:weather] Read plugin_list List locally discovered plugins and their state. This performs no install, update, or network access. Read plugin_validate Validate a local plugin folder against Omarchy Read powerprofiles_list List profiles and mark the active one. Read-only. Read reminder_show List pending desktop reminders as structured JSON. Read screenrecording_status Report recorder PIDs, the exact Omarchy marker, PID/output ownership, and measured output safety. Read-only. Read self_window_info Resolve and report the terminal window this agent is running in, by walking PID ancestry — like Windows Read speaker_tuning_status Read Omarchy speaker-tuning installation, service, virtual-sink, default-sink, and hardware-match state. Read- Read system_resource_stats Read Omarchy CPU/memory statistics plus local load averages and uptime. Read-only and offline. Read theme_current Show the name of the currently applied Omarchy theme. Read theme_directory_lookup Resolve and verify a local installed theme directory. Slugs only; no URLs, installation, or downloads. Read theme_list List all available Omarchy themes. Read wifi_list Scan visible networks, de-duplicate SSIDs, and show strongest signal/security. Read-only. Read wifi_status Report Wi-Fi radio state and active Wi-Fi connection names. Read-only. Read window_list List all mapped windows with class, title, pid, workspace and geometry. Use to identify targets before acting.
EXPLORE

Related servers

Other MCP servers with similar tools — same risk classification, starter policies for each.

UnClick 1662 tools
adminautomation
Apibase 1384 tools
adminautomation
Delx Mcp A2a 1068 tools
adminautomation
MCP Framework Personal 912 tools
adminautomation
Hermoso 896 tools
adminautomation
Nodebench 824 tools
adminautomation
Altium-MCP-Suite 817 tools
adminautomation
Eda Agent 777 tools
adminautomation
FAQ

Questions about Omarchy-MCP

Can an AI agent delete data through the Omarchy- MCP server? +

Yes. The Omarchy-MCP server exposes 43 destructive tools including omarchy_display_text_size, omarchy_hibernation_remove, omarchy_pkg_drop. These permanently remove resources with no undo. PolicyLayer blocks destructive tools by default so they never reach the upstream server.

How do I prevent bulk modifications through Omarchy-MCP? +

The Omarchy-MCP server has 106 write tools including background_current_details, background_set_local, bar_transparency_set. Set a rate limit in your policy -- for example, 10 calls per hour prevents an agent from making more than 10 modifications per hour. PolicyLayer enforces this at the gateway, before calls reach Omarchy-MCP.

How many tools does the Omarchy- MCP server expose? +

466 tools across 4 categories: Destructive, Execute, Read, Write. 68 are read-only. 398 can modify, create, or delete data.

How do I enforce a policy on Omarchy-MCP? +

Register the Omarchy- MCP server in PolicyLayer, apply the suggested rules above (adjust the limits to your use case), and point your AI client at the PolicyLayer proxy URL instead of the server directly. Your agents keep the same tools; PolicyLayer evaluates every call against policy before it executes. Nothing to install, live in minutes.

Enforce policy on every Omarchy-MCP tool call.

Deterministic rules across all 466 Omarchy-MCP tools. Per-identity grants. Full audit log. Live in minutes. Nothing to install.

ENFORCE POLICY ON OMARCHY-MCP →

Instant setup, no code required.

466 Omarchy-MCP tools catalogued and risk-classified — across an index of 46,500+ MCP servers.

// WHERE THIS COMES FROM

These policies come from Omarchy-'s registry record.

The record behind this page: verified identity, auth posture, risk grade, every tool classified, recommended policy — re-checked continuously.

Teams ship this data inside their own products. See what a licence covers →

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.