noahelhadedy/double-shot

What is it?

Key features

• 01Detects active AI agent sessions such as Claude Code, Codex and Gemini CLI and stays awake while they work.
• 02Keeps the Mac running with the lid closed, including on battery, after a one-time password setup.
• 03Turns the display off, enables Low Power Mode on battery and stops at a heat or battery threshold while the lid is closed.
• 04Supports custom agents by process name, including Python, Node and binary scripts.
• 05Offers timed and open-ended keep-awake sessions from the menu bar, plus doubleshot:// URL scheme automation.

Use cases

• Letting a long Claude Code or Codex run finish after closing the laptop lid and putting it in a bag.
• Keeping a Mac awake during a long-running local script or custom LangChain agent.
• Holding the Mac awake for a fixed period, such as during a download or a presentation.

Quick start

1. 1

   Install with Homebrew

   brew install --cask noahelhadedy/tap/double-shot
2. 2

   Or download the zip from the Releases page, unzip it and move Double Shot.app to Applications

3. 3

   Or clone the repository to build from source

   git clone https://github.com/noahelhadedy/double-shot.git

Things to know

• !macOS only, and building from source needs macOS 14 or later with Xcode 16 or later.
• !The app isn't notarized by Apple yet, so macOS requires a manual approval step on first open.
• !Lid closed mode needs a one-time admin password and adds a sudoers rule.

In collections

Topics

FAQ

What is double-shot?

A macOS menu bar app that keeps your Mac awake, including with the lid closed, while AI coding agents such as Claude Code and Codex are working. Double Shot is a menu bar app for macOS that prevents the Mac from sleeping. Its main difference from tools like caffeinate is that it watches AI agent sessions: it detects when Claude Code, Codex, Gemini CLI, Cursor Agent, Copilot CLI, OpenCode, Amp or Aider are actually working, including one-shot background runs, and keeps the Mac awake until they go quiet. Custom agents built with LangChain or plain scripts can be added by name in Settings.

Is double-shot free to use? What license does it have?

double-shot is open source under the MIT license. Check the license terms before using it in commercial products.

Is double-shot still maintained?

Actively maintained. The last commit to double-shot was on Nov 1, 2026.

What can I use double-shot for?

Letting a long Claude Code or Codex run finish after closing the laptop lid and putting it in a bag. Keeping a Mac awake during a long-running local script or custom LangChain agent. Holding the Mac awake for a fixed period, such as during a download or a presentation.

How do I install double-shot?

Install with Homebrew: brew install --cask noahelhadedy/tap/double-shot Or download the zip from the Releases page, unzip it and move Double Shot.app to Applications Or clone the repository to build from source: git clone https://github.com/noahelhadedy/double-shot.git

Where can I get double-shot?

The source code and installation instructions are on GitHub: https://github.com/noahelhadedy/double-shot