[PR #9954] Add desktop param to globalSummon; set _quake = toCurrent #27825

Open
opened 2026-01-31 09:24:30 +00:00 by claunia · 0 comments
Owner

Original Pull Request: https://github.com/microsoft/terminal/pull/9954

State: closed
Merged: Yes


This adds support for the desktop param to the globalSummon action. It accepts 3 values:

  • toCurrent (default): The window moves to the current desktop when it's summoned
  • any: We don't care what desktop the window is on. We'll go to the desktop the window is on when we summon it.
  • onCurrent: We'll only try to summon the MRU window on this desktop when summoning a window.
    • When combined with name, if there's a window matching name, we'll move it to this desktop.
    • If there's not a window on this desktop, and name is omitted, then we'll make a new window.

quakeMode was also updated to use toCurrent behavior by default.

References

PR Checklist

Detailed Description of the Pull Request / Additional comments

S/O to https://github.com/microsoft/PowerToys, who graciously let us use VirtualDesktopUtils for figuring out what desktop is the current desktop. Yea, that's all we needed that entire file for. No, there isn't an API for this (surprised-pikachu.png)

Validation Steps Performed

Played with this for a while, and it's amazing.

**Original Pull Request:** https://github.com/microsoft/terminal/pull/9954 **State:** closed **Merged:** Yes --- This adds support for the `desktop` param to the `globalSummon` action. It accepts 3 values: * `toCurrent` (default): The window moves to the current desktop when it's summoned * `any`: We don't care what desktop the window is on. We'll go to the desktop the window is on when we summon it. * `onCurrent`: We'll only try to summon the MRU window on this desktop when summoning a window. * When combined with `name`, if there's a window matching `name`, we'll move it to this desktop. * If there's not a window on this desktop, and `name` is omitted, then we'll make a new window. `quakeMode` was also updated to use `toCurrent` behavior by default. ## References * Original thread: #653 * Spec: #9274 * megathread: #8888 ## PR Checklist * [x] Checks some boxes in #8888 * [x] closes https://github.com/microsoft/terminal/projects/5#card-59030845 * [x] I work here * [x] Tests added * [n/a] Requires documentation to be updated ## Detailed Description of the Pull Request / Additional comments S/O to https://github.com/microsoft/PowerToys, who graciously let us use `VirtualDesktopUtils` for figuring out what desktop is the current desktop. Yea, that's all we needed that entire file for. No, there isn't an API for this (_surprised-pikachu.png_) ## Validation Steps Performed Played with this for a while, and it's amazing.
claunia added the pull-request label 2026-01-31 09:24:30 +00:00
Sign in to join this conversation.
No Label pull-request
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/terminal#27825