A lightweight macOS Finder extension that lets you build your own right-click menu —
custom actions, "Open With" shortcuts, and quick file operations, all configurable from a clean settings UI.
Native macOS app built with SwiftUI + FinderSync. No Electron, no background bloat.
- 🖱️ Custom right-click actions — define your own menu items with full create / edit / delete (CRUD) management
- 📂 Open With — quickly open selected files/folders with your chosen apps
- 🆕 New file / folder — templates, Office (docx/xlsx/pptx), iWork, from-clipboard, and more
- 🧩 FinderSync extension — integrates directly into the native Finder context menu
- 🌐 Localization — multi-language support built in
- 🚀 Launch at login — runs quietly and stays out of your way
- 🪶 Lightweight — pure native Swift, minimal footprint
There is no pre-built download — you build it yourself. The recommended path uses ad-hoc signing, which needs no Apple Developer account or certificate and runs on your own Mac.
git clone https://github.com/karrychow/RightClickBuddy.git
cd RightClickBuddy
# Generate the Xcode project from project.yml
xcodegen generate
# Build + ad-hoc sign + install to /Applications + reload the Finder extension + launch
bash scripts/dev-deploy-adhoc.shdev-deploy-adhoc.sh asks for your sudo password (to place the app in /Applications).
It does not touch your keychain.
The first install may need you to switch the extension on:
- Open System Settings ▸ General ▸ Login Items & Extensions
- Under Extensions, find RightClickBuddy and make sure its Finder extension is enabled
- Right-click in Finder (Desktop, Downloads, …) — the RightClickBuddy menu should appear
Prefer signing with your own Apple Developer certificate instead of ad-hoc? Use
bash scripts/dev-deploy.sh (auto-picks your first Apple Development identity, or set
SIGN_IDENTITY="Apple Development: you@example.com").
Right-click any file, folder, or empty space in a Finder window in a supported location (by default: Desktop, Downloads, Movies, Music, Pictures — add more under Settings ▸ Scope). You get:
- New — text / markdown / json / shell / .env, templates, Office & iWork documents, from clipboard
- Open With — open the folder or the selected items in your chosen editor/terminal
- Copy path / filename, Open in Terminal, and more
Open Settings from the menu-bar icon to toggle menu groups, manage templates, choose which "Open With" apps appear, and set which folders the menu is active in.
App/— the host SwiftUI app (settings UI, menu-bar item, launch-at-login, IPC server)FinderSync/— the sandboxed Finder Sync extension that renders the context menuShared/— shared code (IPC protocol, settings, logging, localization)
Because the Finder extension is sandboxed, it cannot launch other apps or write files in
arbitrary locations itself. It delegates those operations to the non-sandboxed host app over a
local TCP channel on a fixed loopback port (127.0.0.1:52847, see Shared/IPCProtocol.swift).
If the host app isn't running when an action needs it, the extension auto-launches it and retries.
Settings flow the same way: the host app stores them in a normal file
(~/Library/Application Support/RightClickBuddy/settings.json) and the extension fetches them over
the same IPC channel. Nothing depends on an App Group container, which is why an ad-hoc-signed
build has full functionality (including persistent settings and custom scope folders) with no
Apple Developer account.
- "Main app is not running" — should not happen anymore (the extension auto-launches the host
app). If you ever see it, open RightClickBuddy once from
/Applications. - Menu doesn't appear — enable the extension (see Enable the Finder extension above), then
open Settings and click Reload Finder Extension (or run
bash scripts/dev-reload-findersync.sh). Re-enabling in System Settings is sometimes needed after re-signing with a different identity. - A custom scope folder shows the app's icon — macOS marks the root folders the extension
watches (system folders like Downloads, and your home
~, are exempt). Tip: add a parent folder to Scope instead of the specific one — e.g. add~to get the menu in every subfolder (like~/workPlace) with no icon marker on any of them. The folder itself is never modified. - Rebuilding after code changes — just re-run
bash scripts/dev-deploy-adhoc.sh.
- Version (
MARKETING_VERSIONinproject.yml) — semantic, bumped by hand per release: minor (1.1.0) for new features, patch (1.0.1) for fixes. - Build number — derived automatically from the git commit count at build time (injected by the build scripts), so every commit produces a distinct, traceable build.
- The running version shows at the bottom of the Settings window, e.g.
v1.1.0 (85).
| Script | What it does |
|---|---|
scripts/dev-deploy-adhoc.sh |
Build → ad-hoc sign → install → reload → launch (recommended) |
scripts/dev-deploy.sh |
Same, but signs with your Apple Development certificate |
scripts/dev-build-debug.sh |
Build only (unsigned) |
scripts/dev-reload-findersync.sh |
Re-register the extension + restart Finder |
scripts/dev-reset-container.sh |
Reset the App Group container (needs Full Disk Access) |
MIT © karry