@@ -177,4 +177,44 @@ In the demo below, we start with a default template applied to the screen and tw
177177
178178![ FancyZones Settings bottom screenshot] ( ../images/pt-fancyzones-settings2.png )
179179
180+ ## Manage FancyZones from the Command Line
181+
182+ The FancyZones CLI lets you apply and manage window layouts directly from the command line.
183+
184+ ** Key capabilities:**
185+ - ASCII art visualization of layouts (grid, focus, priority-grid, canvas)
186+ - Support for both template layouts and custom layouts
187+ - Monitor-specific layout targeting (` --monitor N ` or ` --all ` )
188+ - Real-time notification to FancyZones via Windows messages
189+ - Native AOT compilation support for fast startup
190+
191+ ** Commands:**
192+ | Command | Aliases | Description |
193+ | ---------| ---------| -------------|
194+ | ` help ` | | Displays general help information for all commands |
195+ | ` open-editor ` | ` editor ` , ` e ` | Launch FancyZones layout editor |
196+ | ` get-monitors ` | ` monitors ` , ` m ` | List all monitors and their properties |
197+ | ` get-layouts ` | ` layouts ` , ` ls ` | List all available layouts with ASCII art preview |
198+ | ` get-active-layout ` | ` active ` , ` a ` | Show currently active layout |
199+ | ` set-layout <uuid> ` | ` set ` , ` s ` | Apply layout by UUID or template name |
200+ | ` open-settings ` | ` settings ` | Open FancyZones settings page |
201+ | ` get-hotkeys ` | ` hotkeys ` , ` hk ` | List all layout hotkeys |
202+ | ` set-hotkey <key> <uuid> ` | ` shk ` | Assign hotkey (0-9) to custom layout |
203+ | ` remove-hotkey <key> ` | ` rhk ` | Remove hotkey assignment |
204+
205+ ** Usage example**
206+ ``` bash
207+ # List all layouts with visual previews
208+ FancyZonesCLI.exe ls
209+
210+ # Apply "columns" template to all monitors
211+ FancyZonesCLI.exe s columns --all
212+
213+ # Set custom layout on monitor 2
214+ FancyZonesCLI.exe s {uuid} --monitor 2
215+
216+ # Assign hotkey Win+Ctrl+Alt+3 to a layout
217+ FancyZonesCLI.exe shk 3 {uuid}
218+ ```
219+
180220[ !INCLUDE [ install-powertoys.md] ( ../includes/install-powertoys.md )]
0 commit comments