Skip to content

macOS app 0.1.1

Choose a tag to compare

@github-actions github-actions released this 14 Aug 18:09
· 21 commits to main since this release
306a1bf

cix for macOS — Apple Silicon

A menu bar app for a local cix server: start and stop it, see what
its embedding provider is doing, and open the dashboard. Everything
runs on your machine.

Install — fastest, no dialogs

macOS blocks this download twice: once for the disk image, once for
the app inside it. It only inspects files carrying a "downloaded
from the internet" mark, and the app inherits that mark from the
image at the moment you copy it out — so clearing it on the image
first means neither block ever happens:

xattr -d com.apple.quarantine ~/Downloads/cix-*-arm64.dmg

Then open the image and drag cix.app onto Applications.

Already dragged the app across and hit the block? Clear it in place
instead:

xattr -dr com.apple.quarantine /Applications/cix.app

No such xattr in either case just means it was already clear.

Or click through it

  1. Open the .dmg. macOS says it "could not verify" the file.
    Choose Done — never Move to Bin, which deletes the download.
  2. System Settings → Privacy & Security, scroll to Security.
    A line names the blocked file, with Open Anyway beside it.
    Click it and confirm with Touch ID or your password.
    That button appears only after step 1 — going there first shows
    nothing.
  3. The image opens. Drag cix.app onto Applications.
  4. Open cix from Applications. Blocked again, for the app this
    time — repeat step 2 for cix.app.

On macOS 15 and later the old right-click → Open shortcut works for
neither block. You do this once per installed version.

On first launch the app downloads the server itself — cix-server,
the cix CLI and a Metal-accelerated llama-server, about 40 MB —
from the newest server release.
That is the same build the Docker images are cut from, and it
updates on its own schedule: a new server does not need a new app.

Why it is blocked at all

cix is open source and is not signed with a paid Apple Developer
certificate, so macOS cannot verify it and treats the download as
unknown. Nothing is wrong with the file. Integrity is covered by the
checksum instead.

Verify the download

shasum -a 256 -c checksums.txt

Requires macOS 13 or later on Apple Silicon. There is no Intel build:
upstream llama.cpp publishes no macOS x86_64 release asset.

What's Changed

  • fix(mac): a cached ETag is not an answer to "what server should I install" by @dvcdsys in #250

Full Changelog: server/v0.13.0...mac/v0.1.1