notchTerm

A macOS notch companion for Claude CLI and Codex CLI.

Requirements

macOS with a notched display (or any Mac, the overlay floats top-center)
Xcode command line tools with Swift 5.9+
Terminal.app running your claude or codex sessions

Install

Clone the repository:

git clone https://github.com/Aryavora621/notchTerm.git
cd notchTerm

Build the app:
```
swift build
```
Run it:
```
swift run notchTerm
```

Grant permissions

notchTerm drives Terminal.app via AppleScript, so on first run macOS will prompt for Automation access:

System Settings → Privacy & Security → Automation → notchTerm → Terminal

The Esc / E-stop button also relies on System Events, which needs Accessibility access under the same Privacy & Security pane. Without these grants the panes show "Offline" and sends are disabled, but the UI still runs.

Using it

Start a claude or codex session in a Terminal.app tab. Hover near the notch to expand the overlay — it shows a live preview of each matching session, lets you send messages directly into the tab, and includes an Escape / E-stop button to interrupt a running session.