Install

Install Levee on macOS

Levee for the Mac is a regular Mac app in a disk image and comes with everything it needs. Installing it takes about two minutes, and this page walks you through it.

What to know before you start.

  • Levee for macOS is a beta, and parts of its interface are still in progress. If something looks wrong, tell us.
  • Levee is built for Apple silicon (M1 and newer) and needs macOS 11 or newer. There is no build for Intel Macs.
  • Apple has not notarised Levee yet. macOS blocks the first launch until you allow Levee.
  • Levee shows when a new version is out, but never installs anything automatically.

Download and install

  1. Download the disk image. It is called levee-macos-arm64.dmg, is about 50 megabytes, and lands in your Downloads folder.

    Download for macOS
  2. Open it. Double-click the file in Finder. A window opens with Levee and your Applications folder side by side.

  3. Drag Levee onto Applications. Levee is now installed. You can eject the disk image in Finder's sidebar and delete the downloaded file.

Open it the first time

Levee is signed but not notarised by Apple yet, so macOS pauses the first launch. You allow Levee once, and from then on it opens like any other app:

  1. Open Levee from Applications. macOS shows that Levee could not be verified and does not open it. Click Done.

  2. Allow it. Open System Settings → Privacy & Security, scroll to the bottom and click Open Anyway next to the line about Levee. Confirm with your password or Touch ID, and Levee starts.

If you prefer the Terminal (in Applications → Utilities), this line has the same effect:

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

From now on, .levee files open in Levee with a double-click, and the Open in Levee button in the web app works too.

The command-line tools

levee-agent and levee-mcp let scripts and AI agents work with Levee documents. Both are part of the app, so there is nothing extra to install. An AI agent only needs the full path to levee-mcp. You find the line for it in Connect an AI agent to Levee.

To use them in the Terminal yourself, open Levee's Preferences (⌘+,) and choose Command line tools → Add. You don't need a password. The tools work in every Terminal window you open after that. levee itself is included too, so levee hero.levee opens a document. Press the button again to remove all three.

Updates

Levee checks once at startup for a new version. When there is one, the start window shows Levee X is available. Download opens the new disk image in your browser, and Skip This Version lets you wait. The check sends only Levee's version number.

Drag the new Levee onto Applications as you did the first time, and confirm in Finder that the old version is replaced. On the first launch, you allow it in macOS once more, as above. Your settings, fonts and sign-in stay, and your documents stay where you saved them.

Coming from Levee 0.7

Levee 0.8 installs the same way: drag it over the old version, and everything carries over. Two things are worth knowing:

  • A document you save with 0.8 no longer opens in 0.7.
  • 0.8 syncs cloud documents in a new way. If you work on cloud documents with others, you all update to 0.8 so you can keep working together.

Removing Levee

Drag Levee from Applications to the Trash. If you added the command-line tools, press the button in Preferences → Command line tools again first. This also removes the line Levee added to your login profile (~/.zprofile).

Something not working?

macOS shows that Levee was "Not Opened" or "could not be verified".
That is the first launch, and Open it the first time shows the way through. The Open Anyway button only appears after you tried to open Levee. Try once, then go to Privacy & Security.
Levee does not start at all, or macOS shows that a newer version is needed.
Levee needs macOS 11 or newer on a Mac with Apple silicon. About This Mac in the Apple menu shows which macOS and which chip you have.
The Terminal prints command not found: levee-agent.
The tools work in Terminal windows you opened after pressing Add. Open a new window and try again.
The text looks wrong, or fonts are missing.
Levee downloads a typeface the first time a document uses it, so it needs an internet connection at that moment. After that, the typeface is on your Mac.
Still stuck?
The support page has more answers. Or write to levee@deichrakete.com and tell us what you see. We will help you from there.