MarazziMarco

NotchDeck — Development skill for Claude Code

Development community

A native macOS notch workspace for focus, files, media, and Claude Code or Codex sessions.

How to install NotchDeck

This entry records only its repository, not the path inside it, so there is no exact command to give. Open MarazziMarco/NotchDeck and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What NotchDeck does

A native macOS notch workspace for focus, files, media, and Claude Code or Codex sessions.

Alternatives in Development

Harness Remote — Native-session control plane for Codex, Claude Code, OpenCode, OMP and PI 356 ★
Quosparr — 🐦 Native menu bar & tray app for macOS, Windows and Linux: track Codex, Claude Code and Grok quotas, resets 288 ★
App It — A Claude Code + Codex skill that turns a local project into a macOS Dock-launchable app — native window, its o 218 ★

README

NotchDeck

**Turn your MacBook notch into a focused workspace for everyday tools and coding agents.**

Native macOS · Swift · SwiftUI · AppKit · macOS 14+

⚠️ Early-stage / in active development — not yet a stable 1.0 release.

NotchDeck turns the area around the notch into an interactive surface. It is compact and near-invisible at rest, matching the physical notch, and expands smoothly on hover, click, or file drag. On notch-less displays it centers a small pill at the top of the screen.

Two faces:

Utilities — Quick Note, Now Playing, File Shelf, Mirror, Pomodoro Focus, Downloads activity, and screenshots, as customizable Home modules.
Agents — monitor Claude Code and Codex sessions, handle real permission requests, and jump to the existing Terminal tab where a session runs.

No private APIs. No screen scraping for core features. Everything stays local.

Screenshots

Screenshots are not yet included. See [`docs/screenshots/`](docs/screenshots/README.md) for the exact filenames to add — they were intentionally not invented.

Home docs/screenshots/home.png	Focus docs/screenshots/focus.png
Files docs/screenshots/files.png	Agents docs/screenshots/agents.png

Features

Notch expansion + compact live activities — physical-idle, compact activity capsule, and expanded panel, with content shown only when relevant.
Quick Note — a sticky note on Home.
Now Playing — current track + transport controls (Music / Spotify).
File Shelf — drag files in to stage them (move-into-shelf or keep-reference), drag out to move/copy; crash-safe manifest.
Mirror — a liv