#Install

Fold is a macOS desktop app — a signed, notarized .app shipped in a .dmg. There is no web version, no login, and no cloud component.

#Requirements

There is no Intel build. Fold ships mac-arm64 only.

#Homebrew (recommended)

brew install --cask samiabi/fold/fold

That taps samiabi/fold and installs the current release into /Applications. Because the cask points at signed, notarized assets, macOS opens it without a Gatekeeper prompt.

To upgrade later:

brew upgrade --cask fold

To remove it:

brew uninstall --cask fold

#Direct download

Grab the .dmg from the latest release, open it, and drag Fold into Applications.

#First launch

Fold opens the welcome window — a workspace manager with a filter box, your pinned and recent folders, and an Open Folder… button. Pick a project directory and Fold opens a window for it with one terminal session already running.

The app is never a dead screen: opening a project always spawns a session.

#Verifying the signature

The .dmg is signed with a Developer ID certificate and notarized by Apple. To check it yourself:

spctl --assess --type open --context context:primary-signature -v ~/Downloads/Fold.dmg

You should see accepted and source=Notarized Developer ID.

#Setting up the terminal

Fold runs your login shell as-is, so it inherits whatever prompt and plugins you already have. If you want the setup Fold was designed against — Maple Mono NF, Oh My Zsh, Powerlevel10k and a single-line prompt — run:

bash scripts/setup-terminal.sh

Everything it installs is gated behind FOLD=1, so your existing config is untouched outside Fold sessions. See Terminal setup for what it does and why the prompt must stay single-line.

#Where Fold keeps its data

Deleting that directory resets Fold to a first-run state. It never stores anything outside it, and it does not modify any coding agent's configuration.

#Uninstalling

brew uninstall --cask fold
rm -rf ~/Library/Application\ Support/dev.samiworld.fold

If you installed by hand, drag Fold.app from /Applications to the Trash and remove the same support directory.