NeoHubR

A macOS menu bar app that gives Neovide proper project management. Forked from micsama/NeoHubR, itself a full rewrite of alex35mil/NeoHub — with every change in this fork vibe-coded start to finish.

---

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.
• Open files into a running instance — nh path/to/file:line:col opens the file in the already-open project (jumping to the line/column) instead of only raising the window. A file that lives inside an already-open project is routed into that window rather than spawning a sibling editor.
• Capture editor links — optionally register NeoHubR as the handler for VS Code's vscode:// scheme, so tools that "open in VS Code" (jumping to a file and line) open in Neovide instead. Toggle it in Settings.

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. Passing a file opens it in the running instance; append :line or :line:col to jump straight there.

nh .                    # open current directory
nh ~/projects/foo
nh ~/projects/foo/src/main.rs        # open a file (into the running instance if already open)
nh ~/projects/foo/src/main.rs:42     # jump to line 42
nh ~/projects/foo/src/main.rs:42:8   # line 42, column 8

Editor links

Some tools open files by handing them off to VS Code via its vscode:// URL scheme instead of running a CLI. In Settings → General → Capture Editor Links, pick VS Code and NeoHubR registers as the system handler for that scheme: those vscode://file/…:line links then open in Neovide (routed into the containing project if it's already open). Set it back to Off to release it.

Note

This claims the vscode:// scheme system-wide. If you actually use VS Code, leave this Off.

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