Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/javierpr0/Notchly/llms.txt

Use this file to discover all available pages before exploring further.

Notchly can be installed in two ways: download the pre-built DMG from GitHub Releases, or build directly from source using Xcode. Both paths land the same app on your machine. The DMG route takes about two minutes; the source build requires Xcode with the macOS 26 SDK but gives you the latest unreleased changes. Either way, macOS 26.0 or later is required.
1

Download the DMG

Go to github.com/javierpr0/Notchly/releases and download Notchly.dmg from the latest release.
2

Drag Notchly to Applications

Open the downloaded DMG. In the Finder window that appears, drag Notchly.app into the Applications folder shortcut.
3

Try to open Notchly

Double-click Notchly.app in your Applications folder. macOS will show a dialog:
“Notchly” cannot be opened because the developer cannot be verified.
Click OK to dismiss the dialog — do not click Move to Trash.
4

Open Privacy & Security settings

Open System Settings and navigate to Privacy & Security.
5

Find the blocked-app message

Scroll down to the Security section. You will see a message similar to:
“Notchly” was blocked from use because it is not from an identified developer.
6

Allow Notchly to run

Click Open Anyway next to that message. macOS will ask you to confirm once more — click Open in the confirmation dialog.
7

Notchly is ready

Notchly launches and adds its icon to the menu bar. The Gatekeeper warning will not appear again for this copy of the app.
Notchly is not signed with an Apple Developer certificate. Releases are built ad-hoc (CODE_SIGN_IDENTITY="-") by GitHub Actions and are not notarized by Apple. The Gatekeeper warning you see on first launch is expected behavior — it is not a sign of malware. The source code and build workflow are fully public at github.com/javierpr0/Notchly if you want to verify what you’re running.

​
First launch

​
Full Disk Access

On first launch, Notchly checks whether it has Full Disk Access and prompts you to grant it if not. Full Disk Access is required so the app can spawn your login shell, read ~/.zsh_history for autocomplete, and write session history to ~/.notchly/. To grant access: open System Settings → Privacy & Security → Full Disk Access and enable the toggle next to Notchly. You can re-open this settings pane at any time from the Notchly settings panel (gear icon → Full Disk Access).

​
Menu bar icon

Once Notchly has the permissions it needs, its icon appears in the macOS menu bar. Click the icon to open a context menu where you can create sessions, manage checkpoints, and check for updates.

​
Opening the panel

Hover your cursor over the MacBook notch at the top of the display — the terminal panel slides down immediately. You can also click the menu bar icon, or press the backtick (`) key from any app to toggle the panel open and closed.

Build docs developers (and LLMs) love

Get started for freeTalk to us