whatisgithub

What is notchy?

bones7456/notchy — explained in plain English

Analysis updated 2026-05-18

3SwiftAudience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

A macOS menu bar app that puts Claude Code or Codex into your MacBook's notch, launching an AI coding session for whichever Xcode project you have open.

Mindmap

mindmap
  root((repo))
    What it does
      Notch terminal panel
      Auto Xcode detection
      Claude or Codex launch
    Tech stack
      Swift
      SwiftTerm
      Xcode
    Use cases
      AI coding sessions
      Git checkpoints
      Multi session tabs
    Audience
      Mac developers
      Xcode users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Launch Claude Code or Codex automatically when you open an Xcode project.

USE CASE 2

Run multiple AI coding sessions in tabs without leaving your MacBook's notch.

USE CASE 3

Save a Git checkpoint before letting an AI agent edit your code.

What is it built with?

SwiftXcodeSwiftTerm

How does it compare?

bones7456/notchydeerspotter/chatgpt-webviewaydahnizzy/calendar-drag-interaction
Stars334
LanguageSwiftSwiftSwift
Setup difficultyeasymoderateeasy
Complexity2/52/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires a MacBook with a notch for the notch features, the menu bar still works without one.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Notchy is a small macOS menu bar app that turns the notch on your MacBook screen into a shortcut for running AI coding assistants. Instead of switching to a terminal window, you hover over the notch or click a menu bar icon, and a floating terminal panel appears with a session already connected to your project. The app automatically looks at the Xcode projects you have open and figures out which folder to work in. If that project has a CLAUDE.md file, Notchy starts Claude Code for you. If it has an AGENTS.md file instead, it starts Codex. You can also open several sessions at once and switch between them as tabs, so you could have more than one project or more than one assistant running side by side. While an assistant is working, the notch itself shows a small animated status pill that tells you whether it is thinking, waiting for input, or finished, so you do not have to keep the terminal window in view to know what is happening. There is also a Git checkpoint shortcut, Cmd+S, that saves a snapshot of your project before the assistant makes any changes, giving you an easy point to go back to if something goes wrong. This project is a community-maintained continuation of an earlier app by Adam Lyttle, who is no longer updating the original. The current maintainer, bones7456, keeps it alive and adds small fixes on top of that original work. To use it you need a Mac running macOS 15.6 or later. The notch features need a MacBook that actually has a notch, though the regular menu bar functions still work without one. You can install it by downloading a signed and notarized build from the Releases page, either as a drag-and-drop installer or as a plain app file, or you can build it yourself from source in Xcode. It relies on a small terminal-emulator library called SwiftTerm to render the embedded sessions. The project is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me build a macOS menu bar app in Swift that shows a floating terminal panel like Notchy does.
Prompt 2
Show me how to detect open Xcode projects from a Swift app and cd into their folders automatically.
Prompt 3
Explain how SwiftTerm can be used to embed a terminal session inside a macOS app.
Prompt 4
Walk me through adding a Git checkpoint shortcut that snapshots a project before an AI agent edits it.

Frequently asked questions

What is notchy?

A macOS menu bar app that puts Claude Code or Codex into your MacBook's notch, launching an AI coding session for whichever Xcode project you have open.

What language is notchy written in?

Mainly Swift. The stack also includes Swift, Xcode, SwiftTerm.

What license does notchy use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is notchy to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is notchy for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.