Aqtive

Your Mac goes to sleep. Your Claude Code session keeps running. You come back to a dead terminal and start over.

Aqtive stops that.

It watches your Claude sessions and keeps your Mac awake — automatically — while work is actually happening. When the session goes idle, it steps back. No background service, no menubar icon, no fuss. A CLI that does one thing and cleans up after itself.

Close the lid. Go get coffee. Walk to the office. Come back to a finished build.

---

Install

git clone https://github.com/jayverstraete/aqtive
cd aqtive

Lid-close support (optional — lets your Mac keep running with the lid shut):

sudo visudo -f /etc/sudoers.d/aqtive

Add this, replacing youruser:

youruser ALL=(ALL) NOPASSWD: /usr/bin/pmset -a sleep 0
youruser ALL=(ALL) NOPASSWD: /usr/bin/pmset -a sleep 1

That's it. One-time setup.

---

Use

Start the daemon — it handles everything:

python -m aqtive.cli daemon

Detects active Claude sessions. Keeps the machine awake. Releases when idle. Backs off when battery gets low. You don't have to think about it.

Extra guards if you need them:

python -m aqtive.cli daemon --network-guard --battery-threshold 20

--network-guard drops caffeination when you lose network. --battery-threshold sets the low-battery cutoff (default 15%).

Manual controls if you want them:

python -m aqtive.cli caff --seconds 1800   # stay awake for 30 min
python -m aqtive.cli clamshell --enable    # survive lid close
python -m aqtive.cli status                # what's currently running

---

Requirements

macOS only. Wraps caffeinate and pmset — both built into every Mac since forever.

Python 3.11+. No runtime dependencies.