Auto-restores at every login

Your Claude Code sessions, back exactly where you left them.

A crash, restart, or reboot doesn't have to cost you your terminal windows. Restore AI Windows reopens your iTerm sessions and browser windows — tabs grouped into their original windows, on the exact virtual desktop, position, and size.

Download DMG View on GitHub

Free & open source · macOS · iTerm2 required

restoring — last snapshot
web-app
Space 2 · 1440×900
restored
api-server
Space 1 · 1280×800
restored
docs-site
resuming from summary…
restoring

Snapshot every 2 minutes. Restore in seconds.

Grouped the way you work

One window per project, one tab per session.

Restore AI Windows reads each Claude Code session's working directory and groups them the same way you organize your projects — a ~/Sites/<project> window, a tab for each session in it, with the project name shown right in the iTerm badge.

  • Reads the most-recent cwd from every active transcript
  • One iTerm window per project, one tab per session
  • Friendly project name shown in the iTerm badge
  • Skips the trust prompt and auto-picks Resume from summary
Session grouping
Restore AI Windows grouping restored Claude Code sessions by project into separate iTerm windows.
Not just reopened — restored

Windows come back at the exact position, size, and Space.

A launchd snapshot agent records each project window's frame and virtual desktop every couple of minutes. On restore, that geometry gets played back — so your layout survives a crash the way you left it, not just as a pile of default-sized windows.

  • Captures position, size, and Space per project window
  • Best-effort Space restore via a compiled CoreGraphics helper
  • Falls back to position + size if Screen Recording isn't granted
  • No manual re-tiling after a reboot
Geometry restore
Restore AI Windows restoring window position, size, and virtual desktop for a Claude Code session.
Terminal and browser, together

Browser windows come back too — tabs grouped, Space intact.

Alongside your iTerm sessions, Restore AI Windows snapshots your BrowserOS / Chromium windows: their tabs, grouping, geometry, and Space. On restore, it opens one window per saved group and moves it back to where it was — same best-effort Space handling as the terminal side.

  • Works with any Chromium-family browser with AppleScript scripting
  • Tabs stay grouped into their original windows
  • --browser flag to restore browser windows only
  • RESTORE_SKIP_BROWSER=1 to opt out and restore iTerm only
Browser restore
Restore AI Windows reopening browser windows with tabs grouped into their original windows.

"Restore my sessions" — hands-free

A bundled Claude Code skill runs the restore from inside a session — just say "restore my sessions." No terminal command to remember.

Auto-restore

A launchd agent restores your last snapshot automatically at every login — no click required.

Continues itself

Each restored session gets a prompt to summarize and pick up right where it left off.

Snapshots every 2 min

A background launchd agent records active sessions and window geometry, so restore is never far behind.

Requirements

What it needs to run.

One manual step after install: grant Screen Recording so Space restore works.

Stop losing your windows to a crash.

Free and open source. Grab the DMG or install from source.

Download DMG Open source on GitHub

Free · macOS · MIT licensed