WindowRanger 1.0.4

WindowRanger 1.0.4

WindowRanger 1.0.4 is a responsiveness hotfix for the Stable release.

Fixed

• Prevented a slow or hung application's Accessibility endpoint from making workspace switching
  appear locked up for many seconds.
• Temporarily defers only the unavailable application while preserving its workspace and layout
  membership, allowing healthy applications to remain responsive and recovering automatically once
  the application answers again.

Requirements

• macOS 14 or later.
• Accessibility permission for window discovery and management.
• Screen Recording permission only when optional captured workspace previews are enabled.

Installation

Download WindowRanger-1.0.4.dmg from this release's Assets section, open it, and drag
WindowRanger onto the Applications shortcut. The notarized ZIP and both checksum files are included
as fallbacks and for verification.

Homebrew users can install or upgrade the public Stable Cask with:

brew install --cask appranger/tap/windowranger
brew upgrade --cask appranger/tap/windowranger

Existing Stable users can also install this update through WindowRanger's signed in-app updater once
the 1.0.4 feed is published.

Known limitations

• WindowRanger manages virtual workspaces inside the current macOS desktop; it does not replace
  native macOS Spaces.
• Captured workspace previews remain optional and off by default.
• Some applications expose ambiguous or read-only Accessibility windows that WindowRanger
  conservatively ignores.

Feedback and security

Use the repository issue forms for privacy-safe bugs, feature requests, and questions. Do not post
suspected vulnerabilities, private diagnostics, window titles, document names, URLs, or user file
paths in a public issue; follow SECURITY.md instead.

WindowRanger 1.0.3

WindowRanger 1.0.3

WindowRanger 1.0.3 is an urgent performance hotfix for the 1.0.2 release.

Fixed

• Fixed a macOS 27 menu bar appearance-refresh loop that could make WindowRanger continuously use
  roughly one CPU core while otherwise idle.
• Preserved refreshes for genuine Light, Dark, and increased-contrast appearance changes while
  ignoring equivalent repeated appearance notifications.

Requirements

• macOS 14 or later.
• Accessibility permission for window discovery and management.
• Screen Recording permission only when optional captured workspace previews are enabled.

Installation

Download WindowRanger-1.0.3.dmg from this release's Assets section, open it, and drag
WindowRanger onto the Applications shortcut. The notarized ZIP and both checksum files are included
as fallbacks and for verification.

Homebrew users can install or upgrade the public Stable Cask with:

brew install --cask appranger/tap/windowranger
brew upgrade --cask appranger/tap/windowranger

Existing Stable users can also install this update through WindowRanger's signed in-app updater once
the 1.0.3 feed is published.

Known limitations

• WindowRanger manages virtual workspaces inside the current macOS desktop; it does not replace
  native macOS Spaces.
• Captured workspace previews remain optional and off by default.
• Some applications expose ambiguous, slow, or read-only Accessibility windows that WindowRanger
  conservatively ignores.

Feedback and security

Use the repository issue forms for privacy-safe bugs, feature requests, and questions. Do not post
suspected vulnerabilities, private diagnostics, window titles, document names, URLs, or user file
paths in a public issue; follow SECURITY.md instead.

WindowRanger 1.0.2

WindowRanger 1.0.2

WindowRanger 1.0.2 makes tiled window movement more natural, supports dragging windows between
displays regardless of layout, and fixes two first-launch menu bar issues.

Improved

• Tiled windows now use a clear directional insertion preview while dragging, so moving a window
  changes the BSP tree where it is dropped instead of only swapping two existing positions.
• Windows can be dragged between displays in any combination of Tiled, Accordion, and Freeform
  layouts. Transfers preserve the destination layout's normal placement behaviour and work in both
  Independent Displays and Unified workspace modes.

Fixed

• Fixed menu bar text initially using the wrong colour until the first workspace switch.
• Fixed the WindowRanger status menu initially appearing too high and then jumping into position
  when the pointer entered it.
• Fixed cross-display drags snapping back to the source display or becoming jumpy while moving from
  Accordion or Freeform layouts.

Requirements

• macOS 14 or later.
• Accessibility permission for window discovery and management.
• Screen Recording permission only when optional captured workspace previews are enabled.

Installation

Download WindowRanger-1.0.2.dmg from this release's Assets section, open it, and drag
WindowRanger onto the Applications shortcut. The notarized ZIP and both checksum files are included
as fallbacks and for verification.

Homebrew users can install or upgrade the public Stable Cask with:

brew install --cask appranger/tap/windowranger
brew upgrade --cask appranger/tap/windowranger

Stable 1.0.0 and 1.0.1 users can also install this update through WindowRanger's signed in-app
updater once the 1.0.2 feed is published.

Known limitations

• WindowRanger manages virtual workspaces inside the current macOS desktop; it does not replace
  native macOS Spaces.
• Captured workspace previews remain optional and off by default.
• Some applications expose ambiguous or read-only Accessibility windows that WindowRanger
  conservatively ignores.

Feedback and security

Use the repository issue forms for privacy-safe bugs, feature requests, and questions. Do not post
suspected vulnerabilities, private diagnostics, window titles, document names, URLs, or user file
paths in a public issue; follow SECURITY.md instead.

WindowRanger 1.0.1

WindowRanger 1.0.1

WindowRanger 1.0.1 is a focused Stable correction for the bundled command-line interface. The app,
workspace engine, settings, layouts, profiles, previews, and update channels are otherwise
unchanged from 1.0.0.

Fixed

• Fixed every IPC-backed windowranger command being rejected by a signed installed app with
  The WindowRanger command peer is not the bundled executable. The CLI now verifies the exact
  signed WindowRanger bundle location returned by macOS while retaining the same-user, Team ID,
  code-identifier, dynamic-signature, and exact helper-path checks.

Requirements

• macOS 14 or later.
• Accessibility permission for window discovery and management.
• Screen Recording permission only when optional captured workspace previews are enabled.

Installation

Download WindowRanger-1.0.1.dmg from this release's Assets section, open it, and drag
WindowRanger onto the Applications shortcut. The notarized ZIP and both checksum files are included
as fallbacks and for verification.

Homebrew users can install or upgrade the public Stable Cask with:

brew install --cask appranger/tap/windowranger
brew upgrade --cask appranger/tap/windowranger

Stable 1.0.0 users can also install this correction through WindowRanger's signed in-app updater.

Known limitations

• WindowRanger manages virtual workspaces inside the current macOS desktop; it does not replace
  native macOS Spaces.
• Captured workspace previews remain optional and off by default.
• Some applications expose ambiguous or read-only Accessibility windows that WindowRanger
  conservatively ignores.

Feedback and security

Use the repository issue forms for privacy-safe bugs, feature requests, and questions. Do not post
suspected vulnerabilities, private diagnostics, window titles, document names, URLs, or user file
paths in a public issue; follow SECURITY.md instead.

WindowRanger 1.0.0

WindowRanger 1.0.0

WindowRanger 1.0 is the first Stable release of the native macOS virtual-workspace manager. It
combines fast keyboard-driven workspace control with visual configuration, display-aware profiles,
reliable restoration, and an optional command-line interface for automation and agents.

Highlights

• Create named virtual workspaces on one or more displays, switch or move windows with global
  shortcuts, and choose Freeform, Tiled, or Accordion layouts with visual orientation, gap, and
  padding controls.
• Configure reusable profiles with automatic docked, undocked, full-screen Game Mode, and exact
  display-setup selection. Profile content can sync through iCloud while each Mac keeps ownership
  of its local active profile, monitor bindings, and automatic assignments.
• Use the menu bar, searchable Command Palette, Shortcut Guide, Focus Border, and Quick App Shelf
  as complementary ways to navigate and arrange windows. Optional captured workspace previews show
  the current wallpaper and clickable window thumbnails when Screen Recording access is enabled.
• Install the bundled windowranger command from General Settings without administrator access.
  It exposes every stable first-party action and the complete versioned configuration surface, with
  revision checks and explicit replacement confirmation for safe automation. It can also generate
  a ready-to-use agent skill.
• Move between Macs and display arrangements without sacrificing recovery safety: WindowRanger
  preserves workspace membership and frames, handles quit/wake/restart reconciliation, and keeps
  inactive workspaces off-screen without replacing native macOS Spaces.

Requirements

• macOS 14 or later.
• Accessibility permission for window discovery and management.
• Screen Recording permission only when optional captured workspace previews are enabled. macOS's
  permission wording also mentions audio; WindowRanger does not capture audio or the pointer.

Installation

1. Download WindowRanger-1.0.0.dmg from this release's Assets section.
2. Optionally verify it against WindowRanger-1.0.0.dmg.sha256.
3. Use Quit WindowRanger in an existing copy, then open the DMG.
4. Drag WindowRanger.app onto the Applications shortcut and replace the existing copy if Finder
   asks.
5. Launch WindowRanger from /Applications and grant Accessibility access when macOS asks.

The notarized ZIP and its checksum are included as a fallback for environments that cannot mount a
DMG. GitHub's automatically generated source archives do not contain the installable application.

After installation, General Settings can add the bundled command to ~/.local/bin. Open a new
terminal after changing PATH.

Updates and Homebrew

Stable is the default in-app update channel. Beta remains an explicit opt-in and never causes a
Stable-only client to install a prerelease. The Homebrew Cask follows the same signed, notarized,
immutable Stable DMG and will be announced separately after its install, upgrade, uninstall, and
permission behavior has been verified through the selected tap.

Known limitations

• WindowRanger provides virtual workspaces inside the current macOS desktop; it does not create,
  remove, or replace native macOS Spaces.
• Captured workspace previews are off by default and use a bounded, one-shot, in-memory thumbnail
  cache. Without Screen Recording permission, previews fall back to app icons and window metadata.
• Some apps expose unusual or read-only Accessibility windows. WindowRanger conservatively ignores
  ambiguous panels and windows that cannot be moved safely.
• If another window manager uses the same global shortcuts, change one application's shortcuts or
  quit the other manager before using WindowRanger.

Feedback and security

Use the repository issue forms for privacy-safe bugs, feature requests, and questions. Do not post
suspected vulnerabilities, private diagnostics, window titles, document names, URLs, or user file
paths in a public issue; follow SECURITY.md instead.

WindowRanger 0.1.0-beta.9

WindowRanger 0.1.0 Beta 9

This is pre-release software. Back up important work and use Quit WindowRanger before
replacing an existing build.

Beta 9 makes WindowRanger substantially lighter during ordinary use, redesigns profile and
workspace editing, adds optional visual workspace previews, and protects an existing iCloud profile
library when a newly installed Mac enables sync for the first time.

Highlights

• Reuses window observations, suppresses unchanged refreshes, and constructs persistence snapshots
  only when needed, reducing repeated Accessibility work, memory churn, and idle CPU activity.
• Quick App Shelf now supports coherent multi-window applications, faster focus handoff and cycling,
  live settings changes, window removal, focus loss, and screen-lock recovery.
• Profiles and Workspaces use visual, reorderable tabs. Profile selection and automatic use rules
  now share one screen, while Workspace details provide clearer layout, shortcut, duplication,
  deletion, repair, and visual gap/padding controls.
• An off-by-default Show window previews setting can add current wallpaper and bounded one-shot
  window thumbnails to reusable workspace previews in Settings and the Full menu bar. Without Screen
  Recording access, the same surfaces retain privacy-safe geometry and application icons.
• Command Palette can add or remove the focused application from the active profile, and can appear
  at the pointer, screen centre, or as a stationary halo around the focused window.
• Enabling iCloud sync on a newly installed Mac now resolves an existing cloud library before any
  local defaults can be uploaded. Invalid or unavailable cloud data remains non-destructive and is
  surfaced for explicit recovery.
• The setup wizard stays above ordinary windows on every macOS Space and notices an externally
  granted Accessibility permission automatically. Fresh Focus Border settings use light blue while
  the menu-bar highlight remains white.
• Adding or re-keying a workspace reconciles only the affected global shortcuts, retaining working
  registrations and adding diagnostics for any macOS registration failure.

Requirements

• macOS 14 or later.
• Accessibility permission for window discovery and management.
• Screen Recording permission only when optional captured workspace previews are enabled. The macOS
  permission wording also mentions audio; WindowRanger does not capture audio or the pointer.

Installation

1. Download WindowRanger-0.1.0-beta.9.dmg from this release's Assets section.
2. Optionally verify it against WindowRanger-0.1.0-beta.9.dmg.sha256.
3. Use Quit WindowRanger in the existing copy, then open the DMG.
4. Drag WindowRanger.app onto the Applications shortcut and replace the existing copy when Finder
   asks.
5. Launch WindowRanger from /Applications. If macOS asks again, grant Accessibility access to
   dev.appranger.WindowRanger.

The notarized ZIP and its checksum are included as a fallback for environments that cannot mount a
DMG. GitHub's automatically generated source archives do not contain the installable application.

Known limitations

• The public Sparkle feed remains outside this GitHub release checkpoint, so install Beta 9
  manually from GitHub. Automatic update checking remains off by default.
• Captured workspace previews are intentionally off by default, live only in a bounded in-memory
  cache, and fall back to icons when permission, protected content, or a usable image is unavailable.
• Beta 9 is intended to extend validation of first-enable iCloud behavior on a second Mac. Keep sync
  off and preserve the recovery copy if that Mac reports invalid cloud data rather than choosing a
  destructive replacement.
• Supported physical-Mac, multi-display, clean-user, clean-machine, accessibility, privacy, upgrade,
  and uninstall matrices remain incomplete.
• WindowRanger does not replace or integrate with native macOS Spaces.
• Quit other window managers that use overlapping global shortcuts before testing WindowRanger.

Feedback and security

Use the repository issue forms for privacy-safe bugs, feature requests, and questions. Do not post
suspected vulnerabilities, private diagnostics, window titles, document names, URLs, or user file
paths in a public issue; follow SECURITY.md instead.

WindowRanger 0.1.0-beta.10

WindowRanger 0.1.0 Beta 10

This is pre-release software. Back up important work and use Quit WindowRanger before
replacing an existing build.

Beta 10 makes multi-display configuration easier to understand, uses the same modern menu-bar
composition across supported macOS releases, and improves workspace previews before their first
visit after launch.

Highlights

• Compact, Medium, and Full menu-bar modes now use the same grouped display/workspace composition
  on every supported macOS release. Operating-system materials still follow the host macOS version.
• Workspace Layout Style and Orientation controls now show visual examples of Freeform, Tiled,
  Accordion, Automatic, Horizontal, and Vertical behavior instead of relying on names alone.
• Displays Settings now leads with Switch together and Switch separately choices, keeping
  Unified and Independent as secondary terms. Each reusable display name, this Mac's physical
  monitor, and its plain connection status appear together in one row.
• Inactive Tiled workspace previews reconstruct their intended first-visit layout from saved tree
  geometry. When captured previews are enabled and already authorized, one bounded startup pass
  prepares eligible parked Tiled and Accordion windows at their predicted size so thumbnails do not
  show stale application dimensions. This adds no ongoing timer, scan, or capture work.

Requirements

• macOS 14 or later.
• Accessibility permission for window discovery and management.
• Screen Recording permission only when optional captured workspace previews are enabled. The macOS
  permission wording also mentions audio; WindowRanger does not capture audio or the pointer.

Installation

1. Download WindowRanger-0.1.0-beta.10.dmg from this release's Assets section.
2. Optionally verify it against WindowRanger-0.1.0-beta.10.dmg.sha256.
3. Use Quit WindowRanger in the existing copy, then open the DMG.
4. Drag WindowRanger.app onto the Applications shortcut and replace the existing copy when Finder
   asks.
5. Launch WindowRanger from /Applications. If macOS asks again, grant Accessibility access to
   dev.appranger.WindowRanger.

The notarized ZIP and its checksum are included as a fallback for environments that cannot mount a
DMG. GitHub's automatically generated source archives do not contain the installable application.

Known limitations

• The public Sparkle feed remains outside this GitHub release checkpoint, so install Beta 10
  manually from GitHub. Automatic update checking remains off by default.
• Captured workspace previews remain off by default and use a bounded in-memory cache. Their startup
  preparation runs only when capture is enabled and Screen Recording was already authorized.
• Supported physical-Mac, multi-display, clean-user, clean-machine, Accessibility migration,
  privacy, upgrade, and uninstall matrices remain incomplete.
• WindowRanger does not replace or integrate with native macOS Spaces.
• Quit other window managers that use overlapping global shortcuts before testing WindowRanger.

Feedback and security

Use the repository issue forms for privacy-safe bugs, feature requests, and questions. Do not post
suspected vulnerabilities, private diagnostics, window titles, document names, URLs, or user file
paths in a public issue; follow SECURITY.md instead.

WindowRanger 0.1.0-beta.8

WindowRanger 0.1.0 Beta 8

This is pre-release software. Back up important work and use Quit WindowRanger before
replacing an existing build.

Beta 8 concentrates on keeping ordinary windows, temporary macOS surfaces, hidden applications, and
the App Shelf in the right place while Accessibility observations change underneath them.

Highlights

• Hidden applications no longer leave an empty Tiled or Accordion slot, lose their workspace
  assignment, or receive layout writes until they become visible again.
• Native Open and Save panels remain floating at an application-chosen size, while ordinary
  document windows continue to participate in managed layouts. Fixed-size windows also stay visible
  as managed floating windows instead of being parked as unusable layout participants.
• Existing Tiled and Accordion slots survive brief Accessibility enumeration or frame-read failures
  without making the unreadable window eligible for geometry writes. Authoritative close, minimize,
  full-screen, floating, or layout-exclusion state still releases the slot.
• App Shelf startup now hides every configured application with one unambiguous safe window rather
  than deriving presentation from whatever happened to be visible before WindowRanger launched.
• Command Palette can add the captured focused application to Applications or App Shelf, labels
  conversions as Move, respects the Shelf limit, and rejects stale profile or membership changes.
• Shortcut Guide labels now explain whether actions switch workspaces, cycle windows, arrange the
  focused window, choose a layout, or move a workspace, with refined centring and Small-size labels.
• WindowRanger ignores only exact DesktopRanger SurfaceLab windows carrying the shared companion
  marker; an ordinary unmarked manager window from the same host remains manageable.

Requirements

• macOS 14 or later.
• Accessibility permission for window discovery and management.

Installation

1. Download WindowRanger-0.1.0-beta.8.dmg from this release's Assets section.
2. Optionally verify it against WindowRanger-0.1.0-beta.8.dmg.sha256.
3. Use Quit WindowRanger in the existing copy, then open the DMG.
4. Drag WindowRanger.app onto the Applications shortcut and replace the existing copy when Finder
   asks.
5. Launch WindowRanger from /Applications. If macOS asks again, grant Accessibility access to
   dev.appranger.WindowRanger.

The notarized ZIP and its checksum are included as a fallback for environments that cannot mount a
DMG. GitHub's automatically generated source archives do not contain the installable application.

Known limitations

• The public Sparkle feed remains outside this GitHub release checkpoint. Beta 8 provides the newer
  signed artifact for the separately reviewed packaged-update and feed-publication work; install it
  manually from GitHub until that work is complete.
• Automatic update checking remains off by default while packaged upgrade, cancellation, failure,
  and Beta-to-Stable behavior are validated.
• Transient Accessibility-failure retention has deterministic automated coverage, but a failure at
  the exact observation instant cannot be forced reliably during ordinary live use.
• Supported physical-Mac, multi-display, clean-user, clean-machine, accessibility, privacy, upgrade,
  and uninstall matrices remain incomplete.
• WindowRanger does not replace or integrate with native macOS Spaces.
• Quit other window managers that use overlapping global shortcuts before testing WindowRanger.

Feedback and security

Use the repository issue forms for privacy-safe bugs, feature requests, and questions. Do not post
suspected vulnerabilities, private diagnostics, window titles, document names, URLs, or user file
paths in a public issue; follow SECURITY.md instead.

WindowRanger 0.1.0-beta.7

WindowRanger 0.1.0 Beta 7

This is pre-release software. Back up important work and use Quit WindowRanger before
replacing an existing build.

Beta 7 brings together the new App Shelf, simpler Settings, consistent keyboard controls, guided
setup, Game Mode profiles, Pause Mode, and the first Sparkle-capable release baseline.

Highlights

• Quick App Shelf keeps an ordered set of useful apps available across workspaces, with Accordion
  and Carousel presentations, configurable visible-window counts, direct selection, and wrapping
  keyboard navigation.
• Command Palette now combines searchable commands with compact visual Layout and Placement quick
  actions. Keyboard focus moves naturally between the command list and quick actions, while typing
  hides the visual controls and concentrates on search.
• Settings is split into clearer destinations and lets you edit any profile without activating it.
  Profile-owned values remain editable in their natural sections rather than being hidden in one
  oversized Profile page.
• The configurable Navigate and Arrange shortcut families now cover the primary workspace,
  application, layout, placement, and window actions. A passive glass shortcut guide appears while
  either modifier family is held.
• The seven-step branded setup introduces sync, shortcuts, focus borders, menu bar styles, Quick App
  Shelf, and workspace navigation. It can be reopened later from Settings.
• Game Mode profiles can activate for foreground full-screen games, while Pause Mode temporarily
  stops window management and every shortcut except Command Palette so normal control can always be
  restored.
• Stable and Beta builds now contain Sparkle update support with signed archives, explicit local
  Stable/Beta choice, manual checks, and optional automatic checking. This Beta is the installed
  baseline for the first real updater test; the feed intentionally remains inactive until the next
  signed release is ready.

Requirements

• macOS 14 or later.
• Accessibility permission for window discovery and management.

Installation

1. Download WindowRanger-0.1.0-beta.7.dmg from this release's Assets section.
2. Optionally verify it against WindowRanger-0.1.0-beta.7.dmg.sha256.
3. Use Quit WindowRanger in the existing copy, then open the DMG.
4. Drag WindowRanger.app onto the Applications shortcut and replace the existing copy when Finder
   asks.
5. Launch WindowRanger from /Applications. If macOS asks again, grant Accessibility access to
   dev.appranger.WindowRanger.

The notarized ZIP and its checksum are included as a fallback for environments that cannot mount a
DMG. GitHub's automatically generated source archives do not contain the installable application.

Known limitations

• The Sparkle feed is intentionally absent for this baseline release. Install Beta 7 from GitHub;
  the next Beta will be used to validate the signed in-app upgrade path.
• Automatic update checking remains off by default while packaged upgrade, cancellation, failure,
  and Beta-to-Stable behavior are validated.
• Game Mode detection depends on the public macOS full-screen/game-session signals available to the
  app and remains best effort for games that do not expose a normal foreground session.
• The complete manual regression, accessibility, privacy, clean-user, and clean-machine matrices
  remain in progress.
• WindowRanger does not replace or integrate with native macOS Spaces.
• Quit other window managers that use overlapping global shortcuts before testing WindowRanger.

Feedback and security

Use the repository issue forms for privacy-safe bugs, feature requests, and questions. Do not post
suspected vulnerabilities, private diagnostics, window titles, document names, URLs, or user file
paths in a public issue; follow SECURITY.md instead.

WindowRanger 0.1.0-beta.6

WindowRanger 0.1.0 Beta 6

This is pre-release software. Back up important work and use Quit WindowRanger before
replacing an existing build.

Beta 6 makes WindowRanger's fastest interactions feel like one coherent system: summon a Quick App,
find any action through the Command Palette, position a window without leaving it, and reliably
bring Settings back to the current workspace.

Highlights

• The new keyboard-first Command Palette searches the actions that are valid for the current
  window, workspace, layout, profile, and applications. An icon-only Placement Halo expands around
  the search control for mouse or arrow-key positioning without closing the palette; the optional
  Globe/Fn hold opens the matching position-only Placement Wheel directly.
• Quick App now hides and unhides its application without the Dock minimize animation, keeps every
  animated path inside the selected display, applies no-animation frames directly, accounts for the
  optional focus border, and launches the configured application when no usable window is open.
• Opening Settings from the menu bar or another command now resurfaces the existing window on the
  current native macOS Space and interaction display while leaving global workspace and Quick App
  shortcuts immediately responsive.

Requirements

• macOS 14 or later.
• Accessibility permission for window discovery and management.

Installation

1. Download WindowRanger-0.1.0-beta.6.dmg from this release's Assets section.
2. Optionally verify it against WindowRanger-0.1.0-beta.6.dmg.sha256.
3. Use Quit WindowRanger in the existing copy, then open the DMG.
4. Drag WindowRanger.app onto the Applications shortcut and replace the existing copy when Finder
   asks.
5. Launch WindowRanger from /Applications. If macOS asks again, grant Accessibility access to
   dev.appranger.WindowRanger.

The notarized ZIP and its checksum are included as a fallback for environments that cannot mount a
DMG. GitHub's automatically generated source archives do not contain the installable application.

Known limitations

• The complete manual regression, accessibility, privacy, clean-user, and clean-machine matrices
  remain in progress despite signed daily validation of the changed interactions.
• Quick App deliberately refuses ambiguous multi-window targets. Because its animation-free hidden
  state uses macOS application hiding, other windows belonging to the same application hide and
  unhide with it. Broader two-profile validation remains open.
• The Placement Halo and Wheel expose only positions that are truthful for the active layout. Other
  layout, resize, workspace, profile, recovery, focus, and application actions remain in search.
• Trackpad workspace swiping is off by default and depends on macOS exposing the generic gesture
  stream. System gestures may take precedence.
• Sparkle automatic updates are not included yet; install newer builds manually.
• WindowRanger does not integrate with native macOS Spaces.
• Quit other window managers that use overlapping global shortcuts before testing WindowRanger.

Feedback and security

Use the repository issue forms for privacy-safe bugs, feature requests, and questions. Do not post
suspected vulnerabilities, private diagnostics, window titles, document names, URLs, or user file
paths in a public issue; follow SECURITY.md instead.