How to vibe codeGojo

Prerequisites

• 

  macOS ComputerOwned hardware

  Required to compile, test, and run native AppKit and SwiftUI code targeting MacBook notches

• XcodeFree

  Official IDE for Swift and macOS desktop app development

• GitHubFree

  Source control repository for managing the Swift project codebase

AI coding tools

• Claude Code

  Best-in-class agentic coding tool for scaffolding multi-file Swift/AppKit projects and writing complex macOS API integrations directly from your terminal.

• 

  Cursor

  AI-native editor ideal for fine-tuning SwiftUI layout animations, adjusting NSPanel levels, and reviewing code diffs step-by-step.

Build guide

1. 01Project Initialization & Menu Bar Daemon

   Initialize a new macOS App project in Xcode configured as a menu bar utility app (LSUIElement set to true in Info.plist to hide the dock icon).

   Create a new Swift Package or Xcode project structure for a native macOS utility app named GojoClone. Configure the target to run strictly as a background menu bar item by ensuring `LSUIElement` is true in the Info.plist. Implement a robust `NSStatusItem` status bar controller that responds to left and right clicks, presenting a base menu structure. Set up clean MVVM architecture using Swift concurrency (async/await) and structure the project directories for Views, ViewModels, Models, and Services.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

2. 02Notch Geometry & Floating Overlay Panel

   Build a custom NSPanel window subclass that detects the active MacBook display metrics, identifies physical camera notch dimensions, and anchors an interactive hover overlay seamlessly.

   Implement a custom `NSPanel` subclass in Swift called `NotchOverlayPanel`. This panel must be borderless, non-activating (`isFloatingPanel = true`, `.canBecomeKey = false`), and transparent by default. Write a service utility that queries `NSScreen.screens` and detects built-in camera housing safe areas / notch geometry across different MacBook models (Air/Pro, 14" and 16"). Implement mouse hover tracking (`NSScreen` mouse location listeners or global event monitors) that smoothly animates the panel expanding downward from the camera notch when the cursor dwells near the top edge, and retracts when the cursor leaves.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

3. 03Media Player & Active Source Integration

   Integrate with macOS media control APIs via MediaPlayer framework to surface track details, album art, scrubbing, and playback commands.

   Create a `MediaService` class using the Swift `MediaPlayer` framework (`MPNowPlayingInfoCenter` and `MPRemoteCommandCenter`) to inspect currently active media sources on macOS (Apple Music, Spotify, web browsers). Expose published properties for track title, artist, album artwork image, playback state (playing/paused), and current playback position. Implement playback control methods for play, pause, skip forward, skip backward, and scrubbing that dispatch remote commands to the active media player.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

4. 04Clipboard History & Sensitive Data Filtering

   Monitor system pasteboard changes, store snippets in a local GRDB SQLite database, and provide quick search while ignoring password manager formats.

   Build a `ClipboardService` that polls `NSPasteboard.general` or listens to change counts using a background timer. Automatically capture copied text strings, checking pasteboard data types to ignore sensitive entries from password managers (such as 1Password or Bitwarden type identifiers like `org.nspasteboard.ConcealedType` or `org.nspasteboard.AutoGeneratedType`). Store captured snippets in a local SQLite database using GRDB.swift with automatic pruning of entries older than 7 days. Expose a searchable list view model for the notch overlay.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

5. 05Window Switcher, Grid Snapping & File Shelf

   Implement Accessibility API hooks to list open windows, bring windows into focus, execute window snapping grids, and provide a temporary file staging tray.

   Implement a `WindowManagementService` utilizing macOS Accessibility APIs (`AXUIElementCreateSystemWide`, `kAXWindowAttribute`) to enumerate open windows across running applications, capturing window titles, owner application icons, and active bounds. Provide functions to focus a selected window and snap windows to halves, quadrants, or custom screen grids. Additionally, build a drag-and-drop `FileShelf` view inside the notch overlay that accepts file URL drops, storing temporary file references in memory so users can stage files while moving between folders and desktops.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

6. 06Display Comfort & Local Speech-to-Text Dictation

   Integrate display warmth/Night Shift controls and package Whisper.cpp locally for offline private speech-to-text dictation.

   Implement a `DisplayService` to control screen brightness and color temperature adjustments via CoreDisplay private APIs or standard screen utility bindings. Next, integrate an offline speech-to-text capability by embedding a lightweight Whisper.cpp wrapper or utilizing Apple's native `SFSpeechRecognizer` framework configured for on-device recognition (`requiresOnDeviceRecognition = true`). Build a dictation toggle button in the notch overlay that records microphone input, transcribes speech locally without hitting external servers, and pastes the resulting text directly into the frontmost application using CGEvent key simulation.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

7. 07Polish, Performance Profiling & Launch Optimization

   Refine animations, optimize CPU/battery footprint during idle states, and package the application for local release.

   Perform a comprehensive performance review of the GojoClone codebase. Profile CPU and memory usage in Xcode Instruments to ensure idle CPU usage remains under 0.5% and memory footprint stays compact. Smooth out all SwiftUI and AppKit transition animations for the notch hover reveal/hide sequence. Add configuration settings for user customization (toggling individual modules like calendar, battery status, and shortcuts, rearranging media controls, and tuning accent colors).

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

Cost vs paying for Gojo