skills.rest
qol-tools
qol-toolsOFFICIAL
Explore all skills by this author →
GitHub

qol-plugin-window-actions

Expose window-actions commands to snap, minimize, restore, and move windows.

Updated Apr 19, 2026
Search Tags:#restore#actions#monitor#window#minimize#snap#qol-tray
One-click install
npx skills add https://github.com/qol-tools/qol-skills --skill qol-plugin-window-actions
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: qol-plugin-window-actions
Source: https://github.com/qol-tools/qol-skills/tree/main/plugins/qol-plugin-window-actions/skills/qol-plugin-window-actions
Command: npx skills add https://github.com/qol-tools/qol-skills --skill qol-plugin-window-actions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Window management tasks for the qol-tray application, including minimizing, restoring, snapping, and moving windows across monitors, are streamlined with a purpose-built plugin.

Core Features & Use Cases

  • Runtime command window-actions exposes actions like snap-left, snap-right, snap-bottom, maximize, minimize, restore, center, and move-monitor-* to manage windows across Linux (X11) and macOS. It enforces a manifest-driven contract and avoids shell entrypoint fallbacks, providing deterministic behavior for window control in desktop environments.

Quick Start

Run the window-actions command to snap, minimize, restore, or move the qol-tray window across monitors.

Frequently Asked Questions about qol-plugin-window-actions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate window snapping and minimizing on Linux X11 and macOS?▼

You can automate window snapping, minimizing, and restoring on Linux X11 and macOS by running the runtime command window-actions, which exposes a structured set of deterministic window management actions.

Can I move a window across monitors without using shell entrypoint fallbacks?▼

Yes, you can move windows across monitors deterministically without shell entrypoint fallbacks by using the manifest-driven move-monitor-* actions provided by the window-actions command.

What window management actions are available for desktop environments?▼

Available window management actions include snap-left, snap-right, snap-bottom, maximize, minimize, restore, center, and move-monitor-* for controlling windows across desktop environments.

Does qol-plugin-window-actions work on both macOS and Linux X11?▼

Yes, qol-plugin-window-actions works on both macOS and Linux X11 environments, providing a manifest-driven contract for deterministic window control across these platforms.

Why does my window management plugin use a manifest-driven contract?▼

The manifest-driven contract enforces deterministic behavior for window control by defining a specific action list, avoiding unpredictable shell entrypoint fallbacks in desktop environments.

What's the best way to snap a qol-tray window to one side of the screen?▼

The best way to snap a qol-tray window is to run the window-actions command with the snap-left or snap-right action, which positions the window deterministically on Linux X11 and macOS.

Related Skills

Explore More Software Engineering Skills→
qol-toolsqol-tools

qol-plugin-os-themes

Configure Linux desktop themes and cursor behavior for qol-tray via xfixes.

Official
Intermediate
joshua3403joshua3403

desktop-app

Guide Electron and Tauri desktop app scaffolding and deployment.

Community
Advanced
qol-toolsqol-tools

qol-tray-release-flow

Enforce release tagging, commit-message rules, and CI triggers for qol-tray.

Official
Advanced
whilpwhilp
9

hammerspoon

Configure Hammerspoon automation workflows for macOS app launching and window switching.

Community
Advanced