DOCSEARCHbyAlgolia
Submit Docs

Vibe Notch Documentation

repository·main·Indexed 25 days ago

https://github.com/farouqaldori/vibe-notch

A macOS menu bar application providing a Dynamic Island-style UI for Claude Code CLI sessions. It enables live session monitoring, chat history viewing with markdown rendering, and the ability to approve or deny tool executions directly from the macOS notch via hooks installed in ~/.claude/hooks/.

Tokens
338
Snippets
1
Records
3
Agent score
32%

What's inside Vibe Notch

  1. Vibe Notch Features Overview

    main

    Vibe Notch provides a Dynamic Island-style interface for Claude Code sessions on macOS. Features include:

    • Notch UI: An animated overlay that expands from the MacBook notch.
    • Live Session Monitoring: Real-time tracking of multiple Claude Code sessions.
    • Permission Approvals: Direct approve/deny controls for tool executions within the notch.
    • Chat History: Full conversation history viewing with markdown rendering support.

  2. How Vibe Notch works with Claude Code

    main

    Vibe Notch integrates with Claude Code by installing hooks into ~/.claude/hooks/. These hooks communicate session state to the app via a Unix socket.

    Key behaviors:

    • Live Monitoring: The app listens for events and displays them in a notch overlay.
    • Permission Approvals: When Claude Code requests permission to execute a tool, the notch expands to show approve and deny buttons, allowing you to manage tool execution without switching focus back to the terminal.
    • Auto-Setup: Hooks are installed automatically upon the first launch of the application.