I downloaded the DMG from GitHub. An older getting-started page says to Control-click the app and choose Open because the build is unsigned, but the README says to just open it. Which is right, and what are the requirements?
Both were right at the time they were written; the current answer is the README’s.
Current releases are signed and notarized. From v0.1.50 onward every stable release is built by GitHub Actions, signed with a Developer ID certificate and notarized by Apple. For the current release (v0.2.1 at the time of writing) copy Navide to Applications and open it normally — no Gatekeeper workaround is needed, and in-app auto-update works from that release onward.
The workaround was for the unsigned previews (v0.1.26–v0.1.48, and the one-off v0.1.49 preview). If you are running one of those, Control-click the app in Finder and choose Open; if macOS still blocks it, use System Settings → Privacy & Security → Open Anyway. Do not disable Gatekeeper globally. Better: install the current signed DMG instead.
Requirements: macOS 13 or newer on Apple silicon. Each release publishes a DMG and a ZIP; the ZIP is what the in-app updater uses, the DMG is what you install by hand.
Installing from source is the alternative for a development checkout:
git clone https://github.com/nt-nerdtechnic/Navide.git
cd Navide
pnpm install
uv --project backend sync
pnpm dev
That path needs Node.js 22.12+ (22.x), pnpm 10+, Python 3.12+ and uv 0.11+. The packaged app needs none of those — only at least one supported coding CLI installed and authenticated, which is the CLI’s own business, not Navide’s.
Source: README.md, docs/en-US/getting-started.md, docs/en-US/releases.md