Neo

The agent console for finance, ops, HR, sales, and support.

  

What is Neo · Features · Install · Auto-updates · Support

This repository hosts signed + notarized builds of Neo. Source code lives in the main erphq/neo repo — this one only holds release artifacts.

What is Neo

Neo is the agent console for the people whose job the agent helps with — finance leads, ops managers, sales reps, HR generalists, support engineers. Open Neo, pick a skill or describe the work in plain language, and watch the agent do the busywork: pull invoices, draft customer outreach, reconcile records, investigate anomalies. You approve the moves that matter.

Local-first. The chat, your files, your API keys, your memory, and the audit trail of every action all live on your machine. The only thing that ever leaves the machine is the model call itself.

Features

• 🗣️ Plain-language chat. Ask in your own words; Neo routes to the right skill and the right tool.
• ✅ Sign off, don't operate. Anything that mutates external state — sending an email, updating an invoice, running a shell command — surfaces a one-sentence consequence and asks before it acts.
• 🧩 Talks to your systems. ERP, CRM, sheets, inboxes — connect over MCP and the agent can read and write directly.
• 🛠️ Installable skills. Each skill is a markdown file that teaches the agent one job. Install from a curated registry, GitHub, or a local folder.
• 💾 Remembers what matters. Cross-session memory lives in plain markdown — customer history, decisions, preferences — that you can open in any editor.
• 🌐 Searches the web when it needs to. Pulls docs, fetches pages, grabs context.
• 🔄 Model-agnostic. Works on Claude, Gemini, GLM, Llama, Ollama, and more — pick whichever fits your cost / latency / quality budget.
• 🎨 Looks how you want. 14 themes out of the box, custom fonts, light/dark auto-switch.
• 🚀 Updates itself. New versions install with one click from Settings. Signed and verified before install.

Install

macOS (Apple Silicon)

1. Click the Download for macOS button above (or pick from Releases)
2. Open the .dmg, drag Neo into Applications
3. Launch from /Applications/Neo.app

No Gatekeeper prompt. No right-click → Open workaround. It just opens.

Why there's no Gatekeeper warning

The app is:

• Code-signed with a Developer ID Application certificate (Deskera Holdings Ltd., team DMZC7LUBK8)
• Notarized by Apple's notary service — both the .app bundle and the .dmg container
• Stapled — Gatekeeper verifies the notarization ticket offline, no internet needed on first launch

Verify the download yourself:

spctl --assess --type open --context context:primary-signature -vv ~/Downloads/Neo_*_aarch64.dmg
# → accepted
# → source=Notarized Developer ID
# → origin=Developer ID Application: Deskera Holdings Ltd. (DMZC7LUBK8)

xcrun stapler validate ~/Downloads/Neo_*_aarch64.dmg
# → The validate action worked!

Windows (x64)

1. Click the Download for Windows button above
2. Run the .exe installer
3. Launch Neo from the Start Menu

SmartScreen warning: Windows will show "Windows protected your PC" on first install because the app is currently unsigned. Click More info → Run anyway to proceed. We're working on adding a code-signing certificate.

First-run setup (both platforms): open Settings → paste an OpenRouter or Fireworks API key → pick a skill or just start chatting.

Auto-updates

Neo checks this repository silently on launch. When a new version is published, a green dot appears on the Settings icon in the titlebar.

To update, open Settings → About → Download and install. The app downloads, verifies the signature, installs, and relaunches itself.

Auto-updates are currently macOS only. Windows auto-update is coming in a future release.

Update artifacts are signed with a dedicated ed25519 key (minisign). The app embeds the matching public key at build time — any tarball that doesn't verify is rejected before install.

What's in a release

Every tag (vX.Y.Z) ships:

Asset	Platform	Purpose
Neo_X.Y.Z_aarch64.dmg	macOS	Installer (what humans download)
Neo_X.Y.Z_aarch64.app.tar.gz	macOS	In-app auto-update payload
Neo_X.Y.Z_aarch64.app.tar.gz.sig	macOS	Minisign signature for the payload
Neo_X.Y.Z_x64-setup.exe	Windows	NSIS installer
Neo_X.Y.Z_x64-setup.exe.sig	Windows	Updater signature
latest.json	both	Update manifest consumed by the Tauri updater

Support & issues

Bug reports, feature requests, and discussion: erphq/neo/issues.

---

_{Built with Tauri. Mac builds signed by Apple. Distributed by humans who prefer not to dance around Gatekeeper.}