# Heed for Raycast

URL: https://www.raycast.com/rbstp/heed

> Move keyboard focus between windows and turn focus follows mouse on and off: Hyprland's movefocus and follow_mouse for macOS.

- Install: raycast://extensions/rbstp/heed
- Author: [Richard Boisvert](https://www.raycast.com/rbstp)
- Installs: 31
- Platforms: macOS
- Categories: System, Productivity
- Updated: 2026-10-19
- Source: https://github.com/raycast/extensions/tree/6e41546d4072ee1684be8a03feaf4dcd655d5378/extensions/heed/

## Commands

- **Focus Next Window**: Move keyboard focus to the next visible window, screen by screen from left to right.
- **Focus Previous Window**: Move keyboard focus to the previous visible window.
- **Focus Window Left**: Move keyboard focus to the nearest window to the left.
- **Focus Window Right**: Move keyboard focus to the nearest window to the right.
- **Focus Window Above**: Move keyboard focus to the nearest window above.
- **Focus Window Below**: Move keyboard focus to the nearest window below.
- **Focus Window**: Every visible window by name, in Heed's spatial order. Pick one to focus it.
- **Toggle Focus Follows Mouse**: Turn Heed's pointer focus on or off.
- **Enable Focus Follows Mouse**: Turn Heed's pointer focus on.
- **Disable Focus Follows Mouse**: Turn Heed's pointer focus off.
- **Release Shortcuts**: Unregister every shortcut Heed holds, so Raycast can have the combinations.
- **Restore Shortcuts**: Give Heed its default shortcuts back.
- **Enable Mouse Follows Focus**: Move the pointer into the window a command focused.
- **Disable Mouse Follows Focus**: Leave the pointer where it is when a command moves focus.

## README

### Heed

Move keyboard focus between windows from Raycast, and turn focus follows mouse on and off.

[Heed](https://github.com/rbstp/heed) is a window focus agent for macOS, inspired by Hyprland:
`movefocus` for stepping between windows, `follow_mouse` for the pointer. It registers its own
global hotkeys, and every combination it claims is gone from every other app. This extension is the
way to get those combinations back: Raycast owns the hotkey, Heed claims nothing.

#### Commands

| Command | What it does |
| --- | --- |
| Focus Next / Previous Window | Step through the visible windows, screen by screen from left to right, then left to right within each screen. |
| Focus Window Left / Right / Above / Below | Move to the nearest window in that direction. Sharing a row or column beats being closer, and the edge is a dead end rather than a wrap. |
| Focus Window | Every visible window by name, in that same order, with the app it belongs to and its size. Pick one to focus it. |
| Toggle / Enable / Disable Focus Follows Mouse | Heed's pointer focus, without reaching for the menu bar. |
| Release / Restore Shortcuts | Unregister every shortcut Heed holds, so the combinations are free for Raycast, or give Heed its defaults back. |
| Enable / Disable Mouse Follows Focus | The pointer follows a command into the window it focused, instead of staying behind and dragging focus back on the next mouse movement. |

Assign a Raycast hotkey to any of the focus commands, then run **Release Shortcuts** once so Heed
lets go of the combinations. That frees every shortcut Heed holds, the numbered ones included, which
no command here replaces; to keep some, clear single fields in Heed's **Settings** window instead,
from its menu bar icon or with `open heed://settings`. Either takes effect at once.

Windows completely covered by other windows are skipped, and the order is spatial rather than
stacking, so stepping through does not reorder what you are stepping through.

#### Requirements

Heed 0.13.0 or later on Apple silicon, macOS 14 or later, with Accessibility permission granted.
Releases are signed and notarized, so Gatekeeper opens them without a detour through System Settings:

```sh
brew install --cask rbstp/tap/heed
```

#### How it works

Each command opens a `heed://` URL, which a running Heed handles directly. The channel is one way:
Heed answers nothing back, so a command reports what it asked for rather than what came of it, and
a command sent to a Heed that is not running launches it first.

Focus Window is the one that reads rather than writes. It runs `Heed --windows`, which builds the
list from the window server and Accessibility on the spot. Picking a window asks for it by the
window server's own number, so a window opening or closing while the list is on screen cannot make
it focus the wrong one.