
clangnotch
Claude Code and Codex at Mac Notch. | Claude Code와 Codex를 맥 노치에서.
Install with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
Install and set up clangnotch (release-binary project) into my current project. Found on https://claudeers.com/clangnotch Repo: https://github.com/Clang-error/clangnotch Homepage/docs: — Detected install method: release-binary → inspect the README Category: other. Platforms: cli, api, desktop. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: unknown; community-verified: false. Confirm the source before running anything.
Grab the latest release asset from GitHub.
# download a build from https://github.com/Clang-error/clangnotch/releases
git clone https://github.com/Clang-error/clangnotch
// compatibility
| Platforms | cli, api, desktop |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | MIT |
| Pricing | open-source |
| Language | Swift |
ClangNotch
English · 한국어
Watch Claude Code and Codex work, right in your Mac's notch.
ClangNotch sits in the notch and shows what your coding agents are doing: which tool is running, whether a reply has finished, and whether one is waiting on you. It reads the session files Claude Code and Codex already write, so there's nothing to set up.
Install
Download ClangNotch.dmg from Releases and drag it into your Applications folder.
The app is notarized by Apple, so it opens without a warning. From then on it downloads new versions itself and installs one when you click Restart to Update (Settings -> About). Settings -> About also offers the newest beta (Get Beta), and a copy that is a beta gets newer betas the same way.
Requires macOS 14.2 or later. On a Mac without a notch, it appears in the same shape at the top of the screen.
Features
Agents
- Live status for Claude Code (CLI, desktop app, VS Code) and Codex (CLI, desktop app), read from
~/.claude/projectsand~/.codex/sessions - The closed notch shows the tool that's running, then Done with a checkmark when a turn ends
- When a turn ends, the first line of the reply and how long it took drop down, with Open terminal / Open app to jump to the terminal tab or app the session runs in
- Answer permission requests and
AskUserQuestionquestions from the notch. Codex questions show in the notch and are answered in Codex - A session waiting on you is announced again every 3, 5 or 10 minutes. The done and waiting sounds stay quiet while the screen is locked
- Sessions grouped by folder. Click one for its session view with each step and the file changes, and jump from there to its terminal or app
- Quiet sessions stay listed for a time you set (five minutes by default). Pin a session from its right-click menu and it stays
- Subagents Claude starts show under their session. Codex sessions go by their thread names from the Codex app
- A context bar at the top of the session view, with a note when the session is about to compact
- 5-hour and weekly usage for Claude and Codex
- Claude Code sessions running on an SSH host: hooks over a reverse tunnel on Linux and macOS, the transcripts read on Windows
- Codex sessions running on an SSH host: Linux, macOS or Windows (reads the host's session logs, installs nothing there)
Tools
Each one is a tab in the open notch, and each can be turned off in Settings.
- Clipboard history: text, images and files (a file is kept by its location, images until the app quits). Items you reuse can be pinned. A copy in another app drops a small "Copied" out of the notch
- Per-app volume
- iPad Sidecar controls
- Quick access to multi-display arrangement
- Battery for your Mac, Bluetooth devices (third-party headsets and keyboards too), iPhone and iPad. Right-click a device to show it in the header or rank it for the closed notch
- A ranked device below 20% (and not charging) shows in the closed notch's wings: the device on the left, its battery on the right. Each one can be turned off
- Speed test (Cloudflare's servers) and network info
- Tethering: while the Mac is on your iPhone's Personal Hotspot at a saved place (home, office), the notch suggests switching to Wi-Fi. Any carrier
- SKT (Korea) subscribers only, off by default: how much of the data your plan lets you share (통합공유 데이터) is left, read from your T world account and shown while you tether
- Keyboard lock and key test
In the open notch, ⌘1–⌘7 switch tabs.
Once enabled, the volume and brightness keys show ClangNotch's own slider instead of the system one.
- The volume keys also turn down outputs macOS can't, such as HDMI and DisplayPort monitor speakers. Apps whose screen share would pick up the sound can be left out
- If MonitorControl, Lunar or BetterDisplay sets your external display's brightness, the brightness keys can be passed through to it
When music or a video plays, the closed notch shows its artwork on the left and bars that move with the sound on the right. A player dropdown comes down when a track starts, with a scrubber, previous, play and next, and the output picker. Pin it and it stays, wherever you drag it.
Connect AirPods or a Bluetooth headset and a dropdown comes down from the notch with its battery. AirPods show the moment the case opens, and it folds when the lid shuts. With one bud out of the case each bud gets its own battery, and with one bud in, only the bud you're wearing shows. AirPods Max show when you put them on and fold when you take them off.
When your Mac runs low, the same dropdown comes down at 20% and again at 10%, drawn as your Mac's model.
Notch and settings
- The closed notch's wings step aside when you point at one: it fades into the menu bar and the click goes to the menu bar under it. A small tab under the notch says where to point to open it
- Pick the display the notch shows on: the main display or another connected one
- Notch colour: follow the wallpaper, auto, light or dark, a colour taken from a wallpaper photo, or an eyedropper
- Reorder or hide tabs
- How long to wait before opening, haptics on open and on finish, show over full-screen apps
- Battery saver mode with less glow on battery
- Menu bar icon (session count, keyboard lock, settings)
- Settings search, and Check Now in Settings -> About
- Light: about 2% of one CPU core while an agent works, under 1% when nothing runs (measured on an M5 Pro)
The app's interface follows your system language: Korean on a Korean system, English on any other. To pick one yourself, use Settings -> General -> Display language.
Permissions
| Permission | Used for |
|---|---|
| Accessibility | Volume and brightness keys, keyboard lock, moving the system overlay |
| Notifications | Low battery alerts |
| Location | Reading the Wi-Fi name (macOS won't share it without location access) |
| Audio capture | Per-app volume |
| Automation (Terminal) | Going to a session's tab, only if the session runs in Terminal |
Approving from the notch adds hooks to ~/.claude/settings.json and ~/.codex/hooks.json, and backs up the original files first. Codex only runs a new hook after you trust it once in /hooks.
iPhone and iPad battery needs libimobiledevice. The install button in the Battery tab runs brew install libimobiledevice in Terminal.
Build
git clone https://github.com/Clang-error/clangnotch.git
cd clangnotch
xcodebuild -project ClangNotch.xcodeproj -scheme ClangNotch -configuration Release build
Before building, set the project's Signing team to your own.
License
// faq
What is clangnotch?
Claude Code and Codex at Mac Notch. | Claude Code와 Codex를 맥 노치에서.. It is open-source on GitHub.
Is clangnotch free to use?
clangnotch is open-source under the MIT license, so it is free to use.
What category does clangnotch belong to?
clangnotch is listed under other in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/clangnotch)
// retro hit counter
[](https://claudeers.com/clangnotch)
// reviews
// guestbook
// related in Other
Anti-AI-slop design skill for Claude Code, Cursor, and Codex.
Huashu Design · HTML-native design skill for Claude Code · Claude Code 里 HTML 原生的设计 skill · 高保真原型 / 幻灯片 / 动画 + 20 设计哲学 + 5 维评审 + MP4 导出 · Agent-agnostic
Open source Ghostty-based macOS terminal with vertical tabs and notifications for AI coding agents. Built for multitasking, organization, and programmability.