English · 中文 · 日本語 · 한국어

VibeBar is a lightweight macOS menu bar app that monitors live TUI session activity for Claude Code, Codex, OpenCode, Aider, Gemini CLI, and GitHub Copilot.

Multiple icon styles and color schemes are provided, which can be configured in the settings.

• Claude Code: use the VibeBar plugin (recommended).
• OpenCode: use the VibeBar plugin (recommended).
• Aider: use vibebar wrapper (recommended), and optionally vibebar notify for better awaiting-input signals.
• Gemini CLI: use vibebar wrapper (recommended). In headless/prompt mode, wrapper auto-enables --output-format stream-json unless already set.
• GitHub Copilot: use the VibeBar hooks plugin (recommended). Install from Settings → Plugins → GitHub Copilot; VibeBar auto-deploys .github/hooks/hooks.json to all running Copilot sessions' project directories. For projects opened after installation, click Install again or copy the hooks file manually.
• Codex: use vibebar wrapper (recommended), because Codex currently has no plugin system in this repo.
• vibebar wrapper supports claude / codex / opencode / aider / gemini / copilot, while plugin integration remains the preferred path where available.

• Real-time menu bar status for multiple sessions and tools.
• Session states: running, awaiting_input, idle, stopped, unknown.
• Three data channels for reliability:
  • PTY wrapper (vibebar)
  • Local plugin events via vibebar-agent
  • ps process scanning fallback
• In-app plugin management (install/uninstall/update) for Claude Code, OpenCode, and GitHub Copilot.
• In-app wrapper command management for vibebar.
• Multiple icon styles, color themes, launch at login, and update checks.
• Multi-language UI (English, 中文, 日本語, 한국어).

• VibeBarCore: models, storage, aggregation, scanners, plugin/wrapper detection.
• VibeBarApp: macOS menu bar app and settings UI.
• VibeBarCLI (vibebar): PTY wrapper around target CLIs.
• VibeBarAgent (vibebar-agent): local Unix socket server for plugin events.
• plugins/*: Claude Code, OpenCode, and GitHub Copilot hook plugin packages.

VibeBar merges data from 3 channels:

1. vibebar PTY wrapper: high-fidelity interaction states.
2. vibebar-agent socket events: plugin lifecycle/status updates.
3. ps scan fallback: process-based discovery when stronger sources are missing.

State priority at tool level:

running > awaiting_input > idle > stopped > unknown

Runtime data paths:

• Session files: ~/Library/Application Support/VibeBar/sessions/*.json
• Agent socket: ~/Library/Application Support/VibeBar/runtime/agent.sock

1. Download latest VibeBar-*-universal.dmg from GitHub Releases.
2. Drag VibeBar.app to Applications.
3. First launch: right-click app and choose Open (Gatekeeper).

Add this repository as a tap and install:

brew tap yelog/vibebar https://github.com/yelog/vibebar.git
brew install --cask yelog/vibebar/vibebar

Or install in one line:

brew install --cask yelog/vibebar/vibebar --tap=yelog/vibebar

Upgrade:

brew upgrade --cask yelog/vibebar/vibebar

Requirements: macOS 13+, Xcode Command Line Tools, Swift 6.2.

swift build

1. Start app:

swift run VibeBarApp

2. Start agent (recommended for plugin events):

swift run vibebar-agent --verbose

3. Install local plugins for Claude/OpenCode:

bash scripts/install/setup-local-plugins.sh

4. Install the GitHub Copilot hooks plugin (if using Copilot):

Open VibeBar Settings → Plugins → GitHub Copilot → Install. VibeBar will copy the hook script and auto-deploy hooks.json to all currently running Copilot sessions' project directories.

5. Run Codex with wrapper (recommended path):

swift run vibebar codex -- --model gpt-5-codex

6. Run Aider with wrapper (recommended path):

swift run vibebar aider -- --model sonnet

7. Optional: forward Aider notifications into VibeBar state updates:

aider --notifications --notifications-command "vibebar notify aider awaiting_input"

8. Run Gemini CLI with wrapper:

swift run vibebar gemini -p "explain this codebase"

For Gemini prompt/headless invocations (-p, --prompt, --stdin, or non-TTY stdin), vibebar automatically adds --output-format stream-json unless you already provide --output-format.

Gemini hooks integration example (.gemini/settings.json):

{
  "hooks": {
    "SessionStart": [{
      "matcher": "*",
      "hooks": [{ "type": "command", "command": "vibebar notify gemini session_start session_id=$GEMINI_SESSION_ID" }]
    }],
    "AfterAgent": [{
      "matcher": "*",
      "hooks": [{ "type": "command", "command": "vibebar notify gemini after_agent session_id=$GEMINI_SESSION_ID" }]
    }],
    "SessionEnd": [{
      "matcher": "*",
      "hooks": [{ "type": "command", "command": "vibebar notify gemini session_end session_id=$GEMINI_SESSION_ID" }]
    }]
  }
}

9. Optional fallback: run Claude/OpenCode via wrapper when plugin is unavailable:

swift run vibebar claude
swift run vibebar opencode

Plugin docs:

• plugins/README.md
• plugins/claude-vibebar-plugin/README.md
• plugins/opencode-vibebar-plugin/README.md
• plugins/copilot-vibebar-hooks/README.md

# Build
swift build
swift build -c release

# Run
swift run VibeBarApp
swift run vibebar-agent --verbose
swift run vibebar codex

# Test (placeholder)
swift test

Package universal .dmg:

bash scripts/build/package-app.sh

• No menu bar icon: ensure local macOS GUI session (not headless/SSH).
• Stale sessions: use Purge Stale and verify session files path above.
• Missing plugin events: ensure vibebar-agent is running and check socket path:

swift run vibebar-agent --print-socket-path

• Without plugins, awaiting-input detection relies on heuristics.
• Codex has no plugin event channel in this repo yet.
• Aider has no native plugin event channel in this repo yet; use vibebar notify via --notifications-command for better awaiting-input detection.
• Gemini CLI transcript parsing is auxiliary only; it augments hook/process detection and should not be treated as a primary real-time source.
• GitHub Copilot hooks are per-repo: hooks.json must exist in each project's .github/hooks/ directory. VibeBar auto-deploys this file when you click Install, but projects opened after installation require a second Install click (or manual copy).
• Automated tests are still minimal.