Aforno

AgentNotch — Development skill for Claude Code

Development community

Native macOS notch status surface for autonomous coding agents.

How to install AgentNotch

This entry records only its repository, not the path inside it, so there is no exact command to give. Open Aforno/AgentNotch and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What AgentNotch does

Native macOS notch status surface for autonomous coding agents.

Alternatives in Development

Claude Code Zh Cn — Claude Code CLI 简体中文本地化 / 汉化插件；支持 macOS、Linux、WSL、Windows 与新版 native，一行安装，更新后自动修复 721 ★
Herdrm — Native macOS console for herdr — all your coding agents and their live terminals, across devices 635 ★
Clarc — Native macOS client for Claude Code — a GUI desktop app built with SwiftUI 363 ★

README

Agent Notch

Agent Notch sits on the MacBook notch and shows what your local coding agents are doing. Tool calls, file edits, and completions stay collapsed. Hover to expand, or it opens itself when an agent needs a permission or an answer. No Dock icon. No menu-bar extra.

Pre-1.0 public beta. The local protocol is versioned. The UI and provider hook mappings can still change before 1.0.

It talks to Codex, Claude Code, Grok, Gemini CLI, Antigravity, OpenCode, and Cursor. Every integration sends the same `AgentEvent` values to a local socket.

Install

Requirements: Apple Silicon Mac and macOS 14 or later.

Homebrew

This repository is a Homebrew tap. Install the current GitHub release with:

brew tap Aforno/agentnotch https://github.com/Aforno/AgentNotch
brew install --cask aforno/agentnotch/agent-notch

Homebrew 6 does not trust a third-party tap when you add it. The fully qualified name trusts only this cask.

Later cask bumps land on `main`. Packaged builds also update themselves: Settings → General → Check for Updates, then Download, then Restart to Update. Homebrew knows the app self-updates (`auto_updates true`). `brew upgrade --cask` is still available if you prefer it.

Manual

When a release is up, download the ZIP and the matching `.sha256` file from the [GitHub releases page](../../releases). Verify it before you open the app:

shasum -a 256 -c Agent-Notch-*-macOS-arm64.zip.sha256

Unzip the archive, move `Agent Notch.app` to `/Applications`, and open it. Production releases are Developer ID signed and notarized. Unsigned previews are marked as prereleases and may trip Gatekeeper. Control-click the app, choose Open, and read the prompt.

Develop from source

Source builds need Swift 6.

./script/build_and_run.sh --verify

That builds both executables in debug, stages an ad-hoc signed `dist/Agent Notch.app`, embeds the hook relay, launches the bundle, and checks that the process and the private event socket s