keep-computer-on-in-your-backpack 0.1.0

package/Info.plist

@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
+  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleDevelopmentRegion</key>
+  <string>en</string>
+  <key>CFBundleExecutable</key>
+  <string>BackpackAwakeMenu</string>
+  <key>CFBundleIdentifier</key>
+  <string>com.codex.backpack-awake-menu</string>
+  <key>CFBundleInfoDictionaryVersion</key>
+  <string>6.0</string>
+  <key>CFBundleName</key>
+  <string>Backpack Awake</string>
+  <key>CFBundlePackageType</key>
+  <string>APPL</string>
+  <key>CFBundleShortVersionString</key>
+  <string>1.0</string>
+  <key>CFBundleVersion</key>
+  <string>1</string>
+  <key>LSMinimumSystemVersion</key>
+  <string>14.0</string>
+  <key>LSUIElement</key>
+  <true/>
+  <key>NSHighResolutionCapable</key>
+  <true/>
+</dict>
+</plist>

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Declan Kramper
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,15 @@
+# Keep Computer On In Your Backpack
+
+Problem: closing your laptop to put it into your backpack turns it off. This is an issue if you want to keep using local coding tools like Claude code or Codex.
+
+Solution:
+1. run the script below to download this app
+2. click the backpack icon in your menu bar to keep your laptop in your backpack. This means you can use codex on the ChatGPT iPhone app to code while you’re commuting.
+
+```sh
+npx keep-computer-on-in-your-backpack
+```
+
+Note: the screen turns off, but computer is still on. Be wary of hot laptop running in your backpack.
+
+@dkbuilds.co

package/Sources/main.swift

@@ -0,0 +1,155 @@
+import AppKit
+
+private let stateDirectory = URL(fileURLWithPath: NSHomeDirectory())
+    .appendingPathComponent("Library/Application Support/BackpackAwake")
+private let stateFile = stateDirectory.appendingPathComponent("state")
+private let caffeinatePIDFile = stateDirectory.appendingPathComponent("caffeinate.pid")
+
+final class AppDelegate: NSObject, NSApplicationDelegate {
+    private var statusItem: NSStatusItem!
+    private let menu = NSMenu()
+    private let stateItem = NSMenuItem(title: "Status: Checking", action: nil, keyEquivalent: "")
+    private let toggleItem = NSMenuItem(title: "Turn On", action: #selector(toggle), keyEquivalent: "")
+    private var enabled = false
+    private var caffeinateProcess: Process?
+    private var timer: Timer?
+
+    func applicationDidFinishLaunching(_ notification: Notification) {
+        statusItem = NSStatusBar.system.statusItem(withLength: NSStatusItem.squareLength)
+        statusItem.autosaveName = "BackpackAwake"
+        statusItem.button?.title = ""
+        statusItem.button?.imagePosition = .imageOnly
+        setStatusIcon(symbolName: "backpack", fallbackSymbolName: "power.circle", tooltip: "Backpack Awake: Checking")
+
+        toggleItem.target = self
+        menu.addItem(stateItem)
+        menu.addItem(NSMenuItem.separator())
+        menu.addItem(toggleItem)
+        menu.addItem(NSMenuItem(title: "Refresh", action: #selector(refresh), keyEquivalent: "r"))
+        menu.items.last?.target = self
+        menu.addItem(NSMenuItem.separator())
+        menu.addItem(NSMenuItem(title: "Quit", action: #selector(quit), keyEquivalent: "q"))
+        menu.items.last?.target = self
+
+        statusItem.menu = menu
+        refresh()
+        timer = Timer.scheduledTimer(withTimeInterval: 10, repeats: true) { [weak self] _ in
+            self?.refresh()
+        }
+    }
+
+    @objc private func refresh() {
+        DispatchQueue.global(qos: .utility).async {
+            let status = self.readDesiredState()
+            DispatchQueue.main.async {
+                self.enabled = status
+                self.syncCaffeinateProcess()
+                self.render()
+            }
+        }
+    }
+
+    @objc private func toggle() {
+        let targetEnabled = !enabled
+        toggleItem.isEnabled = false
+        stateItem.title = "Status: Updating"
+        setStatusIcon(symbolName: "backpack", fallbackSymbolName: "power.circle", tooltip: "Backpack Awake: Updating")
+
+        DispatchQueue.global(qos: .userInitiated).async {
+            self.writeDesiredState(targetEnabled)
+            DispatchQueue.main.async {
+                self.enabled = targetEnabled
+                self.toggleItem.isEnabled = true
+                self.syncCaffeinateProcess()
+                self.render()
+            }
+        }
+    }
+
+    private func render() {
+        if enabled {
+            setStatusIcon(symbolName: "backpack.fill", fallbackSymbolName: "power.circle.fill", tooltip: "Backpack Awake: On")
+            stateItem.title = "Status: On"
+            toggleItem.title = "Turn Off"
+        } else {
+            setStatusIcon(symbolName: "backpack", fallbackSymbolName: "power.circle", tooltip: "Backpack Awake: Off")
+            stateItem.title = "Status: Off"
+            toggleItem.title = "Turn On"
+        }
+    }
+
+    private func syncCaffeinateProcess() {
+        if enabled {
+            if caffeinateProcess?.isRunning == true {
+                return
+            }
+
+            let process = Process()
+            process.executableURL = URL(fileURLWithPath: "/usr/bin/caffeinate")
+            process.arguments = ["-im"]
+
+            do {
+                try process.run()
+                caffeinateProcess = process
+                writeCaffeinatePID(process.processIdentifier)
+            } catch {
+                caffeinateProcess = nil
+            }
+        } else {
+            if caffeinateProcess?.isRunning == true {
+                caffeinateProcess?.terminate()
+            }
+            caffeinateProcess = nil
+            removeCaffeinatePID()
+        }
+    }
+
+    private func readDesiredState() -> Bool {
+        if let value = try? String(contentsOf: stateFile, encoding: .utf8)
+            .trimmingCharacters(in: .whitespacesAndNewlines) {
+            return value == "on"
+        }
+
+        return false
+    }
+
+    private func writeDesiredState(_ enabled: Bool) {
+        do {
+            try FileManager.default.createDirectory(at: stateDirectory, withIntermediateDirectories: true)
+            try (enabled ? "on\n" : "off\n").write(to: stateFile, atomically: true, encoding: .utf8)
+        } catch {
+            return
+        }
+    }
+
+    private func writeCaffeinatePID(_ pid: Int32) {
+        do {
+            try FileManager.default.createDirectory(at: stateDirectory, withIntermediateDirectories: true)
+            try "\(pid)\n".write(to: caffeinatePIDFile, atomically: true, encoding: .utf8)
+        } catch {
+            return
+        }
+    }
+
+    private func removeCaffeinatePID() {
+        try? FileManager.default.removeItem(at: caffeinatePIDFile)
+    }
+
+    private func setStatusIcon(symbolName: String, fallbackSymbolName: String, tooltip: String) {
+        let image = NSImage(systemSymbolName: symbolName, accessibilityDescription: tooltip)
+            ?? NSImage(systemSymbolName: fallbackSymbolName, accessibilityDescription: tooltip)
+        image?.isTemplate = true
+        statusItem.button?.image = image
+        statusItem.button?.toolTip = tooltip
+    }
+
+    @objc private func quit() {
+        NSApp.terminate(nil)
+    }
+}
+
+let app = NSApplication.shared
+let delegate = AppDelegate()
+app.delegate = delegate
+app.setActivationPolicy(.accessory)
+app.run()

package/bin/install.mjs

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+if (process.platform !== "darwin") {
+  console.error("Backpack Awake can only be installed on macOS.");
+  process.exit(1);
+}
+
+const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+const installer = resolve(packageRoot, "install.sh");
+
+const result = spawnSync("/bin/zsh", [installer], {
+  cwd: packageRoot,
+  env: {
+    ...process.env,
+    BACKPACK_AWAKE_SOURCE_DIR: packageRoot,
+  },
+  stdio: "inherit",
+});
+
+if (result.error) {
+  console.error(result.error.message);
+  process.exit(1);
+}
+
+process.exit(result.status ?? 1);

package/install.sh

@@ -0,0 +1,84 @@
+#!/bin/zsh
+set -eu
+
+REPO_URL="${REPO_URL:-https://github.com/declankra/keep-computer-on-in-your-backpack.git}"
+WORK_DIR="${TMPDIR:-/tmp}/backpack-awake-install"
+SOURCE_DIR="${BACKPACK_AWAKE_SOURCE_DIR:-}"
+APP_NAME="Backpack Awake.app"
+APP_DIR="$HOME/Applications/$APP_NAME"
+STATE_DIR="$HOME/Library/Application Support/BackpackAwake"
+LOGIN_AGENT="$HOME/Library/LaunchAgents/com.declankramper.backpack-awake-menu.plist"
+CONTROLLER_DIR="/Library/Application Support/BackpackAwake"
+CONTROLLER_PATH="$CONTROLLER_DIR/backpack-awake-controller"
+CONTROLLER_PLIST="/Library/LaunchDaemons/com.declankramper.backpack-awake-controller.plist"
+LOG_DIR="/Library/Logs/BackpackAwake"
+
+need_command() {
+  if ! command -v "$1" >/dev/null 2>&1; then
+    echo "Missing required command: $1" >&2
+    exit 1
+  fi
+}
+
+need_command swiftc
+need_command codesign
+
+if [[ -n "$SOURCE_DIR" ]]; then
+  WORK_DIR="$SOURCE_DIR"
+else
+  need_command git
+  rm -rf "$WORK_DIR"
+  git clone --depth 1 "$REPO_URL" "$WORK_DIR"
+fi
+
+mkdir -p "$APP_DIR/Contents/MacOS" "$HOME/Applications" "$STATE_DIR" "$HOME/Library/LaunchAgents"
+
+swiftc "$WORK_DIR/Sources/main.swift" -framework AppKit -o "$APP_DIR/Contents/MacOS/BackpackAwakeMenu"
+cp "$WORK_DIR/Info.plist" "$APP_DIR/Contents/Info.plist"
+codesign --force --deep --sign - "$APP_DIR" >/dev/null
+
+if [[ ! -f "$STATE_DIR/state" ]]; then
+  printf 'off\n' > "$STATE_DIR/state"
+fi
+
+cat > "$LOGIN_AGENT" <<PLIST
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
+  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.declankramper.backpack-awake-menu</string>
+
+  <key>ProgramArguments</key>
+  <array>
+    <string>/usr/bin/open</string>
+    <string>$APP_DIR</string>
+  </array>
+
+  <key>RunAtLoad</key>
+  <true/>
+</dict>
+</plist>
+PLIST
+
+if [[ "${BACKPACK_AWAKE_SKIP_PRIVILEGED:-0}" != "1" ]]; then
+  echo "Installing the privileged controller. macOS may ask for your password once."
+  sudo mkdir -p "$CONTROLLER_DIR" "$LOG_DIR"
+  sudo install -o root -g wheel -m 755 "$WORK_DIR/scripts/backpack-awake-controller" "$CONTROLLER_PATH"
+  sudo install -o root -g wheel -m 644 "$WORK_DIR/scripts/com.declankramper.backpack-awake-controller.plist" "$CONTROLLER_PLIST"
+  sudo launchctl bootout system "$CONTROLLER_PLIST" 2>/dev/null || true
+  sudo launchctl bootstrap system "$CONTROLLER_PLIST"
+  sudo launchctl kickstart -k system/com.declankramper.backpack-awake-controller
+else
+  echo "Skipping privileged controller install."
+fi
+
+if [[ "${BACKPACK_AWAKE_SKIP_LAUNCH:-0}" != "1" ]]; then
+  launchctl bootout "gui/$(id -u)" "$LOGIN_AGENT" 2>/dev/null || true
+  launchctl bootstrap "gui/$(id -u)" "$LOGIN_AGENT"
+  launchctl kickstart -k "gui/$(id -u)/com.declankramper.backpack-awake-menu"
+  open "$APP_DIR"
+fi
+
+echo "Installed. Look for the backpack icon in your menu bar."

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "keep-computer-on-in-your-backpack",
+  "version": "0.1.0",
+  "description": "A macOS menu bar app that keeps your laptop awake with the lid closed while letting the screen turn off.",
+  "bin": {
+    "keep-computer-on-in-your-backpack": "bin/install.mjs"
+  },
+  "files": [
+    "bin",
+    "install.sh",
+    "Info.plist",
+    "Sources",
+    "scripts"
+  ],
+  "os": [
+    "darwin"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node --check bin/install.mjs && zsh -n install.sh && zsh -n scripts/backpack-awake-controller && plutil -lint Info.plist scripts/com.declankramper.backpack-awake-controller.plist",
+    "pack:check": "npm pack --dry-run"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/declankra/keep-computer-on-in-your-backpack.git"
+  },
+  "homepage": "https://github.com/declankra/keep-computer-on-in-your-backpack#readme",
+  "bugs": {
+    "url": "https://github.com/declankra/keep-computer-on-in-your-backpack/issues"
+  },
+  "license": "MIT"
+}

package/scripts/backpack-awake-controller

@@ -0,0 +1,88 @@
+#!/bin/zsh
+set -eu
+
+PATH=/usr/bin:/bin:/usr/sbin:/sbin
+
+LOG_FILE=/Library/Logs/BackpackAwake/controller.log
+
+log() {
+  printf '%s %s\n' "$(/bin/date '+%Y-%m-%d %H:%M:%S')" "$*" >> "$LOG_FILE"
+}
+
+console_user() {
+  /usr/sbin/scutil <<< "show State:/Users/ConsoleUser" \
+    | /usr/bin/awk '/Name :/ { print $3; exit }'
+}
+
+console_home() {
+  local user="$1"
+  /usr/bin/dscl . -read "/Users/$user" NFSHomeDirectory 2>/dev/null \
+    | /usr/bin/awk '{ print $2; exit }'
+}
+
+state_paths() {
+  local user home
+  user="$(console_user)"
+  if [[ -z "$user" || "$user" == "loginwindow" ]]; then
+    return 1
+  fi
+
+  home="$(console_home "$user")"
+  if [[ -z "$home" || ! -d "$home" ]]; then
+    return 1
+  fi
+
+  STATE_DIR="$home/Library/Application Support/BackpackAwake"
+  STATE_FILE="$STATE_DIR/state"
+  PID_FILE="$STATE_DIR/caffeinate.pid"
+}
+
+sleep_disabled() {
+  /usr/bin/pmset -g | /usr/bin/grep -q 'SleepDisabled[[:space:]]*1'
+}
+
+desired_state() {
+  if [[ -f "$STATE_FILE" ]]; then
+    /bin/cat "$STATE_FILE" 2>/dev/null | /usr/bin/tr -d '[:space:]'
+  else
+    echo "off"
+  fi
+}
+
+kill_recorded_caffeinate() {
+  [[ -f "$PID_FILE" ]] || return 0
+  local pid
+  pid="$(/bin/cat "$PID_FILE" 2>/dev/null || true)"
+  [[ -n "$pid" ]] || return 0
+
+  if /bin/ps -p "$pid" -o comm= 2>/dev/null | /usr/bin/grep -q '^caffeinate$'; then
+    /bin/kill "$pid" 2>/dev/null || true
+    log "killed recorded caffeinate pid $pid"
+  fi
+  /bin/rm -f "$PID_FILE"
+}
+
+apply_once() {
+  state_paths || return 0
+
+  case "$(desired_state)" in
+    on)
+      if ! sleep_disabled; then
+        /usr/bin/pmset -a disablesleep 1
+        log "enabled SleepDisabled"
+      fi
+      ;;
+    *)
+      kill_recorded_caffeinate
+      if sleep_disabled; then
+        /usr/bin/pmset -a disablesleep 0
+        log "disabled SleepDisabled"
+      fi
+      ;;
+  esac
+}
+
+while true; do
+  apply_once
+  /bin/sleep 2
+done

package/scripts/com.declankramper.backpack-awake-controller.plist

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
+  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.declankramper.backpack-awake-controller</string>
+
+  <key>ProgramArguments</key>
+  <array>
+    <string>/Library/Application Support/BackpackAwake/backpack-awake-controller</string>
+  </array>
+
+  <key>RunAtLoad</key>
+  <true/>
+
+  <key>KeepAlive</key>
+  <true/>
+
+  <key>StandardOutPath</key>
+  <string>/Library/Logs/BackpackAwake/controller.out</string>
+
+  <key>StandardErrorPath</key>
+  <string>/Library/Logs/BackpackAwake/controller.err</string>
+</dict>
+</plist>