notchling

KO | EN

gitlite — search

#codex #claude-code #self-hosted #macos #chatgpt #openai #nodejs #rag #ios #swift

(★ 9)

A native macOS notch widget that shows what every Claude Code and Codex session is doing — click a row to land in the terminal tab that owns it.

File Explorer

ZIP Download

- marketplace.json
- - bug_report.yml
  - config.yml
  - feature_request.yml
- - ci.yml
  - release.yml
- CODE_OF_CONDUCT.md
- CONTRIBUTING.md
- PULL_REQUEST_TEMPLATE.md
- SECURITY.md
- notchling.gif
- panel.gif
- settings.png
- Info.plist
- Notchling.icns
- - App.swift
- - main.swift
- - AgentSetupTests.swift
  - CodexRolloutTests.swift
  - DirectoryWatcherTests.swift
  - Fixtures.swift
  - HookBinaryTests.swift
  - InstalledBuildTests.swift
  - LaunchAgentTests.swift
  - LiveCheck.swift
  - LogCollectionTests.swift
  - MascotArtTests.swift
  - PanelPreferenceTests.swift
  - ProcessEnvironmentTests.swift
  - ProviderTests.swift
  - SessionMetricsTests.swift
  - SessionStoreTests.swift
  - SessionTests.swift
  - SpoolAndCuesTests.swift
  - StatusLineChainTests.swift
  - StatusLineScriptTests.swift
  - ThemeTests.swift
  - TranscriptReaderTests.swift
  - UpdatesTests.swift
  - UsageTests.swift
  - WidgetMetricsTests.swift
  - WidgetPresentationTests.swift
  - WidgetShapeTests.swift
.gitignore
install-hooks.sh
LICENSE
list-sessions.sh
make-icon.py
Makefile
NOTICE.md
Package.swift
README.md
release-notes.sh
SETUP.md
statusline-usage.sh
verify-dist.sh

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

**Keep an eye on every Claude Code and Codex session, right from your Mac’s notch.**

See what’s working, what’s finished, and what needs you — then click a session to jump back to it.

The panel opens when a session needs attention, then tucks itself away.

## Stay on top of your sessions

- **Know when you’re needed.** See permission prompts, failed turns, and finished work, with brief
  alerts and distinct sounds.
- **Jump back with a click.** Go straight to the session’s tab or pane in Warp, iTerm2, and Terminal.app.
  Other supported terminals bring the app forward.
- **Follow parallel work.** See every session in one place whichever CLI it belongs to, most urgent
  first, with subagent progress beneath each one and session names and colours you recognise.
- **Keep usage in view.** Optional per-agent plan usage and a per-session context meter show how much
  room you have left, for each CLI separately — two plans do not add up to one number.
- **Stay focused.** The widget never takes keyboard focus, and works across displays — including
  Macs and monitors without a notch.

## Get started

You’ll need **macOS 14 Sonoma or later**, **Homebrew**, and **Claude Code**, **Codex**, or both.

```sh
brew install CircleHP/notchling/notchling
notchling-hooks setup
```

Setup asks before configuring each CLI it finds, offers optional usage meters, and can start the widget
now and at login. Restart any sessions that were already running so they pick up the hooks — and for
Codex, run `/hooks` in a session to review them, because Codex will not run a hook it has not been
asked about. No Xcode or compilation needed.

Codex rows show less than Claude Code rows do, and the [setup guide](SETUP.md#codex) says exactly what
and why.

Hover over the notch to see your sessions, click a row to return to work, and open the gear for settings.

Everything can be wired, unwired and switched from here — one section per agent it finds.

See the [setup guide](SETUP.md) for other installation options, configuration, and troubleshooting.

## Your sessions stay on your Mac

Notchling reads session information locally, including session titles, colours, context and plan
limits. It reads a handful of named records and nothing else — a Codex session's own file holds the
conversation too, and the lines carrying it are discarded on their size before anything parses them. No
telemetry, and no session data is sent anywhere. Update checks run only if you enable them or click **Check Now**;
installing an update is a separate choice. [Privacy details](NOTICE.md).

## Help and more

- [Terminal compatibility](SETUP.md#terminal-compatibility) — supported terminals and limits on jumping to a session.
- [Upgrading](SETUP.md#upgrading) · [Troubleshooting](SETUP.md#troubleshooting) · [Uninstalling](SETUP.md#uninstall)
- [Report a bug or request a feature](https://github.com/CircleHP/notchling/issues)
- [Build from source](SETUP.md#from-source) · [Contribute](.github/CONTRIBUTING.md)

MIT licensed, including the mascot — see [LICENSE](LICENSE).
Notchling is unofficial and not affiliated with Anthropic or OpenAI.

notchling

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README