Features / Extensions and the pilot command

Extensions and the pilot command.

Add commands from the catalogue or build your own, and drive Pilot from a terminal or an agent.

12 features
Extensions

Everything in Extensions.

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

Extensions
Tailscale

Your Tailscale devices online in the top bar and Hyper+Space, a page of its own, Connect and Disconnect; a row copies a device's IP.

Extensions (from the catalogue)

Extensions

Small programs in any language whose commands show in Hyper+Space, take keys, and get views Pilot draws.

Extensions

Glass and line icons

Extension pages, blocks and bar popovers stand on Pilot's glass, with line icons Pilot draws.

Extensions

Extension catalogue

Install, update or remove extensions (Pomodoro, Weather…) from Pilot's own catalogue, listed under your installed ones in one Extensions list.

Extensions; Hyper+Space

Extension pages and bar items

An extension can have its own page, a menu-bar icon with a popover, a timer and alerts.

Extensions; Desktop › Menu bar

Settings per extension

Text, password (Keychain), choice, app or folder settings each extension declares.

Extensions › Installed

Make one with AI

The /extension skill builds a new extension from a description.

AI chat

Summarise

A catalogue extension that summarises a YouTube video, a web page or a document with Pilot's AI, the full text beside it; also in the selection pill.

Extensions

The pilot command
More pilot verbs

Run an extension's action, ask the AI, set mouse binds, pick the AI model and grant a permission, from a terminal.

pilot help in a terminal

pilot in the terminal

Read and change every Pilot setting, bind and list from a script or a terminal, with answers back.

General (links it into your PATH)

pilot:// links

Links that run actions or flash a message, for your own scripts.

Any script

Agents can drive PilotHyper+Q

Codex reaches Pilot through the bundled MCP server; CLI agents use the same pilot command. /theme in Ask Pilot helps create, validate and preview saved packs through the shared engine; Apply and optional reload still need separate user approvals.

General; Hyper+Q, /theme; pilot guide theme in a terminal

Pilot12 featuresAll 246 features

The catalogue.

18 extensions to get from the Extensions list, or type their name in Hyper+Space. They live in catalogue/extensions in Pilot's repo; send yours as a pull request.

  • AI usageSee how much of your Claude and Codex limits is left this session and this week, how your pace…
  • Claude SessionsFind a Claude Code session you had and pick it back up, without digging through folders
  • Dev UtilsTurns whatever you copied into the form you need, without a website
  • Easy-CD foldersOpen the folders you pinned or visited lately with easy-cd (ecd) in a terminal, without typing…
  • Ghostex sessionsSee which Ghostex agents are working or waiting on you from the menu bar, read a session's chat…
  • lazygitSee which of your git repos have changes to commit or commits to push or pull; click one to…
  • GitHubSee what on GitHub needs you: pull requests waiting on your review, your own with their checks,…
  • MarketsStocks, ETFs and coins and their day's change in the menu bar, as text, with the day's line or…
  • Now playingWhatever your Mac is playing, in the menu bar, as Control Center's Now Playing sees it: Music,…
  • Obsidian searchFind a note in your Obsidian vault by its title or by what it says, without opening Obsidian…
  • PomodoroWork in focused blocks with short breaks, the time left counting down in the menu bar
  • PortsFrees a port a forgotten program is holding, when a dev server says the address is already in…
  • SSH hostsConnects to a server you named in your SSH config, in a new terminal window, without typing the…
  • SummariseSummarises a YouTube video, a web page or a document with Pilot's AI, with its full text beside…
  • TailscaleSee which of your Tailscale devices are online, copy a device's Tailscale IP or name, and…
  • To-doA to-do list in Hyper+Space and the menu bar: type to add or filter, Return ticks one off,…
  • Video downloaderSaves a YouTube, X or Twitch video or its audio to Downloads, through yt-dlp and ffmpeg from…
  • WeatherThe temperature now in the menu bar; click it for feels like, high and low, rain chance, wind,…

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.