mac preview

Download Folder for Mac.

A preview Mac companion for the agent-first Folder platform. Install the app for local sync, Finder visibility, and guided setup, or use the terminal installer if you only want Folder Sync.

Download DMGGitHub
App
Dock-visible preview app with a drag-to-Applications DMG
Folder Sync
Terminal installer also available via one curl command
Trust level
Unsigned developer preview; notarized release still required
mac app

Install Folder for Mac

Download the DMG, drag Folder into Applications, and open it from Applications. The app creates a local Folder workspace, connects to a Folder from your account, and starts Folder Sync.

  1. 1. Download Folder for Mac.
  2. 2. Open the DMG and drag Folder into Applications.
  3. 3. Open Folder from Applications or click Open app in the dashboard sidebar.
  4. 4. In the dashboard, create an API key and click Open in Folder for Mac.
  5. 5. Click Start Sync. If macOS asks for access, allow Folder using the blue Folder app icon in Privacy settings.
Unsigned preview: macOS Gatekeeper can block the app because it is not notarized yet. A production release needs Apple Developer ID signing and notarization; this build is for internal testing.
internal preview shortcut
curl -fsSL https://www.folder.md/install/folder-mac-preview.sh | zsh

This installs the preview, removes quarantine, and opens Folder. Use it only for internal testing until notarization lands.

daemon only

Install Folder Sync from Terminal

If you just want the background sync worker for an agent or shell workflow, use the terminal installer. This keeps the API/MCP path first-class and avoids the Mac app entirely.

curl -fsSL https://www.folder.md/install/folderd.sh | zsh

If `~/.folderd/config.json` already exists, the installer will also register the launchd agent and start Folder Sync. If not, it will stop and tell you exactly what to do next.

What this preview already includes
  • • Native macOS menu bar surface for Folder using a standard monochrome status icon.
  • • Dock-visible first-run setup plus menu bar status for quick actions.
  • • Direct foldermd:// app handoff, setup-code import fallback, Folder picker, guided sync-path defaults, Folder Sync health, sync trigger, and recent sync activity.
  • • Embedded folderd source inside the app bundle for local bootstrap.
  • • Branded DMG installer window with drag-to-Applications guidance.
  • • Finder-first actions for opening, revealing, and favoriting the local Folder workspace, plus macOS Privacy Settings shortcuts.
  • • Direct daemon install path from the terminal.
Still coming
  • • Signed and notarized production build.
  • • Optional `.pkg` installer for users who expect install-complete auto-launch behavior.
  • • Cleaner first-run onboarding and live Folder Sync heartbeat in the web dashboard.
  • • Dropbox-style Finder Locations via a File Provider extension.
Native setup notesSource previewOpen dashboard