旧来の方法ではなぜ足りないのか

Adrafinil以前、Macに長時間タスクを実行させながら眠らせないようにするには、両極端な2つの選択肢しかなく、どちらも「タスクが実際に動いている」時間帯には正確に合わせられなかった。

caffeinateとAmphetamineは興奮剤タイプで、起動すればずっと覚醒状態のまま、仕事があるかどうかは関係ない。タスクがとっくに終わっていても、マシンは空転して電力を消費し発熱し続ける。逆に何もインストールしなければ、フタを閉じればすぐ眠り、長時間タスクはそこで中断される。以下では3つのケースを同じ時間軸上に並べてみる：スリープ防止のウィンドウとタスクのウィンドウが噛み合っているかどうか、一目で分かる。

caffeinateのスリープ防止バーは最初から最後まで点灯しっぱなしで、タスク終了後のあの長い区間は完全に無駄だ。何もインストールしていない行では、フタを閉じた箇所に赤いバツ印がつき、タスクが終わる前に打ち切られる。adrafinilのバーだけがタスクウィンドウにぴったり貼りつき、前後に1秒たりとも余分に維持しない。

Agentの「呼吸」に合わせる

Adrafinilのコアはシンプルだ：Agentが仕事を始めたらスリープ防止をリクエストし、手を止めたら解放する。MacはAgentが実際にタスクを実行している間だけ覚醒を保つ。メニューバーのアイコンもこの2状態しかない。

「awake」状態：Agentが稼働中、メニューバーアイコンはスリープ防止中を表示。出典：プロジェクトのREADME

「sleeping」状態：Agentが動いていない、Macは通常どおりスリープ。出典：プロジェクトのREADME

AgentはAdrafinilと直接会話するのではなく、それぞれのHookシステムを通じて付属のコマンドラインを呼び出す。

Claude Codeを例にすると、シグナルの流れ全体はこうなる：

複数同時実行でも混乱しない

複数のAgentが同時に動く場合はどうするのか？Adrafinilは参照カウントを使う：各セッションが開始すると+1、終了すると−1、カウントがゼロになって初めてスリープ防止を解除する。

以下のカウントリングはこのページの目玉だ。いくつかAgentを試しに点灯させてみよう：リング内の数字が0より大きい限り、Macはスリープ防止状態になる（青いパルス）。1つずつオフにしていき、数字がゼロになった瞬間にリングはグレーに変わり、Macは本当に眠れるようになる。

フタを閉じても熱暴走しない

フタを閉じたまま長時間タスクを走らせて一番怖いのは、バッグに入れたまま放熱が追いつかず、マシンを痛めてしまうことだ。Adrafinilには温度保護機能が内蔵されており、これこそが安心してフタを閉じて離席できる要のセーフティネットだ。

温度以外にも、もう1つ自動解放の仕組みがある：アサーションを保持しているプロセスが既に落ちている、あるいはCPUがN分以上アイドル状態が続いた場合、対応するスリープ防止は自動的に破棄され、「プログラムがクラッシュしたのにスリープ防止だけ残る」という抜け穴を塞ぐ。

フタを閉じた状態では画面が消えていて通知は出せないため、確認音を1つ鳴らしてスリープ防止が有効になったことを知らせる。再びフタを開けた時にはサマリーを表示する：離席中に何が動いていたか、最高温度は何度だったか、温度保護が発動したかどうか。

rootは1つのことしかしない

クラムシェルスリープの阻止にはroot権限が避けられない、これはmacOSの厳格な仕様だ。Adrafinilのやり方は、rootの接触面を極限まで小さく圧縮することにある。

まずなぜrootが必須なのかを説明しよう。Macのスリープ防止には2種類ある：「アイドルスリープ」を阻止するなら普通のAPI（IOPMAssertion）で十分だが、「クラムシェルスリープ」（clamshell sleep）を阻止するにはroot権限のpmset disablesleepが必須だ。Adrafinilは両方を行うからこそ、フタを閉じたままタスクを維持できる。

その解決策は、このわずかなroot権限を最小の箱の中に閉じ込めることだ。アーキテクチャ全体は3層構造で、縦に見ていくとこうなる：

どの9種類に対応、どうインストールするか

1つのコマンドですべてのAgentの設定にHookを書き込める。まず対応リストを見てみよう：

インストールする

署名済みで公証（notarize）されたdmgをダウンロードし、開いてApplicationsにドラッグ、起動する。初回起動時にadmin権限を1回リクエストし、あの特権Helperを登録する。その後install-hooksコマンド1つで、上記すべてのAgentの設定にHookを書き込める。使わなくなったら、uninstall-hooksが追加したHook項目をすべてきれいに削除してくれる。

システム要件

macOS Tahoe 26.4以上（それより前の26.xでも動く可能性はあるが、作者はテストしていない）。自分でビルドするならXcode 26以上が必要で、Swift 6の厳格な並行処理を有効にする。管理者権限なしでインストールした場合、CLIは/usr/local/binではなく~/.local/binに置かれる。

覚えておくと便利なコマンドがあと2つ

応答よりも長く生き続けるバックグラウンドタスク（長時間のビルドやデプロイなど）には、タイムアウト付きのholdコマンドで一定時間維持し、時間になれば自動的に解放できる。MCPに対応したAgentなら、adrafinil mcpが提供するツール呼び出しを直接使うこともできる：

Adrafinilは発想を変えた：常に覚醒し続けるのではなく、AIの「仕事開始」と「仕事終了」に合わせて動く。Agentが仕事を始めた瞬間に「眠らせないで」とリクエストし、手を止めた瞬間にスリープの制御権を返す。

ではMacはAgentがいつ仕事を始め、いつ終えるのかをどうやって知るのか？下の図を見てほしい。

その仕組みはこうだ：Agentはそれぞれの Hook（フック、プログラムがあらかじめ用意した自動トリガーポイント）を通じて、仕事を始める時にacquire（カウント+1）、終える時にrelease（カウント−1）を呼び出す。複数のAgentが同時に動けばカウントは積み上がり、最後の1つが手を止めてカウントがゼロになった時、Macは本当に眠りにつく。

小互 は深夜にフタを閉じて眠ったが、Claude Codeはビルド中、Cursorはテスト中。タスクを1つ開始するごとにカウント+1、1つ終えるごとに−1。カウントが0より大きい限り、Macは眠らずに持ちこたえる（フタを閉じても）。ゼロになった瞬間、ようやく眠りにつく。

ここで大事なのは「どれだけ速いか」ではなく、どれだけ無駄な「覚醒」を省けるかだ。例を挙げて体感してみよう。

以上の数値はいずれも作者kageroumadoがmacOS Tahoe 26.4上で自ら計測した、またはプロジェクトのドキュメントに記載されたものであり、第三者による再現検証は行われていない。