Early access · v0.1.8 · macOS

File management on a Mac has always been painful. We built a better one.

Mac Explorer is a fast, keyboard-first file manager with instant search, real folder sizes, a disk map that tells the truth, and a CLI your AI agent can use.

  • As you typename search from its own index
  • Every foldersized and sortable, instantly
  • Whole Macdisk map, clones counted once
  • Read-onlySQL and CLI for your agent
Search

Every file. Before you finish typing.

Press ⌘K and results arrive as you type, ranked from Mac Explorer’s own index of the folders you choose. The file you meant comes first, and node_modules never buries it.

  • Name prefix matches rank first; every word has to match
  • Build output and dependencies stay out of results, but their sizes still count
  • Gitignored media and data are searchable, just ranked lower
  • ⌘↩ opens every hit as a results tab with live previews

vs FinderFinder’s search goes through Spotlight, which ranks file names loosely and skips developer folders.

Instant search with ⌘K
Folder sizes

See what’s big. Without waiting.

The Total column shows every folder’s real recursive size with an inline bar, straight from the index. Click the header and the space hogs rise to the top. It updates live as files change.

  • Sortable, with proportional size bars
  • Counts node_modules, .git and build folders at their true weight
  • No “Calculate all sizes” spinner

vs FinderIn Finder, “Calculate all sizes” is off by default, slow, and has no bars.

The Total column
Disk Usage

Where did my disk go? Now you know.

A treemap of your whole Mac: every area, the macOS volumes and the “Unattributed” space (local snapshots, purgeable, unreadable folders), adding up to exactly what the disk reports. APFS clones and hard links are counted once.

  • Clone-aware sizes: what deleting something would actually free
  • What grew in the last 7 days
  • Read-only by design, and safe to explore
  • Full keyboard navigation and VoiceOver support

vs FindermacOS Storage settings give you coarse categories and a big grey “System Data”.

Clone-aware Disk Usage
For your AI agent

Your Mac, queryable.

The macx CLI and a local API put the index behind read-only SQL: sizes, duplicates, photo EXIF and GPS, what changed and when. One query instead of ten thousand find calls.

  • Read-only: nothing in it can move, rename or delete
  • Secret files (.env, keys, .ssh) are never readable through it
  • One JSON envelope and typed exit codes
  • A self-documenting manual any agent can read

vs FinderFinder has no scripting surface for questions like “which photos did I take in Iceland?”

Ask your agent
Go to path

Any path. Any app. One keystroke.

Press ⌃⌥⌘Space from any app, paste a path and press ↩. Escaped, quoted, ~ and file:// paths all work as pasted. In the app, ⇧⌘T pre-fills from the clipboard, and ⌘L offers to create folders that don’t exist yet.

  • Paste paths straight from Terminal or Slack
  • ⌘G jumps to the copied path with no box at all
  • Optional: every app’s “Reveal in Finder” opens here

vs FinderFinder’s Go to Folder (⇧⌘G) only works inside Finder.

⌃⌥⌘spaceRead the guide →
Paste a path, land there
Quick View

Preview it. Edit it. Stay in the window.

A preview pane that does real work. Images (including HEIC), video with seeking, PDF, Word, Excel and Markdown. With nothing selected it becomes a gallery of every image in the folder. Markdown folds, finds and edits in place. CSVs open as a typed, sortable database.

  • Camera, lens, exposure and GPS for photos
  • Edit Markdown in place and save with ⌘S
  • A floating image viewer that steps through the folder

vs FinderFinder’s preview pane can’t edit, can’t page through a folder of photos, and shows Markdown as plain text.

Quick View and the folder gallery
Terminal

Your terminal, already in the right folder.

⌃` slides a real login shell up from the bottom, already in the folder you’re looking at. Tab titles follow cd, ⌃⇧` adds tabs, and shells keep running when the drawer is hidden.

  • Your own shell and PATH
  • Up to 16 tabs, reorderable
  • GPU rendering, truecolor, clickable links

vs FinderFinder can only hand you off to Terminal.app through a Service.

Terminal drawer
Drag & drop

Gather from everywhere. Drop anywhere.

A plain drag exports the real files to Finder, Mail, Gmail, Slack or any other app. The Drop shelf collects files from many folders so you can drag them all out at once, and it’s shared with the menubar panel.

  • Stages references, so nothing is moved until you drop
  • Spring-loaded folders while dragging
  • Share anything on the shelf with one right-click

vs FinderFinder has no shelf for collecting files across folders.

Drop shelf and drag out
Keyboard first

Your hands never leave the keys.

Finder muscle memory still works: ↩ renames, Space is Quick Look, ⌘⌫ moves to the Trash. Everything else is one chord away.

⌃⌥⌘spaceSummon from any app
⌘KSearch everything
⇧⌘TGo to a pasted path
⌘LType a path, create folders
⌘TNew tab
⌘1–⌘9Jump to a tab
⌘⌥PQuick View pane
spaceQuick Look
⌃`Terminal drawer
⌘⇧PCommand palette
⌘ZUndo a copy or move
↩Rename, Finder-style

All shortcuts →

Install Mac Explorer

Paste this into Terminal. macOS on Apple Silicon or Intel.

curl -fsSL "https://explore.brightmotion.io/install.sh" | bash
  1. Checks you’re on macOS and detects your chip
  2. Installs Bun if it’s missing (it powers search and indexing)
  3. Copies the app to /Applications, adds the macx CLI and the Finder Quick Action
  4. Clears quarantine and ad-hoc signs the app, then opens it

Re-run the same command to update. Install guide

Questions

Does it replace Finder?
It works alongside Finder. If you want, you can make it the destination of every app’s “Reveal in Finder” (hold ⌥ to reach Finder anyway), add a Finder right-click “Open in Mac Explorer”, and undo all of it with macx defaults restore.
What does search cover?
The folders you choose to index. First run suggests your Home folder, and you can add more at any time. Search matches file and folder names, not file contents. Disk Usage is separate and measures the whole Mac.
Does it use Spotlight?
No. Mac Explorer keeps its own index, updated live as files change. That’s why it can rank developer folders properly and show folder sizes instantly.
Does it send my files or file names anywhere?
No. Anonymous usage counts and crash reports are on by default and can be turned off in Settings. They never include file names, paths or search text. Files only leave your Mac when you share them.
Is it safe to let an AI agent use macx?
The CLI and API are read-only towards your files. There is no endpoint that moves, renames or deletes anything, and secret-bearing files like .env, private keys and ~/.ssh can’t be read through them.
Which Macs does it run on?
macOS on Apple Silicon or Intel. The installer picks the right build and installs Bun (the engine behind search and indexing) if you don’t already have it.
Why does the installer sign the app itself?
This early build isn’t Apple-notarized yet. The installer clears the quarantine flag and ad-hoc signs the app on your Mac so it opens without the Gatekeeper warning.
What isn’t there yet?
Icon, column and gallery views, Finder tags, batch rename and full-text content search. Files copied with ⌘C can be pasted inside Mac Explorer but not into Finder, and moving to the Trash can’t be undone from Mac Explorer.
How do I update or uninstall?
Click Update now when the banner appears, run macx update, or re-run the install command. Uninstalling is the same command with --uninstall, and your data is kept.