Install Lettuce
Install Lettuce
Lettuce runs on macOS 14 (Sonoma) or later, on both Apple Silicon and Intel.
1. Download
Grab the latest signed and notarised DMG from https://lettuce.drbaher.com/Lettuce.dmg.
The file is around 13 MB. The DMG is unsigned at the container level (a macOS convention for free distribution) but the .app inside is signed and notarised — that’s what Gatekeeper actually checks when you launch it.
2. Drag to Applications
Open the DMG, drag Lettuce 🥬 to your Applications folder, and eject. Launch Lettuce from Spotlight, Launchpad, or open -a Lettuce in Terminal.
The first launch may show a Gatekeeper prompt. If macOS says “Apple could not verify…” right-click the app → Open → Open. This only happens on the first launch after a fresh download.
3. What gets installed
| Location | What’s there |
|---|---|
/Applications/Lettuce.app |
The main app |
~/Library/Application Support/Lettuce/ |
Your config, logs, the docs vault |
~/Library/Application Support/Lettuce/Documentation/ |
This documentation, regenerable |
~/Library/QuickLook/Lettuce.qlgenerator |
(optional) .md previews in Finder |
/usr/local/bin/lettuce |
(optional) the CLI, on demand |
Lettuce does not install a launch agent, a login item, or anything in /Library/LaunchDaemons. There’s no background process unless you explicitly start the server (Settings → General → Agent API server, or lettuce serve).
4. The CLI (optional)
The lettuce CLI is the same binary inside the app bundle — there’s no separate installer. To use it in your shell, symlink it onto your $PATH (the symlink points into the bundle, so app updates are picked up automatically):
sudo ln -sf /Applications/Lettuce.app/Contents/MacOS/Lettuce /usr/local/bin/lettuce
You can also invoke the CLI directly:
/Applications/Lettuce.app/Contents/MacOS/Lettuce --help
See CLI cookbook/00 Overview for the full subcommand reference.
5. Uninstall
Three steps cleanly remove everything:
rm -rf /Applications/Lettuce.app
rm -rf ~/Library/Application\ Support/Lettuce
rm -f /usr/local/bin/lettuce
Your vault notes are not stored in Application Support — they live wherever you chose to put them (typically ~/Documents/<your vault>/). Lettuce won’t touch your notes on uninstall.