Skip to content

Releases

Keepwatch for Linux and Windows 0.4.0-beta.1 (beta)

Choose a tag to compare

@JKL404 JKL404 released this 17 Oct 09:51
8a8fb20

Beta for Linux and Windows. It doesn't affect the Mac app: Mac users stay on v0.3.0.

New on Linux

  • Tray icon (keepwatch-tray): see whether the computer is being kept awake and for how long. Keep awake for 1 h, 3 h or 8 h, until you turn it off, or while agents run. Start or end a laptop-closed session, see running agents, and open it at login. It works on KDE, Ubuntu, XFCE and Cinnamon; stock GNOME needs the AppIndicator extension.
  • Laptop-closed sessions: keepwatch lid start --hours 3 (or from the tray) keeps the laptop running with the lid shut, then suspends it.
    • Rules: it sleeps N hours after the lid closes (opening the lid resets the timer). It can also sleep at a set time (--at 01:00) or when agents finish (--until-agents-done). On battery it starts only above 20% and ends at 20%. It ends if the laptop is too hot, and after 12 hours at most.
    • No password and no root: Keepwatch asks systemd to ignore the lid while the session runs. If Keepwatch crashes or is killed, that request goes with it, so the laptop sleeps as usual.
    • keepwatch lid end and keepwatch lid status [--json]. A log is kept in ~/.local/state/keepwatch/lid.log.

Downloads

  • keepwatch-0.4.0-beta.1-linux-x86_64.tar.gz: keepwatch and keepwatch-tray, static, for any x86_64 distribution. Keeping awake and lid sessions need systemd (logind).
  • keepwatch-0.4.0-beta.1-windows-x86_64.zip: keepwatch.exe (command line; no tray and no lid sessions on Windows yet). It isn't code-signed, so SmartScreen may warn.

Check a download: sha256sum -c SHA256SUMS.txt --ignore-missing

Install on Linux

tar -xzf keepwatch-0.4.0-beta.1-linux-x86_64.tar.gz
install -m 755 keepwatch-0.4.0-beta.1-linux-x86_64/keepwatch keepwatch-0.4.0-beta.1-linux-x86_64/keepwatch-tray ~/.local/bin/
keepwatch-tray &        # then "Open at login" in its menu

Not tested on real laptops yet

  • Tested so far: CI (Ubuntu, Windows) and containers, with stand-ins for the lid, battery and systemd. The tray was tested over D-Bus by clicking its real menu.
  • Not yet tested: whether your desktop's power manager honours the lid block, and how the icon looks in your panel. Please open an issue with what you see.

Keepwatch 0.3.0

Choose a tag to compare

@JKL404 JKL404 released this 16 Oct 18:27
f5d2da8

Lid sessions that end reliably, a quick timer, storage and startup-item checks, in-app updates, and a lot of polish.

Download

Keepwatch-0.3.0.dmg (or the .zip): universal (Apple Silicon and Intel), macOS 14 or later, signed with a Developer ID and notarized by Apple. Open the DMG and drag Keepwatch to Applications.

Command line only: keepwatch-cli-0.3.0-macos.zip (notarized), or
curl -fsSL https://raw.githubusercontent.com/AgentSkillDeck/keepwatch/main/scripts/install-cli.sh | sh

Linux and Windows (command line, beta):

  • keepwatch-0.3.0-linux-x86_64.tar.gz: a static binary for any x86_64 distribution. Keeping awake needs systemd.
  • keepwatch-0.3.0-windows-x86_64.zip: keepwatch.exe. It isn't code-signed yet, so SmartScreen may warn.

Both have the same status, awake, run, agents, ports, privacy and apps commands and JSON as on the Mac. There are no lid sessions, mic mute or tray app there yet. See cross/README.md.

Check your download: shasum -a 256 -c SHA256SUMS.txt --ignore-missing

Fixed

  • Lid sessions end properly. The watchdog runs as its own launchd job, and ending a session turns sleep back on within about 2 seconds.
  • Quick timer no longer slows the app down.
  • Mic switch works with virtual devices such as Microsoft Teams Audio installed.
  • The screenshot toolbar can no longer get stuck off screen.

New

  • Updates in the app: Install and relaunch, only after the checksum, signature and notarization checks pass.
  • Quick timer from the menu (5–45 min), with the time left in the menu bar.
  • Storage: free space, a low-disk warning, and which caches and Xcode folders are big. Read-only.
  • Startup items: programs that start at login, with an alert when a new one appears.
  • Agent time limit, charge limit shortcut, session names for Claude Code and Codex, Stay active for chat apps (opt-in), While you were away summary, Privacy by app, Screen Sharing alert, Activity log.
  • A simpler UI: Laptop open and Laptop closed, sub-tabs, and a menu you can customize.

Uses about 40 MB of memory and well under 1% CPU.

Keepwatch 0.2.0

Choose a tag to compare

@JKL404 JKL404 released this 15 Oct 15:01
v0.2.0
88c6f65

A big update: a redesigned app, an Agents tab, an Apps tab, any keep-awake length, privacy switches and security checks, and more commands for your agents.

Download

Keepwatch-0.2.0.dmg (or the .zip): universal (Apple Silicon and Intel), macOS 14 or later, signed with a Developer ID and notarized by Apple. Open the DMG and drag Keepwatch to Applications.

Check your download: shasum -a 256 -c SHA256SUMS.txt --ignore-missing

New

  • New look: a status ring with time left, teal switches, a summary you choose (battery, health, agents, mic, camera, CPU, memory, temperature and more, six to a row), and tabs.
  • Any length: 1 h, 3 h, 8 h, 1 day, forever, or any minutes, hours, days or weeks (up to 30 days), or until a date and time.
  • Agents tab: every Claude Code, Codex, Gemini CLI… session, grouped by assistant, with its folder, start time, working or idle, and Stop. A notification when an agent goes quiet (done, or waiting for you).
  • Apps tab: your apps by memory use, with Quit (like ⌘Q); listening ports with Stop.
  • Privacy: a mic switch, camera status, alerts when either turns on (with a button to open the Camera list), Reset camera access, and a history kept on your Mac.
  • Security checks: firewall, FileVault, Gatekeeper, System Integrity Protection, AirDrop (read-only).
  • Power: stay awake while plugged in or with an external display; stop when unplugged or at 15%; lid sessions can now start on battery above 20% (and still stop at 20%); battery health over time.
  • Shortcuts: ⌃⌥⌘K turns keep-awake on or off; ⌃⌥⌘S opens Apple's screenshot toolbar (area, window, screen, video, Markup).
  • CLI: awake --for 3d, awake --until 18:30, agents, agents stop PID, privacy, security, apps, and lid start --hours N (you still type your password at the Mac).
  • Install the skill as a plugin: /plugin install keepwatch@agentskilldeck (once the marketplace update lands), or npx skills add AgentSkillDeck/keepwatch.

Uses about 15 MB of memory and well under 1% CPU.