A macOS CLI for selecting and focusing windows.
winpick exposes focusable macOS windows to the terminal. Use it to list
windows, focus a window by ID, inspect the current focused window, or pick a
window interactively.
- List focusable windows
- Focus windows by macOS window ID
- Show the current focused window
- Pick a window interactively with
fzf - Emit JSON for scripts and agents
- Show Space labels when
yabaiis available
Homebrew:
brew install h3nock/tap/winpickFrom source:
swift build -c release
install -m 0755 .build/release/winpick ~/.local/bin/winpickwinpick # pick and focus a window
winpick pick # pick and focus a window
winpick list # list focusable windows
winpick focus <id> # focus a window by ID
winpick current # print the current focused window
winpick doctor # check setup
winpick permissions -o # open Accessibility settingsAliases:
pick: p
list: l, ls
focus: f
current: c, cur
doctor: d, doc
permissions: perm, perms
Use --json for machine-readable output:
winpick list --json
winpick current --json
winpick focus <id> --json- macOS 14+
- Accessibility permission for the terminal app running
winpick fzffor interactive pickingyabaioptional, used only for Space labels
Install picker dependency:
brew install fzfOpen Accessibility settings:
winpick permissions --open-settings
# Enable the terminal app running winpick, for example Ghostty.