Claffeinate 0.3.4

修正

• Decaf 移行時に蓋が閉じていれば即スリープ（0.3.3 の再修正） — 0.3.3 の IOPMSleepSystem による強制スリープは成功を返しても実際にはスリープしませんでした。macOS が蓋閉じスリープを再評価するのは、ランタイムの clamshell 抑止ビット（IOPMrootDomain の kPMSetClamshellSleepState, selector 12）が 1→0 に遷移したときだけ、という挙動に基づき実装し直しました。helper はこのビットを抑止の有効化時に立て、解除時に下ろす（両エッジでミラー)ことで、蓋を閉じたままでも解除と同時に再評価が走り、設定どおりスリープに入ります。成功・失敗ともログを残します。

---

配布物は Developer ID 署名 + 公証済みです。zip を展開 → /Applications に移動 → 起動で、Gatekeeper の警告なく利用できます。

Claffeinate 0.3.3

修正

• Decaf 移行時に蓋が閉じていれば即スリープ — Claude が止まって Decaf モードに戻ったとき、ノートの蓋を閉じたままだと Mac がスリープせず起き続ける（音楽が鳴り続ける／タスクが走り続ける）問題を修正しました。macOS は「蓋閉じ→スリープ」を蓋イベントの瞬間にしか評価しないため、抑止を解除（SleepDisabled=false）しても蓋を開閉するまで再評価されません。helper が解除時に蓋の状態（AppleClamshellState）を確認し、閉じていれば IOPMSleepSystem でスリープを発火するようにしました。蓋が開いているときは通常どおりアイドルスリープに委ねます。

---

配布物は Developer ID 署名 + 公証済みです。zip を展開 → /Applications に移動 → 起動で、Gatekeeper の警告なく利用できます。

Claffeinate 0.3.2

Clearer "how much longer will my Mac stay awake?" status, reframed around the caffeine metaphor.

Improvements

• While Claude is working, the state card now shows a live Caffeinating pulse instead of a climbing elapsed timer. Caffeine is being topped up, so there's nothing to count down — and the old "for 34m" figure no longer reads as if it conflicts with your idle grace setting.
• During the post-turn wind-down, the card now headlines the time that actually matters: wears off in 8m — how long until the caffeine fades and your Mac may sleep. The hero echoes it ("caffeine wears off in 8m").

Install

The download is Developer ID-signed and notarized by Apple. Unzip, move Claffeinate.app to /Applications, and launch — no Gatekeeper prompt.

Claffeinate 0.3.1

Stay caffeinated through the idle grace period

Previously the Mac dropped out of the caffeinated state the instant Claude finished a turn — so it flipped to "needs attention" right away, and the idle grace period never actually applied after a turn ended.

Now, when a turn ends, Claffeinate holds the Mac awake for your configured idle grace period (default 10 min) before letting it sleep. During that window the menu shows a "Winding down" state with the remaining time. A new prompt resumes work immediately, and quitting Claude releases the hold right away.

---

The download is Developer ID-signed and notarized by Apple: unzip, move Claffeinate.app to /Applications, and launch — no Gatekeeper prompt.

Claffeinate 0.3.0

Cleaner hook management, in-place feedback, and full Debug/Release isolation.

What's new

• Hook actions give feedback in place. Setting up or removing Claude hooks now shows the result inline in the panel instead of popping a modal that closed the menu — the panel stays open so you see exactly what happened.
• Remove Claffeinate Hooks. A new button cleanly strips Claffeinate's hooks from ~/.claude/settings.json (including any old/duplicate entries) while leaving your own hooks untouched, with a backup saved alongside.
• "Set Up Claude Hooks" now reflects real install state — it no longer nudges you to set up hooks that are already installed.

Under the hood

• Debug builds are fully isolated from the installed app. A development build now uses a separate .develop identity, never registers the privileged helper, and carries a "DEV" badge on the menu bar icon — so running a dev build can't collide with or disrupt the released app (or Claude Code).
• Hardened the hook entry point so a stale/mismatched hook can never launch the UI.

Install

Unzip and move Claffeinate.app to /Applications, then launch it. The build is Developer ID-signed and notarized by Apple, so it opens without a Gatekeeper prompt. On 0.2.1+ you can also update in place from Check for Updates → Install & Relaunch.

Claffeinate 0.2.2

In-app updates and a Helper status fix.

What's new

• Install updates in place. "Check for Updates" now offers Install & Relaunch: Claffeinate downloads the release, verifies it (SHA-256 against GitHub's published digest, a valid Developer ID code signature, and a matching Team ID), swaps it in over the running app, and relaunches — no more bouncing out to the Releases page in a browser.
• Fix: Helper showed "Off" until Claude first became busy. The Helper connection status is now probed at launch, after toggling the helper in System Settings, and right after installing hooks — so it reflects reality immediately instead of looking disconnected while idle.

Install

Unzip and move Claffeinate.app to /Applications, then launch it. The build is Developer ID-signed and notarized by Apple, so it opens without a Gatekeeper prompt.

Claffeinate 0.2.1

What's new

• Configurable idle grace period. Choose how long Claffeinate keeps your Mac awake after Claude's last hook event when a closing hook never fires (e.g. a Ctrl-C interrupt or a long silent stretch mid-turn). Pick 10 / 15 / 30 / 60 / 120 minutes from the menu — the previous fixed 10-minute window is now the minimum and the default.

Install

Download Claffeinate-0.2.1.zip, unzip, move Claffeinate.app to /Applications, and launch. The build is Developer ID-signed and notarized, so it opens without a Gatekeeper prompt.

Claffeinate 0.2.0

Claffeinate keeps your Mac awake only while Claude Code is actually working — now driven by Claude Code hooks instead of CPU heuristics.

What's new in 0.2.0

• Precise, hook-based detection. One click (Set Up Claude Hooks in the panel) installs Claude Code hooks that report exact turn/tool boundaries — including long, silent builds between a tool's start and end. No CPU guessing.
• Transcript fallback for sessions without hooks (model-streaming activity).
• Three honest states: Busy / Needs attention (a permission prompt — sleep allowed) / Idle, with the reason and per-turn elapsed shown in the panel.
• Multi-session aware and per-session — one session can't mask another; headless --enable-auto-mode agents are protected too.
• Removed the CPU sampler, grace period, and CPU meter (they false-positived on idle terminal rendering).

Install

Requires macOS 26+. Download Claffeinate-0.2.0.zip, unzip, move Claffeinate.app to /Applications, launch, approve the one-time helper prompt, then click Set Up Claude Hooks.

Developer ID-signed and notarized by Apple — opens without a Gatekeeper warning.

Claffeinate 0.1.0

Claffeinate 0.1.0 — first release

A macOS menu bar app that keeps your Mac awake only while Claude / Claude Code is actively working, including with the lid closed, and lets it sleep once Claude goes idle.

Highlights

• Automatic detection of Claude / Claude Code activity (process-tree CPU aware)
• Prevents system sleep including lid-close (clamshell), via a privileged helper
• Configurable idle grace period (default 30 min) so long tasks aren't cut short
• Authorize the helper once; menu-bar only, no Dock icon
• A heartbeat watchdog restores normal sleep even if the app crashes

Install

1. Download Claffeinate-0.1.0.zip, unzip, move Claffeinate.app to /Applications.
2. Launch it and approve the one-time helper prompt.

Signed with Developer ID and notarized by Apple.

Requires macOS 26 or later (Apple Silicon).