List all open windows in Niri DE with titles, app IDs, window IDs, workspace IDs, and focus status.

List all workspaces in Niri DE with workspace index, names, output monitors, and active status.

List connected display monitors (outputs) with resolutions, modes, scaling, and focus state.

List open Wayland layer-shell surfaces in Niri (desktop bars, panels, quickshell, notifications).

Get configured keyboard layouts and current active layout index in Niri.

Get detailed information about the currently focused window and currently focused display monitor.

Focus a window in Niri. Provide window_id (numeric ID) OR search_query (matches window title or app_id like 'firefox', 'terminal', 'code').

Switch active workspace in Niri by index number (e.g. '1', '2', '3') or workspace name.

Move currently focused window/column to specified workspace by index or name.

Move focused window or column in specified direction. direction options: 'left', 'right', 'up', 'down', 'first', 'last'

Set focused column width. width options: '50%', '33.333%', '+10%', '-10%', 'switch-preset', or 'expand'.

Close the currently focused window, or close a specific window by its numeric ID.

Reload Niri DE configuration file (config.kdl).

Perform a Niri layout or window action. Examples of action_name:

• 'maximize-column': Toggle maximize column width

• 'toggle-window-floating': Toggle floating window mode

• 'toggle-overview': Toggle desktop overview

• 'center-column': Center focused column on screen

• 'consume-or-expel-window-left': Group/ungroup window

• 'set-column-width': Set width (e.g. args=['50%'])

• 'toggle-column-tabbed-display': Switch column between normal and tabbed mode

Launch a desktop application or shell command in the Niri session (e.g., 'kitty', 'firefox', 'thunar', 'pavucontrol').

Capture a screenshot on Niri DE. target: 'screen' (entire focused monitor) or 'window' (focused window only). Returns path to saved screenshot image file.

Automatically discover all installed CLI utilities, terminal emulators, package managers, Wayland helpers, and desktop monitors installed on the system.

Inspect user default shell, PATH environment, active desktop session, and installed terminal emulators.

Execute any terminal/CLI command in the user's shell environment. Captures stdout, stderr, exit code, and handles timeouts cleanly.

Launch an interactive graphical terminal window (e.g. Alacritty, Kitty, Foot) inside Niri DE session. Optionally pass a command to run inside the terminal window.

Fetch systemd service or kernel logs via journalctl.

Retrieve Arch Linux / CachyOS system hardware overview, OS version, kernel, CPU, GPU, memory, and uptime.

Query Arch Linux / CachyOS pacman package database (search installed packages or remote repositories).

Search Arch User Repository (AUR) & CachyOS software repositories using yay.

Check pending software updates available for Arch Linux / CachyOS.

Manage systemd services on Arch / CachyOS. action: 'status', 'start', 'stop', 'restart', 'enable', 'disable', 'is-active' unit_name: Name of systemd unit (e.g., 'pipewire.service', 'bluetooth', 'networkmanager') user_mode: True for user services (--user), False for system-wide services

List running system processes ordered by CPU/Memory usage or search process by name.

Terminate a running process by its PID using specified signal (SIGTERM or SIGKILL).

Control PipeWire audio volume or muting via wpctl on Arch/CachyOS. action: 'status', 'set_volume', 'toggle_mute' value: Volume percentage integer (e.g. 50, 80) when action is 'set_volume'.

Query or adjust screen brightness using brightnessctl. action: 'get' or 'set' percent: Target brightness percentage integer (1-100) when action is 'set'.

Send a desktop notification to Niri DE via notify-send. urgency: 'low', 'normal', 'critical'

Query active network connections, Wi-Fi, and Ethernet devices using nmcli.

Check battery status, capacity level, and charging state.

Get current text content from the Wayland clipboard (wl-paste).

Set text content into the Wayland clipboard (wl-copy).