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 is a macOS menu bar app that turns the MacBook notch into a persistent terminal hub. Hover over the notch to reveal a floating panel where you can run Claude Code, split panes side-by-side, snapshot your git state with a single keystroke, and spin up isolated worktrees for parallel sessions — all without switching apps.

Installation

Download the DMG or build from source. Get Notchly running on macOS in minutes.

Quickstart

Open your first Claude Code session in the notch and learn the essential shortcuts.

Core Features

Notch integration, multi-tab sessions, split panes, and git workflows explained.

Configuration

Customize Notchly per-project with .notchy.json, themes, and shortcuts.

What Notchly does

Notchly anchors a terminal panel to the MacBook notch area. When your cursor approaches the notch, the panel slides into view. When you move away, it hides — keeping your screen clear until you need it.
1

Download and install

Grab Notchly.dmg from Releases, drag to Applications, and approve it in System Settings → Privacy & Security.
2

Open the terminal panel

Hover over the MacBook notch, click the menu bar icon, or press the backtick key (`) from any app to toggle the panel.
3

Start a Claude Code session

Press Cmd+T for a new tab, cd into your project, and run claude. The notch pill animates to show when Claude is working, waiting, or done.
4

Snapshot before big changes

Press Cmd+S to save a git checkpoint before letting Claude modify your codebase. Restore it instantly from the menu if something goes wrong.

Key features

Notch Integration

Hover-to-reveal panel anchored to the built-in display notch with live status animation.

Sessions & Tabs

Multiple Claude Code sessions in tabs with sleep/wake, drag reorder, and keyboard navigation.

Split Panes

Horizontal and vertical splits with draggable dividers for side-by-side workflows.

Git Workflows

One-key checkpoints and isolated worktrees for safe, parallel Claude sessions.

Command Palette

Per-directory saved commands with fuzzy search, launched instantly with Cmd+P.

Terminal Themes

10 built-in themes — Dracula, Nord, Tokyo Night, and more — applied to all app chrome.

Build docs developers (and LLMs) love