Changelog

2.0.5

Changed

  • When you install Clamshell for the first time, setup no longer shows the "Help improve Clamshell" step. Instead, Clamshell sends a few anonymous counts: that it opened for the first time, that the trial started, the first time you used it, that the trial ended, and the kind of problem when one happens. They carry no ID and no files or work content. To turn them off, go to Settings > About and switch off Send anonymous usage counts under Privacy.
  • If you already use Clamshell, your earlier choice stays as it was. Its switch moved from Settings > General to Settings > About, under Privacy.
  • Setup is one step shorter. The last screen, "Clamshell lives up here", shows the price after the 7 free days, and its Continue button starts your free trial. If you quit before you press it, setup starts over the next time you open Clamshell.

Fixed

  • The "last day" and "trial ended" reminders could be lost when you allowed notifications during setup. They are now scheduled as soon as you allow them, also when you allow them later in System Settings.

2.0.4

Added

  • Agent Screen can keep the display on for the whole time the lid is closed. In its description, click "turns off" to change it to "stays on". Use it when your own scripts or apps need the screen and Clamshell can't see them the way it sees agents. The display stays black, and your Mac locks when you open the lid. It uses more battery, so "turns off" stays the default.

2.0.3

Added

  • If your free trial ended before Clamshell 2 came out, you get 3 more days to try Clamshell 2, once. Clamshell offers them the next time it opens; click Start 3 free days.
  • After the trial, if you hold Option while you close the lid and your Mac sleeps, Clamshell tells you so when you open the lid again.

Changed

  • The reminders on the last day of the trial and when it ends now arrive on time even while Clamshell is not running. The last-day reminder and the menu say what time the trial ends.
  • When the trial ends, the window that opens says "Closing the lid now puts your Mac to sleep". It no longer takes focus from the app you are using, and it opens by itself at most 4 times: when the trial ends, 3 days later, 14 days later, and once when you open Clamshell a month or more later. After that it opens only when you try to arm.
  • After the trial, the menu says that closing the lid now sleeps your Mac.
  • Clamshell asks to show its notifications when you start the free trial, so the trial reminders reach you. It still asks only once.

Fixed

  • If Clamshell could not confirm a bought license for a while, the menu and the window talked about the trial instead. They now ask you to connect this Mac to the internet, with a Try Again button.

2.0.2

Added

  • Settings > General has a new switch, Get beta updates. Turn it on to get new versions before everyone else; they may have rough edges. Turn it off and Clamshell goes back to the regular version. It is off unless you turn it on.
  • Agent Status, Agent Notifications and the other Agents modules now follow Kiro sessions too, in the Kiro IDE and the Kiro CLI, next to Claude Code, Codex, Grok and OpenCode. Nothing is set up or changed in Kiro.
  • On a MacBook without a lid-angle sensor, Settings > General says that holding Option while you close the lid can't arm Clamshell there, and that pressing both Option keys or the menu bar icon still does. Close the notice and it stays gone.

Changed

  • The buy screen, menu and trial reminders show the price in the currency checkout will charge you.
  • Settings always opens on General.

Fixed

  • Cleaning Lock: Option, Command, Control, Shift and Fn do nothing while the cover is up. Before, wiping the keyboard could open another app's shortcut (such as a chat panel on a double Option) over the cover, and pressing both Option keys ended the cover early.

2.0.1

Changed

  • Right-clicking the menu bar icon keeps Clamshell armed until you turn it off again, as in Clamshell 1. Opening the lid no longer ends it. Option + Option and Option + close lid still arm for the next close.

Fixed

  • The "Clamshell session interrupted" message could appear even though the Mac never went to sleep, and modules such as Battery Budget stopped early with it. Both now happen only when the Mac really slept.
  • The Bluetooth permission prompt now describes what Clamshell uses Bluetooth for.

2.0.0

Added

  • A new app icon and menu bar icon, hand-drawn from one shell stroke. Armed and paused sessions change only the menu bar icon's color.
  • Press both Option keys together (Option + Option) to arm for the next close. It is on by default and needs no extra permission.
  • Modules: optional extras in a new Modules section of Settings, one switch each. Browse them as cards, search them and filter by group. Each has its own icon, its own page and a short walkthrough the first time you turn it on. Clamshell works fully without any of them, and its safety rules always come first.
  • Agents: Agent Screen (agents can use the screen with the lid closed), Agent Status (see what your Claude Code and Codex agents are doing from the menu bar), Agent Notifications (know when an agent needs you or is done), Finish Work, Then Sleep (let your agents finish, then let your Mac sleep), Agent Light (your agents' state on a light you can see across the room) and Sleep Until Reset (sleep through a usage limit and wake when it resets).
  • Keyboard: Caps Lock (Caps Lock becomes an arm switch, and its light shows when your Mac stays awake) and Cleaning Lock (lock the keyboard and trackpad while you wipe them).
  • Sound: Lid-Close Sound (eight new sounds, a preview on every choice and its own volume) and Quiet Close (closing the lid mutes your Mac; opening it brings the sound back).
  • Power: Always On While Plugged In, Home Server (always armed, lid closed, for a Mac that serves), Battery Budget (a closed session uses only the battery you allow, then sleeps), Low Power While Closed, Fan Boost (full fan speed while your Mac is closed), Bluetooth Off While Closed, Sleep Means Sleep (no Power Nap or network wakes while asleep on battery) and Stay Off When Opened (a shut-down Mac stays off when you open the lid or plug it in).
  • Time: Sleep Timer (your Mac goes to sleep after a set time, fading the music out) and Sleep When Idle (a closed Mac sleeps once nothing is working).
  • Awake: Keep Awake (keep your Mac awake with the lid open, indefinitely, for a set time or while your agents work), Awake While Connected (stays awake while you're connected over SSH or Screen Sharing) and Finish Jobs, Then Sleep (let downloads, exports and backups finish, then let your Mac sleep).
  • Sessions: Bag Check (warns you if your Mac didn't sleep in your bag), Eject on Sleep (your external drives eject when your closed Mac sleeps) and Lid Shortcuts (run your own shortcuts when you close and open the lid).
  • Security: Password After Close (close the lid and the next unlock needs your password).
  • Triggers: Arm While an App Runs, Arm on a Wi-Fi Network, Arm on a Schedule and Arm When a Drive Connects. Clamshell arms by itself while an app you choose runs, on the Wi-Fi network you choose, during the hours you choose, or while a drive you choose is connected.
  • Make Your Own: describe a module to any AI coding agent (Claude Code, Codex, Cursor) and it builds one, with its own icon, a description you edit in place and rules that keep your Mac awake or end the session. It appears in the new Custom group.
  • Permissions a module needs open a small floating guide under System Settings: drag Clamshell into the list and it closes by itself.

Changed

  • A redesigned Settings window that can be resized.
  • Right-clicking the menu bar icon now arms for the next close only. Every way to arm is always on: Option + close lid, Option + Option and right-click.
  • Option + Option replaces the Control-Option-Command-L shortcut.
  • Disarm on low battery lives in General and always triggers at 20% on battery power. It never disarms while plugged in.
  • Agent Screen is off by default, so Clamshell turns the display off on close unless you turn it on.
  • An external display no longer pauses Clamshell. With a monitor connected, closing the lid keeps your Mac awake, even on battery. With a TV, projector or AirPlay mirroring your screen, closing the lid keeps the picture there, and opening the lid afterwards locks your Mac.
  • The closing animation always plays, except when Reduce Motion is on.
  • The configure automation URL now accepts only lowBatteryDisarm. Scripts that set the arming methods or the low-battery threshold get an error naming the setting that no longer exists.
  • The first time you open Settings, Clamshell asks once to show its notifications as banners.
  • The optional survey after you buy adds "GitHub or a forum" and "A developer tool" as answers, then asks one more optional question: what made you buy. You can close it at any point.

1.4.24

Added

  • Buy Clamshell straight from the menu bar during the trial and after it ends.
  • Trial reminders three days before, on the last day, and when the trial ends, each with a Buy button.

Changed

  • Checkout opens in Safari when available, falling back to your default browser.
  • When the trial ends, the purchase window appears once instead of waiting for the next arm attempt.
  • Settings > License shows the Buy button after the trial too.

1.4.23

Fixed

  • The shell in the app icon is no longer cut off at the edges.

1.4.22

Added

  • After you activate a license, Clamshell asks once how you found it. One click answers, and you can close the window without answering.

Changed

  • The shell in the app icon is larger and easier to see.

1.4.21

Fixed

  • On some Macs, an armed closed-lid session could end with macOS logging you out. If that happens, Clamshell now turns the display off with the lid closed from then on and tells you.
  • Clamshell no longer gets stuck when you quit or log out while the lid is closed during an armed session.

Changed

  • The "Let agents use the screen while the lid is closed" setting is back and stays on by default. Turning it off sleeps the display with the lid closed, which uses less battery and keeps your Mac cooler.

1.4.20

Changed

  • The menu bar menu now arms for the next close only. Shortcuts and right-click arming still stay active across lid reopenings.
  • After an armed close, the display stays dark on reopen until your Mac is locked. If the lock cannot be confirmed, Clamshell restores the display and tells you to lock your Mac manually.

Fixed

  • The closing animation now appears when Option-close arms on affected Macs.
  • Thermal protection now also ends a session that is paused while an external display is connected.
  • Clamshell no longer arms when it cannot monitor the lid or power state, and tells you how to recover.
  • Security fixes for automatic updates.

1.4.19

Added

  • Optional analytics can now be enabled during onboarding or later in Settings, with a separate opt-out and deletion control.
  • Automation links can now read and update low-battery protection and arming preferences for companion tools such as Raycast.
  • Three-Mac lifetime licenses can now activate Clamshell on up to three Macs.

Changed

  • Agents can use the screen during an armed closed-lid session while the built-in display stays black. The separate Settings switch has been removed.

Fixed

  • The lid-closing animation now recovers when the angle sensor keeps returning an unchanged value, and uses a more reliable rendering path.

1.4.18

Fixed

  • The paused-session explanation now appears only once when the lid closes with an external display connected.
  • The lid-close sound switch now aligns with the other switches in General Settings.

1.4.17

Added

  • Clamshell now follows the Mac's language in German, Spanish, French, and Brazilian Portuguese across both direct and Setapp editions.

Changed

  • Arming while external displays are connected now pauses Clamshell instead of rejecting the request. A yellow menu bar icon shows the paused state, and Clamshell arms automatically after every external display disconnects.

1.4.16

Fixed

  • Changing between battery and external power while the lid is closed no longer interrupts an armed session.

1.4.15

Added

  • Settings now offers three optional lid-close sounds. Sound feedback remains off by default and previews when enabled or changed.

Changed

  • Arming from the menu bar, right-click, keyboard shortcut, or automation now stays active across lid reopenings until you turn Clamshell off. Holding Option while closing the lid remains a one-close action.
  • The menu bar uses the simpler "Arm Clamshell" action while the armed status still distinguishes a one-close gesture from a persistent session.

1.4.14

Added

  • Clamshell can keep the built-in display black while coding agents continue working with the lid closed. The Mac still locks when the lid opens.
  • Settings can use either the original frosted appearance or an exact black background.

Changed

  • General Settings now groups armed-session behavior and app preferences into two clearer sections.
  • Clamshell now refuses to arm while an additional display is connected because macOS already handles closed-lid external-display setups, and immediately explains the refusal in a clear warning popup.

Fixed

  • Opening the lid now restores the captured brightness, retracts the closing sheet, and presents one clean macOS Lock Screen without launching the screen saver.
  • The status menu now stays attached to the menu bar icon and no longer shows the recurring wait cursor on recent macOS versions.

1.4.13

Added

  • Clamshell now restores normal lid sleep when macOS reports serious thermal pressure and refuses to arm again until the Mac has cooled.

Fixed

  • Incoming calls and other display-only interruptions now restore the armed lid policy both when the display wakes and when it goes dark again, preventing a closed Mac from falling asleep after the interruption ends.
  • Power-source changes and system sleep no longer look like a physical lid-open event, so Momentary mode stays armed until the lid actually opens.

1.4.12

Fixed

  • Clamshell now keeps retrying and clearly warns you if macOS fails to restore its normal lid-sleep setting, instead of silently reporting a safe disarm.
  • Lid sensor read failures no longer look like a real lid-open event, so a transient sensor problem cannot unexpectedly end an armed session.
  • Low-battery protection now fails toward sleep when battery telemetry remains unavailable, and display-sleep commands are checked and retried.
  • Crash recovery preserves its recovery marker until the normal lid-sleep setting is confirmed restored.

1.4.11

Added

  • After another app or automation directly puts an armed Mac to sleep, Clamshell now explains why the session stopped and points to the charging, scheduling, and automation settings that may have caused it.

1.4.10

Fixed

  • Leaving the status menu open no longer shows a wait cursor on recent macOS betas. The menu now opens from the original click instead of a synthetic second click that macOS could treat as an unresponsive action.

1.4.9

Added

  • Settings now warns when the arming keyboard shortcut is already taken by another app, instead of the switch silently doing nothing.

Fixed

  • Right-clicking the menu bar icon no longer arms and instantly disarms on recent macOS betas that deliver one click twice.
  • The status menu now opens through the system's native menu path, which should cure the clipped or detached menu on recent macOS betas; opening it also no longer switches focus away from the app you are working in.
  • Settings now asks you to reconnect to the internet when a license needs re-verification, instead of showing the new-install free-trial offer.
  • Gesture diagnostics no longer log a bogus failed-close line after every successful arming gesture.

1.4.8

Fixed

  • The arming gesture now recovers from a lid-sensor dropout even with "Play close animation" turned off; previously the gesture could silently stop working there until relaunch.
  • A Mac clock running slightly behind no longer risks deactivating a valid license during the background license check.
  • A brief network hiccup no longer delays the license re-check by a full day.
  • Deactivating this Mac during a background license check can no longer re-activate the freed license.
  • Rapidly cancelling and redoing the arming gesture no longer skips the close animation.
  • Arming with a lapsed license now always shows the regular purchase window, never the first-run setup screen.
  • More reliable cleanup of the sleep setting when quitting and when disarming via Shortcuts.
  • Hardened the emergency force-quit path so a hung process can always be cleaned up.

1.4.7

Fixed

  • Right-clicking the menu bar icon no longer flashes on and off (arming, then instantly disarming) on recent macOS betas. It now toggles reliably.
  • The menu no longer opens clipped or detached from the icon on recent macOS betas; it opens attached and fully expanded.

1.4.6

Fixed

  • The menu bar icon no longer changes width when armed, so the icons next to it no longer shift sideways each time you arm or disarm.

1.4.5

Changed

  • Right-click (two-finger click) on the menu bar icon now arms and disarms Clamshell by default. Left-click still opens the menu; you can switch right-click back to opening the menu in Settings > Gesture.

Fixed

  • The right-click action on the menu bar icon could do nothing on recent macOS betas, where the system routes the click away from the app. It now works reliably.

1.4.4

Fixed

  • The "hold Option, close the lid" gesture could arm by accident on recent macOS betas, where the system briefly reports the Option key as held when it is not, leaving the Mac awake unexpectedly. Arming now requires a closing motion (opening the lid wider never arms) and a steady, deliberate Option hold.

1.4.3

Fixed

  • The closing animation could fail to appear, or freeze partway, on Macs where the lid-angle sensor briefly stops responding (seen on recent macOS betas). It now recovers cleanly: if the sensor drops out mid-close the animation steps aside instead of freezing, Clamshell still arms when the lid actually shuts, and the menu bar always shows the true armed state.

Changed

  • The lid-angle sensor is now read only while you are performing the close gesture, not continuously. This avoids a background wake-up loop on affected Macs and is gentler on the battery.

1.4.2

Fixed

  • The armed menu bar icon was hard to see against light or colorful (for example, blue) wallpapers and menu bars. The blue clam now keeps a clear contrast outline, so it stands out wherever it sits.
  • The closing animation could leave a hairline of wallpaper showing along the left and right edges of the screen. It now covers the edges fully.

1.4.1

Added

  • The Arm, Disarm, Toggle, and Status actions now appear in the Shortcuts app and Spotlight, so you can run them by name or build them into a Shortcut without using the URLs.

1.4.0

Added

  • Control Clamshell from scripts and AI agents: clamshell://arm, clamshell://disarm, and clamshell://toggle URLs let you arm before a long task and disarm when it finishes, so an agent can keep running with the lid closed and turn the setting back off when it is done.
  • An Arm command in the menu bar menu, so you can arm without the lid gesture (handy on Macs without the lid-angle sensor).
  • A one-time reminder on the final day of your free trial.

Fixed

  • Clamshell re-applies its keep-awake setting when the Mac wakes, so arming can no longer silently lapse if you put the Mac to sleep while it was armed.
  • The lid-angle gesture now recovers on its own if the sensor stops responding after sleep and wake, instead of needing a restart.
  • The closing animation stays on the built-in display if you dock or change displays in the middle of the gesture.
  • Clamshell's safety notifications (low battery, or a screen that could not be turned off) now appear even when a Clamshell window is open.
  • Buying no longer pops a "paste your license key" prompt on top of the checkout page before you have a key.

Changed

  • The purchase screen now states the 14-day money-back guarantee.

1.3.4

Fixed

  • Option+close arming no longer occasionally fails to fire when the lid starts from a wide resting angle. The decision to arm no longer depends on the closing animation's progress, which removed a dead zone above roughly 119 degrees.
  • A brief lid-angle sensor glitch can no longer flash the black closing animation while the lid is actually open.
  • The closing animation is never drawn on an external display; it stays on the built-in screen that is about to go dark.
  • If macOS briefly refuses the request to turn the internal display off, the panel no longer stays lit behind a closed lid.
  • The low-battery auto-disarm now also triggers right after you unplug from power while already low on battery, and it only notifies you that it disarmed when the Mac was actually released to sleep.
  • A valid purchase can no longer be deactivated by a routine background license check; only a genuine cancellation or refund clears it.
  • Your license stays tied to this Mac across a preferences reset.
  • A manual check for updates no longer suppresses the automatic background download that runs while the lid is closed.
  • The low-battery threshold is always kept within its 5 to 50 percent range.

Changed

  • Cracking the lid open by a small amount (under about 15 degrees) no longer cancels an active arm. Fully opening the lid still disarms.

Added

  • Always-on, no-personal-data gesture diagnostics, so any future "it did not arm" report can be diagnosed from the support diagnostics.

1.3.3

Fixed

  • A failed arm no longer plays the closing animation. The animation is the confirmation that arming worked; it now only plays when it actually did.
  • Disarming always works, even if the trial or license lapsed while armed: the menu keeps the disarm row and the quick-toggle disarms instead of opening the purchase window.
  • The safety net that keeps Clamshell armed across power-source changes (and the low-battery check) no longer pauses while a menu or slider is open.
  • A lid-angle sensor failure mid-gesture can no longer leave the black closing animation stuck on screen; it now retracts itself.
  • Accidentally launching a second copy of the app no longer disarms the running one.
  • "Deactivate on this Mac" now keeps the license on this Mac when the server cannot be reached (instead of stranding the seat), and confirms success.
  • Activating through the purchase link now shows a confirmation instead of finishing invisibly; license activation buttons show a busy state, and Return in the key field activates.
  • Adjusting the screen angle with Option held no longer cancels an arm made from the menu or keyboard shortcut.
  • The closing animation renders at full sharpness on Retina displays.
  • Settings panes keep their license-related disabled states after tab switches, and the clamshell.dev link is always clickable.
  • Onboarding edge cases: a deactivated license no longer routes into the non-closable welcome tour, the welcome guide no longer opens duplicate windows, and the menu-bar pointer follows the final card correctly.

Changed

  • Low-battery safety: arming below your set threshold is now honored as deliberate; the auto-disarm fires only when the battery falls through the threshold while armed, and posts a notification explaining why.
  • The armed menu row reads "Armed" when "Stay on after opening the lid" is enabled ("Armed for Next Close" otherwise).
  • Cmd+W closes the Settings window; the menu bar icon shows a tooltip, and presses highlight it like a native status item.
  • VoiceOver announces onboarding steps and the low-battery slider's purpose.

1.3.2

Changed

  • The menu's "Armed for Next Close" row now appears only while Clamshell is actually armed, in every arming mode; the "Not Armed" row is gone. When not armed, the menu starts straight at Settings.

Fixed

  • The armed row's clam glyph now renders in the same blue as the armed menu bar icon instead of grey.
  • The armed row stays readable while highlighted: its text and glyph flip to white over the selection highlight instead of disappearing blue-on-blue.

1.3.1

Fixed

  • The menu bar icon now turns the intended blue while armed; it previously rendered as a dark silhouette that was invisible against a dark menu bar.
  • Right-click quick-toggle now works on macOS versions that misdeliver menu bar right-clicks (including current betas).

Added

  • Control-click or Option-click the menu bar icon as quick-toggle equivalents of the right-click gesture.

Changed

  • A refreshed app icon.
  • A simpler, tidier About pane.

1.3.0

Added

  • Optional low-battery safety: when armed on battery power, Clamshell can disarm at a level you choose (5-50%) so your Mac sleeps before the battery runs flat. Off by default, in Settings > General.
  • "Copy diagnostics for support" in Settings > General copies the app version, macOS version, Mac model, and the recent local diagnostic log to the clipboard for support emails. Nothing is sent anywhere.

1.2.1

Changed

  • The download is now under 2 MB (it was 4.5 MB, and 8.3 MB two releases ago). The app icon ships in the classic Mac format, which on macOS 26 shows the standard icon style instead of the Liquid Glass treatment.

1.2.0

Added

  • Clamshell now recovers automatically if it ever crashes or is killed by the system: a tiny built-in watchdog relaunches the app, so the menu bar icon can no longer be left behind dead and unresponsive. Quitting normally is unaffected - quit stays quit, and nothing keeps running in the background.

Changed

  • The app is about a third smaller on disk, and the download is nearly half its previous size. Nothing was removed and nothing looks or behaves differently.
  • First launch is snappier: the welcome window appears about half a second sooner, before the app finishes its behind-the-scenes setup.
  • The onboarding videos are ready the moment you reach their card - no more brief blank box while a clip loads in.

1.1.1

Fixed

  • The shell-closing animation is sturdier on flaky hardware/OS combinations: corrupt lid-angle sensor readings are filtered out (one bad reading could flash or jump the black sheet), frame timing hiccups can no longer distort the motion, and the arming gesture keeps working if the OS changes how the Option key is reported.
  • The animation overlay now re-fits the built-in display on every arm, so it cannot end up missing or misplaced after plugging in or unplugging a display.

Changed

  • The shell-closing animation is dramatically cheaper to draw: only a thin strip at the moving edge is redrawn instead of the whole screen, frames where nothing moved are skipped entirely, and a steady close composites with no redrawing at all. Identical look and motion, less GPU and battery.

1.1.0

Added

  • Clamshell now keeps itself up to date. Updates download automatically in the background (arming is used as the ideal download moment) and install when the app quits or relaunches; nothing interrupts your work. Turn automatic updates off in Settings > General, or check manually in Settings > About.
  • "Deactivate on this Mac" in Settings > License: frees your license so it can be activated on another Mac (licenses cover one Mac at a time).

Changed

  • Clamshell is now a single one-time purchase. Onboarding and the purchase screens were simplified: start the free trial, or buy outright with one click; no plan choice.
  • Settings got a full redesign in Clamshell's dark "void" look: a solid blue-black window, grouped toggle rows, a cleaner icon + text tab row, and clearer License and About panes.
  • The menu bar clam now tints blue while armed, so the armed state is visible at a glance.

1.0.0

Initial release.