Free macOS app · part of AgentSkillDeck

Keep your Mac awake for agents, even with the lid closed.

Keepwatch is a menu-bar app for people who run Claude Code, Codex and other coding agents for hours. Your Mac stays awake exactly while they work, keeps going with the lid shut, then sleeps on schedule. It also keeps watch on your mic and camera.

macOS 14 or laterApple silicon and IntelSigned and notarizedNo account, no trackingLinux (tray and lid) and Windows, in beta
Watch

Every tab in 85 seconds.

The real app, showing made-up demo data. The narration was made on device with the AgentSkillDeck audio plugin. Pick a chapter.

keepwatch-tour.mp4 · Meet Keepwatch
Meet KeepwatchNarrated tour · 1:25 · captions on screen

Chapters

Music: “Soft Corporate” by MusicLFiles, CC BY 4.0. Voice: Supertonic 3, generated on device; an AI voice, not a real person. Download the MP4.

What it does

Everything a laptop developer reaches for, in one menu.

No more choosing between a sleeping Mac that kills a three-hour agent run and a Mac left awake all night in your bag.

Stay awake

One click for 1 h, 3 h, 8 h, a day or forever, any custom time up to 30 days, or until 18:30. Or only while your agents run.

  • Sleeps two minutes after the last agent exits
  • Stops when you unplug or at 15% battery, if you like
  • ⌃⌥⌘K toggles it from any app

Agent sessions

Claude Code, Codex, Gemini CLI, Aider, OpenCode, Goose, Amp and more, grouped by assistant with the folder, start time and whether each is working or idle.

  • A ping when an agent finishes or goes quiet
  • Stop one session or all, after a confirmation
  • Idle helpers never count

Lid-closed sessions

Keep working with the lid shut, then sleep 1, 3, 6 or 12 hours after it closes, at a set time, or when agents finish. One password per session.

  • On power, or on battery above 20%
  • 12-hour cap and a thermal cut-out
  • A watchdog ends it even if the app quits

Mic and camera

A red badge in the menu bar while either is live, which app is listening, a mic switch, and alerts when either turns on.

  • Turn off… jumps to the Camera list in Settings
  • A history kept only on your Mac
  • Keepwatch itself never records anything

Security and battery

Firewall, FileVault, Gatekeeper, SIP and AirDrop at a glance, a notice when a new program starts itself at login, plus battery health over time and a shortcut to macOS's charge limit.

  • Read-only: it never changes a security setting
  • Each check opens the right Settings pane
  • Remove your own startup items in two clicks

Stay active

Slack, Teams, Zoom and other chat apps mark you away after a few idle minutes, even when the Mac is awake. Stay active moves the pointer one pixel when you've been idle, so they don't.

  • Off by default; 2, 4 or 9 idle minutes
  • Never clicks or types, never with the lid closed
  • Asks for Accessibility only when you turn it on

Apps, ports and storage

See which apps use the most memory and quit them, find what is listening on :3000, stop a forgotten dev server, and see which caches and Xcode folders fill your disk.

  • macOS's own processes are never offered
  • A low-disk warning you set: 5 to 50 GB
  • Quick timer from the menu: 5 to 45 minutes
  • ⌃⌥⌘S opens Apple's screenshot and screen-video toolbar
For your agents

A command line your agents can use.

Install the keepwatch command from the dashboard. Agents get stable JSON and exit codes. They can ask for a lid session, but only you can approve it, by typing your password on the Mac.

zsh: ~/code/website
# stay awake exactly while a command runs
$ keepwatch run -- npm test

# for 2 days, or until 18:30
$ keepwatch awake --for 2d
$ keepwatch awake --until 18:30

$ keepwatch agents
Claude Code  41201  website     working
Codex        42010  mobile-app  working
claude: ~/your-project
# teach Claude Code and Codex when to use it
$ npx skills add AgentSkillDeck/keepwatch

# or as a plugin from the AgentSkillDeck marketplace
> /plugin marketplace add AgentSkillDeck/skills
> /plugin install keepwatch@agentskilldeck

> keep my Mac awake until the tests pass
✓ keepwatch run -- npm test
The dashboard

Pick what the summary shows.

Then switch tabs: Awake, Agents, Lid closed, Privacy, Security, Battery, Apps and Settings.

The Keepwatch menu: awake status, mic, camera and screen tiles, keep-awake buttons, a quick timer and laptop-closed controls
The menu
Keepwatch dashboard: summary tiles for battery, health, agent sessions, microphone and camera above the tabs and keep-awake controls
The dashboard
Keepwatch Privacy tab: microphone switch, camera status with Turn off, alerts and a local history
Privacy
How it is built

Safe by default, and yours to read.

A bug in a power tool can leave a laptop sleepless in a bag, so the rules are strict.

One privileged path

Only a lid session asks for your password, and only you can approve it. Never from a link or an agent.

Nothing by default

No mic, camera, Screen Recording or Full Disk Access permission, and no network. Accessibility and the update check only if you turn them on.

Light

About 15 MB of memory and under 1% CPU. Native Swift and SwiftUI.

Open source

Apache-2.0, signed with a Developer ID and notarized by Apple.

Questions

Before you install.

Can a MacBook keep running with the lid closed without an external display?

Not by default: closing the lid sleeps the Mac unless an external display, power and keyboard are attached. Keepwatch runs a lid-closed session: you enter your password once, it turns sleep off, and a small watchdog turns sleep back on and puts the Mac to sleep after the time you chose, at a set time, when your agents finish, or if the battery gets low.

Why does my Mac ask for a password when I open the lid?

The Mac kept working, but macOS locks the screen once the display has been off for the delay in System Settings › Lock Screen. That protects a laptop left in a bag, so Keepwatch leaves it alone.

How do I keep my Mac awake while Claude Code or Codex is running?

Turn on “While AI agents run”, or run keepwatch awake --agents. Agents can also wrap a single command with keepwatch run -- <command>.

Is it safe to keep a MacBook awake with the lid closed in a bag?

Heat in a closed bag is the main risk, so lid sessions only start on power or on battery above 20%, end on serious thermal pressure or at 20% battery, are capped at 12 hours, and every launch checks that sleep was not left off.

How is Keepwatch different from caffeinate or Amphetamine?

caffeinate can't keep a Mac awake with the lid closed, and Amphetamine needs a separate helper for that. Keepwatch knows when agent CLIs are running, ends lid sessions on its own, watches the mic and camera, and ships a CLI agents can call.

Does Keepwatch work on Linux or Windows?

Yes, in beta. On Linux there is a tray icon and laptop-closed sessions with the same rules as on the Mac, with no password: Keepwatch asks systemd to ignore the lid only while it runs, so if it crashes the laptop sleeps as usual. Stock GNOME needs the AppIndicator extension for the icon. Windows has the keepwatch command (status, awake, run, agents, ports) for now. Mic mute is macOS only.

Does Keepwatch need microphone or camera permission?

No. It never records anything; it only asks macOS whether the microphone or camera is running. It asks for Accessibility only if you turn on Stay active, and goes online only if you turn on the update check.

Lid-closed sessions are in beta. Read exactly what runs with administrator rights in SECURITY.md.

Install

Download, drag, done.

Open the DMG, drag Keepwatch to Applications, and find the eye in your menu bar. Then install the command from the dashboard.

Linux and Windows (beta, v0.4.0-beta.1): Linux x86_64 (tray icon, laptop-closed sessions and the command, static, any distribution with systemd) · Windows x86_64 (command line; not code-signed yet, so SmartScreen may warn) · checksums · what works.

See details