Features / Install, Update and Clean

Install, Update and Clean.

Every upgrade previewed, Homebrew, App Store, macOS and npm, bun and cargo tools, version to version; Clean shows what Mole would remove and asks first.

14 features
Update and Clean

Everything in Update & Clean.

Every feature, with its key and where it lives in Pilot.

Install and update
Set up everything

One click installs every helper and picks Pilot's apps, each step shown and undoable; Allow the rest walks each permission in turn.

First launch

Pilot opens text files

Pilot is in the .txt and .md app pickers: its window edits text, previews Markdown and saves.

Apps › Open with

Install

A curated catalogue of Mac apps by category (browsers, editors, terminals, AI, ADEs, fonts) plus all of Homebrew.

Hyper+Space (Install); Apps › Install

Remove

Lists what is installed, sortable by least used, and shows exactly what goes before it goes.

Hyper+Space (Remove)

Update

Previews every upgrade, Homebrew, App Store, macOS and npm, bun and cargo tools, version to version, then runs it.

Hyper+Space (Update), Mac › Update & Clean

Clean

Shows what Mole would remove and the space it frees; cleans only after you confirm.

Hyper+Space (Clean), Mac › Update & Clean

Reports

Every Update and Clean run kept: what ran, how it ended, its output.

Mac › Activity › Reports

Helpers

The command-line tools other features need, with one Install each.

Apps › Install › Helpers

Default apps

Pick your main editor and the app each kind of file and link opens with.

Apps › Open with

Configs

Every config file of the apps on the Mac in one list, opened in your editor, and the files coding agents read.

Apps › Configs (General › Developer pages)

Repos

Your repos in ~/code with their branch and last commit, a file tree, and previews of text, Markdown as GitHub shows it, images and PDFs. Read-only.

Apps › Repos (General › Developer pages)

Fonts

Install fonts from the catalogue and pick the one Pilot, Ghostty, VS Code, Cursor, Zed and other apps use; only the font changes.

Apps › Fonts

Hidden apps

Apps you never want offered, Chess say, leave Pilot's lists, and Finder's too for apps you installed.

Apps › Install › Hidden apps

Password toolsHyper+Shift+P

Fill a login, search, lock or generate a password with Bitwarden.

Hyper+Shift+P generates one; Hyper+Space

Pilot14 featuresAll 246 features

Install Pilot 1.2.0.

Free and open source. Needs macOS 27 or later on Apple silicon.

  1. 1DownloadDrag Pilot to Applications
  2. 2Open PilotClick Open when macOS asks, once
  3. 3Pick your Hyper keyAnd allow Accessibility
Details
  1. Download Pilot.dmg, open it and drag Pilot to Applications.
  2. Open Pilot. macOS asks once whether to open an app downloaded from the Internet: click Open.
  3. Pick your Hyper key in Pilot's setup and allow Accessibility. Hyper+Space opens the menu.

Pilot is signed with Apple's Developer ID and notarized by Apple. Updates install from inside Pilot and keep your permissions.

Permissions and checking the download

  • Accessibility: Pilot needs it to see your keys and move windows; nothing works without it.
  • Full Disk Access for file search in the menu, and System Events for sleep, restart and dark mode.
  • Microphone for dictation and an AI provider for the AI chat, both optional.
  • Input Monitoring only if Pilot asks, when you bind a mouse's media buttons.
  • Screen Recording when you first take a screenshot or recording, or turn on Menu bar › Other apps › Show exact menu bar items. macOS applies it after Pilot reopens: click Quit & Reopen.

Caps Lock as Hyper: tapped alone it is Escape, and Shift+Caps Lock still types capitals. Password fields are blind to every key tap on macOS, Pilot's included: your binds do not work while one has focus.

Check the download against the .sha256 beside it on the Releases page: shasum -a 256 -c Pilot.dmg.sha256.