Skip to content

Stage Manager 1.0.0

Choose a tag to compare

@eugene-tea eugene-tea released this 13 Oct 23:22
· 12 commits to master since this release

The first release. Stage Manager is a stand-in for Apple's Stage Manager: the strip of stages on the left and your windows floating as you left them. It looks and behaves like Apple's out of the box. Everything beyond that is off until you turn it on in ~/.config/stage-manager/config.toml.

Install: download Stage-Manager.dmg, drag the app into Applications and open it. It is signed and notarized. It needs macOS 14 or later.

On first launch it walks you through:

  • turning off Apple's Stage Manager (it offers to do it for you);
  • Accessibility (required), so it can move, hide and bring back your windows;
  • Screen Recording (optional), for live pictures on the cards. Without it, cards show plain window shapes with the app's icon.

What's in 1.0.0

  • Each Desktop gets its own stages and strip. Switches animate the way Apple's do.
  • Drag and drop between stages, ⌘M to the strip, reorder cards, and drop a card on another to merge the two stages.
  • A Dock click to an app on another Desktop arranges that Desktop before it slides in.
  • The corner where parked windows wait is clean: their slivers ignore clicks, and a small patch drawn from your wallpaper's own file covers them. No screen recording is involved.
  • A menu bar icon with Settings, About, update checks and launch at login. Rules, named stages, hotkeys, pinning and every look and timing live in the config file. docs/AGENTS.md lets an AI assistant set it up for you.
  • If Apple's Stage Manager is turned on, it steps aside and puts every window back.
  • No window is left parked, even after a crash: a small watchdog brings windows back.

Privacy: nothing about your windows leaves your Mac. The only network use is a daily update check against GitHub.

Not affiliated with Apple. MIT licensed.