Installation Guide

Installing Cuena on macOS

The first launch needs a one-time right-click. Cuena ships ad-hoc signed, so macOS shows an unidentified developer prompt.

Five quick steps

  1. Download the DMG

    Click Download for Mac (getcuena.com/download). The file is about 180 MB.

  2. Drag Cuena into Applications

    Open the DMG, then drag the Cuena icon into the Applications folder.

  3. First launch: right-click, then Open

    Do not double-click. Right-click (or Control-click) Cuena in Applications and choose Open, then confirm when macOS asks. You only do this once.

  4. If macOS still blocks it

    Open System Settings, Privacy & Security. Scroll to the Security section and click Open Anyway next to the Cuena notice.

  5. You're done

    Future launches open normally. Sign in to use managed AI credits; Pro unlocks your own provider key.

FAQ

Why does macOS say unidentified developer?+

Cuena currently skips Apple’s notarization step. The build is still ad-hoc signed, so integrity is preserved. macOS just can’t verify Apple-blessed identity. Notarization is on the roadmap.

Is this safe?+

The source is public and the binary is signed with a stable identity, even without Apple’s imprimatur. You’re trusting the same signing chain you’d trust for any open-source tool you build locally.

I clicked Move to Bin by accident.+

Drag Cuena back out of the Bin into Applications, then go to System Settings, Privacy & Security, Open Anyway.

I’m on Windows.+

Windows support is in beta. Download links and install instructions are sent separately if you’re accepted to the Windows beta track.

Still stuck? Contact usand we’ll help.