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.

All of Notchly’s features are accessible via keyboard. Because the panel is a floating, non-activating window anchored to the MacBook notch, a handful of shortcuts work system-wide — even when another app is in the foreground. This page lists every shortcut organized by category.
The backtick (`) hotkey is global — it fires even when Notchly is not the active application, letting you summon or dismiss the panel without switching focus. All other shortcuts listed here are local to the Notchly panel and only fire when the panel is focused.

Panel control

ShortcutAction
` (backtick)Toggle panel open / close
The backtick hotkey is registered as a global NSEvent monitor on key code 50, with no modifier flags required. It works from any application and in any input context, as long as another app hasn’t already claimed the same combination.

Tabs

ShortcutAction
Cmd TOpen a new terminal tab
Cmd WClose the active tab (shows a confirmation dialog if the tab is busy or waiting for input; idle tabs close immediately)
Cmd 1Cmd 9Jump directly to the nth tab
Cmd Shift Move the active tab one position to the left
Cmd Shift Move the active tab one position to the right

Split panes

Each tab can be split into a binary tree of terminal panes. Splits are created relative to the currently focused pane.
ShortcutAction
Cmd DSplit the focused pane vertically (new pane opens to the right)
Cmd Shift DSplit the focused pane horizontally (new pane opens below)
Cmd ]Move focus to the next pane
Cmd [Move focus to the previous pane
Cmd Shift WClose the focused pane
Closing a focused pane with Cmd Shift W is immediate and does not prompt for confirmation, regardless of whether the pane is busy. Use Cmd W (close tab) if you want the busy-tab confirmation guard.

Git & sessions

ShortcutAction
Cmd SSave a git checkpoint for the active session’s project
Git checkpoints are stored as custom git refs under refs/Notchy-snapshots/<project>/<timestamp> and do not disturb your working tree or staging area. You can save multiple checkpoints and restore any of them from the tab context menu.

Terminal tools

ShortcutAction
Cmd FOpen the terminal search bar to search output in the active pane
Cmd POpen the command palette with per-directory command history and fuzzy search

Font size

Font size adjustments apply immediately to all open terminal panes.
ShortcutAction
Cmd =Increase font size
Cmd -Decrease font size
Cmd 0Reset font size to the app default

Build docs developers (and LLMs) love