NeoHubR

A macOS menu bar app that gives Neovide proper project management. Forked from micsama/NeoHubR, itself a full rewrite of alex35mil/NeoHub.

---

Why

Neovide on macOS has two persistent annoyances:

• Every instance shows up as neovide in ⌘⇥ — no way to tell which window is which project.
• Re-opening an already-running project triggers swap file errors.

NeoHubR wraps Neovide with a menu bar UI and a CLI (nh) that handle both.

What's new vs NeoHub

• Project registry — starred and recent project lists, with custom names, icons (SF Symbols or emoji), and highlight colors.
• Session.vim support — opening a directory with a session file just works.
• Instance resurrection — after a restart or crash, NeoHubR reconnects to all running Neovide windows automatically.
• Switcher — global hotkey overlay (`⌃``) to jump between open projects.

Screenshots

Requirements

• macOS 14 (Sonoma) or later
• neovide in your PATH

Installation

1. Download the latest .dmg from Releases.
2. Drag NeoHubR.app to /Applications.
3. Open Settings and click Install CLI.

Note

This build is unsigned. If macOS blocks it, right-click → Open in Finder, or allow it via System Settings → Privacy & Security.

Usage

CLI

Use nh in place of neovide. If that project is already open, nh brings it to focus instead of launching a duplicate.

nh .          # open current directory
nh ~/projects/foo

Important

macOS GUI apps don't inherit your shell environment — PATH, LSP configs, etc. won't be set if you launch from the Dock. Running nh from your terminal passes the full shell environment to Neovide.

Hotkeys

Action	Default
Open Switcher	`⌃``
Jump to last active editor	⌘⌃Z
In Switcher
Navigate up/down	↑/↓ or ⌃K/⌃J
Cycle through editors	⇥ / ⇧⇥
Quit selected editor	⌘⌫
Quit all editors	⌘Q

Most shortcuts can be changed in Settings.

Building

DMG (full package):

./scripts/build.sh
# output: ./build/dist/

Manual:

xcodebuild -project NeoHubR.xcodeproj -scheme NeoHubR -configuration Debug build
xcodebuild -project NeoHubR.xcodeproj -scheme NeoHubRCLI -configuration Debug build

Roadmap

• v0.4.x — GUI environment inheritance; attach to non-NeoHubR Neovide instances; Switcher polish.
• v0.5.x — Localization framework and string migration; full SwiftUI assessment.

Credits

• App icon: u/danbee
• Upstream: micsama/NeoHubR
• Original: alex35mil/NeoHub

License

MIT