Skip to content

Releases

Agent Notch Nightly (2026-11-18)

Pre-release

Choose a tag to compare

@github-actions github-actions released this 09 Sep 06:58
377c01b

Automated nightly build for commit 377c01b built on 2026-11-18.

Warning

This nightly build is ad-hoc signed and has not been notarized by Apple. macOS Gatekeeper may block or warn about it. Verify the published SHA-256 checksum before opening the app.

Download Agent-Notch-Nightly-macOS-arm64.zip and its matching .sha256 file into the same folder. Run shasum -a 256 -c Agent-Notch-Nightly-macOS-arm64.zip.sha256 there and continue only if it reports OK. Unzip and move Agent Notch.app to Applications.

If blocked, try opening the app once, then use System Settings → Privacy & Security → Open Anyway and confirm the prompt. See Apple's instructions.

Updates are manual: download and verify the new ZIP, quit Agent Notch from Settings → General, replace the app in Applications, and reopen it. History and preferences stay in place.

Try the beta tester guide and include this build's date and commit in feedback.

Agent Notch 0.2.1 (Unsigned Preview)

Pre-release

Choose a tag to compare

@github-actions github-actions released this 03 Sep 01:21

Warning

This preview is ad-hoc signed and has not been notarized by Apple. macOS Gatekeeper may block or warn about it. Verify the published SHA-256 checksum before opening the app.

What's Changed

  • Harden reliability, close UX traps, cover the hook boundary with tests by @Aforno in #11
  • fix(desktop): hide Codex commit-message helper sessions by @Aforno in #12
  • Prepare v0.2.1 release by @Aforno in #13
  • fix(desktop): make notch hover, states, and shortcuts readable by @Aforno in #14
  • fix(desktop): show git worktrees as the main repository by @Aforno in #16
  • feat(desktop): download and install updates from GitHub Releases by @Aforno in #17
  • fix(desktop): keep notch panel frame under AppKit control by @Aforno in #18
  • feat(desktop): refine setup, Activity Center, and relaunch handoff by @Aforno in #19
  • fix(tests): stop persistence cleanup from throwing on unlinked sockets by @Aforno in #21
  • feat(desktop): add physical notch preference and modernize runtime architecture by @Aforno in #23

Full Changelog: v0.2.0...v0.2.1

Agent Notch 0.2.0 (Unsigned Preview)

Pre-release

Choose a tag to compare

@github-actions github-actions released this 22 Aug 07:52

Warning

This preview is ad-hoc signed and has not been notarized by Apple. macOS Gatekeeper may block or warn about it. Verify the published SHA-256 checksum before opening the app.

What's Changed

  • fix(claude): align observers with documented hook schema by @Aforno in #3
  • chore: rename Codex fossils and document allowed disk walks by @Aforno in #4
  • chore: finish remaining code-quality inventory work by @Aforno in #5
  • fix(hooks): keep provider observers passive and install-safe by @Aforno in #6
  • Fix Swift 6.0 CI compile error in detail height reporting by @Aforno in #7
  • Add Homebrew cask for GitHub releases by @Aforno in #8
  • feat(desktop): answer waiting prompts from the notch by @Aforno in #9
  • feat(desktop): open sessions in their originating app or terminal by @Aforno in #10

Full Changelog: v0.1.1...v0.2.0

Agents Notch 0.1.1 (Unsigned Preview)

Pre-release

Choose a tag to compare

@github-actions github-actions released this 13 Aug 13:36
1dac787

Warning

This preview is ad-hoc signed and has not been notarized by Apple. macOS Gatekeeper may block or warn about it. Verify the published SHA-256 checksum before opening the app.

What's Changed

New Contributors

  • @Aforno made their first contribution in #2

Full Changelog: v0.1.0...v0.1.1

Agents Notch 0.1.0 (Unsigned Preview)

Pre-release

Choose a tag to compare

@github-actions github-actions released this 11 Aug 13:49

Warning

This preview is ad-hoc signed and has not been notarized by Apple. macOS Gatekeeper may block or warn about it. Verify the published SHA-256 checksum before opening the app.

Agents Notch is a native macOS status surface for autonomous coding agents. It attaches to the MacBook notch, keeps routine activity compact, and expands when an agent needs attention.

Highlights

  • Native notch-attached agent status, attention queue, and hover expansion.
  • Activity Center with searchable local session history, plans, workflows, relationships, files, and events.
  • Observer-only integrations for Codex, Claude Code, Grok, Gemini CLI, OpenCode, and Cursor.
  • Optional macOS notifications, source-app handoff, configurable history retention, virtual-notch support, and pointer-display following.
  • Provider-neutral local event protocol over a private Unix socket.
  • Local-first operation with no analytics, source upload, or remote telemetry. Update checks use GitHub Releases only when enabled.

Requirements

  • Apple Silicon Mac
  • macOS 14 or later

Download and verify

Download both release assets into the same directory, then run:

shasum -a 256 -c Agents-Notch-0.1.0-macOS-arm64.zip.sha256

Unzip the archive and move Agents Notch.app to /Applications. Because this preview is not notarized, Control-click the app, choose Open, and review the macOS prompt if Gatekeeper warns.

Full changelog: https://github.com/Aforno/AgentNotch/blob/v0.1.0/CHANGELOG.md