Onyx Code 2.3.0

Onyx Code can now update its local AI engine between app releases, so newly released model families load without waiting for a new version of the app.

Downloading

If you're installing manually:

macOS

• Apple Silicon Mac (M1 or newer): download OnyxCode-darwin-arm64.dmg (smaller, native).
• Intel Mac, or unsure: download OnyxCode-darwin-universal.dmg (runs on both).

Open the .dmg and drag Onyx Code to /Applications/. Both macOS downloads are signed and notarized by Apple, so they pass Gatekeeper and open without security warnings.

Linux (x64)

• Debian / Ubuntu: download OnyxCode-linux-x64.deb and install it with sudo apt install ./OnyxCode-linux-x64.deb.
• Other distributions: download OnyxCode-linux-x64.AppImage, make it executable (chmod +x), and run it. On Ubuntu 24.04 (which lacks libfuse2) run it with --appimage-extract-and-run.

Windows (x64)

Install with winget: winget install OnyxCode (recommended). It runs through Microsoft's App Installer (a trusted Microsoft Store app) with a package listing reviewed in Microsoft's community winget repository, so it verifies the download and gives a smoother first-run experience. The same installer (OnyxCode-win32-x64-winget.exe) is also attached here for manual download; note it is not code-signed yet either way, so Windows may still show an "Unknown publisher" warning. A code-signed installer is planned for a later release.

The *-autoupdate.zip, darwin-*.json, linux-x64.json and win32-x64.json files are plumbing for Onyx Code's
built-in auto-updater. They are not designed for manual install and will give
you a worse first-run experience than the download above.

What's New

Added

• The AI engine keeps itself current. Once a day Onyx Code checks for a newer llama.cpp engine, tests it on your current chat model, and switches to it when it passes, so new model families can load as soon as the engine supports them. A new engine that does not start cleanly is rolled back automatically, and the engine that ships with the app always stays available as the fallback. Choose automatic, notify-only or off with the onyxcode.ai.engineUpdates setting. Engine updates never run in Air-Gap Mode.
• An Engine section in Models. Models > My Models shows which engine version runs your models and on which processor, when it last changed, and lets you check for or install an update in one click. Also available as Onyx: Check for Engine Updates in the Command Palette.
• One click to run a model that needs a newer engine. When a model is newer than your engine, Onyx Code tells you so and offers the newer engine in one click, then loads the model.

Changed

• Model switching keeps up with you. Pick a model while another is still loading and the one you picked last is the one that runs.
• The AI status bar follows model loading. It shows "AI Loading" while the model you chose starts up and "AI Ready" as soon as that model can answer.

System Requirements

• macOS 11 (Big Sur) or later.
• Apple Silicon (M1 or newer) or an Intel Mac. The Universal download runs natively on both.

Installing

1. Download the .dmg that matches your Mac (see "Downloading" above).
2. Open it and drag Onyx Code into your Applications folder.
3. Launch it from Applications. Because the build is notarized, it opens without a security prompt.

Verification

This build is signed and notarized by Apple. macOS verifies it on first launch, so it opens as an app from an identified developer without security warnings.