# Command–Tab switching between Mac windows | Frog

Canonical page: https://frog.beffa.xyz/docs/window-switching/
Updated: 2026-10-26

Window switcher is a Command–Tab replacement that switches between individual windows, including multiple windows of the same app. Turn it on in Features; its shortcut and status are on its own Window switcher page.

These guides describe Frog 1.0.42, the published download as of October 29, 2026. Download links lead to the latest published release.

![Frog’s window switcher listing four example windows with their app names](https://frog.beffa.xyz/screenshots/frog-window-switcher.png)

Window titles and app names help distinguish multiple windows from the same app.

## Find a window from the keyboard

The switcher uses recent-window ordering and shows titles with app names. Availability and activation across apps and Spaces depend on the Accessibility information macOS exposes.

Disable Window switcher in Features to restore the native shortcut and stop Frog’s window work. Layout shortcuts belong to Windows or Shortcuts and keep working. The command bar includes available window results only while Window switcher is enabled.

Command–Tab is the default. Record a different shortcut beside Switch windows on the Window switcher page; hold its modifiers to keep switching, release them to focus the selection, and add Shift to move backward.

1. Enable Window switcher in Features and grant Accessibility access. Its page reports any setup issue.
2. Hold Command and press Tab to open the switcher and cycle through windows. Add Shift to reverse direction.
3. Type to filter by window title or use arrow keys to navigate. Rows are also clickable, and moving the pointer across the list selects the row under it; a pointer that only rests where the list opens changes nothing.
4. Release Command or press Return to choose the selected window. Escape cancels.

## Why does the switcher need Accessibility?

Frog uses macOS Accessibility APIs to list window titles, observe the recently focused window, and activate your choice. It does not capture window screenshots and does not need Screen Recording permission.

A keyboard event tap recognizes the switcher shortcut and its navigation keys. Ordinary typing is passed through and is not recorded. Disabling the switcher removes that event tap.

## Window switching runs locally without an AI model

Window titles, application identities, and recent-window order stay in process memory. They are not sent to an AI provider or written into Frog’s result history or exported configuration. You do not need to download a speech or text model to switch windows.

Application shortcuts complement the switcher: a dedicated shortcut opens or focuses a chosen app, while the switcher lets you choose among its available windows.

## If a window does not appear

Check that the switcher is enabled and Frog has Accessibility permission. Some applications expose limited window information, and macOS Spaces behavior can affect what can be activated. The feature depends on those system capabilities rather than analyzing screenshots to discover hidden windows.

While another app is asking for a password, also in a window left in the background, macOS gives the keyboard to that app only, and Command–Tab falls back to the macOS app switcher. Frog shows a short notice naming the app and marks the switcher as paused on its page; enter the password or close that window to continue.

## Related guides

- [App shortcuts](https://frog.beffa.xyz/docs/app-shortcuts/)
- [Windows](https://frog.beffa.xyz/docs/window-management/)
- [Privacy and offline use](https://frog.beffa.xyz/docs/privacy/)

## Source documentation

- [Window-switcher implementation and privacy notes](https://github.com/t1llo/frog/blob/main/docs/privacy.md)
- [Shortcut configuration](https://github.com/t1llo/frog/blob/main/docs/configuration.md)