Right Here

Right-click a folder. Open it in your terminal, your editor or an AI agent.

Website · Install · Set up · Command line · AI assistants · Documentation · Changelog

What Right Here does

Right Here adds a menu to Finder. Right-click a folder, a file or the empty part of a window. Then choose an action:

Action	What it does
Open in a terminal	Opens the folder in Ghostty, Terminal, iTerm2, WezTerm, kitty, Alacritty, Warp, cmux, or a terminal that you add. Agents start in all of them but Warp and cmux.
Open in an editor	Opens the folder or the files in VS Code, Cursor, Zed, Xcode or another editor.
Start an AI agent	Starts Claude Code, Codex, Gemini CLI or another agent in the folder. Your login shell runs it, with your PATH and aliases.
Agent presets	Starts an agent with a prompt that names the selected files: Review, Explain, a test plan, or your own.
New File	Makes a text file, a Markdown file, a blank Word, Excel or PowerPoint document, or a file from your own template.
Copy Path	Copies the path in the form that you need: full, from your home, from the git root, or as an @ mention for an agent.
Reveal in Finder	Selects the items in a Finder window. Not in the menu at first.
Repository link	Copies or opens the page of the file on GitHub, GitLab, Codeberg or Bitbucket, at the commit that you have checked out. Not in the menu at first: see below.

To change the menu:

1. Open Right Here and go to the Finder Menu page.
2. Press Edit Menu.
3. Drag a line to move it. Uncheck a line to take it out.
4. Under Not in the Menu, check an item to put it in: Reveal in Finder, Copy Repository Link, Open Repository Page or a group.

From a terminal: rh config add menu.items repository.copy-link.

The same actions also run from:

• the rh command;
• Quick Actions (right-click, then Quick Actions). They are also Services, so you can give one a keyboard shortcut for the items selected in Finder: System Settings › Keyboard › Keyboard Shortcuts › Services;
• the Shortcuts app, Siri and Spotlight, where a shortcut can also pick one of your pinned or recent folders;
• AI assistants.

How it works

flowchart LR
    you(["You"]) -- "right-click" --> menu["Finder menu<br/>(Finder extension)"]
    menu -- "a small script" --> rh["rh run (an action)"]
    terminal(["Your shell"]) -- "rh run" --> rh
    assistant(["AI assistant"]) -- "MCP" --> mcp["rh mcp"] --> rh
    config[("config.toml")] -.-> menu
    config -.-> rh
    rh --> apps["Terminal · Editor · Agent"]

• The Finder extension reads your config file and builds the menu. It is sandboxed and has no network access.
• A click runs rh through a small script that the Finder extension is allowed to start (rh setup writes it to ~/Library/Application Scripts/com.boyugou.righthere.FinderExtension/). The script runs as you, outside the sandbox. rh opens the app, or types the agent's command into your terminal.
• Apart from the Finder extension, which macOS keeps loaded while Finder runs, Right Here runs nothing in the background. rh runs only when something calls it.

Install

You need a Mac with Apple silicon and macOS 26 or later.

1. Download the DMG of the latest release. It is signed and notarized by Apple.
2. Open the DMG and drag Right Here to Applications.
3. Open Right Here from Applications.

Or install it with Homebrew, from the project's own tap:

brew install --cask boyugou/tap/right-here

To build from source, you need Xcode 26 or later and xcodegen:

brew install xcodegen
./script/install_local.sh     # builds the app, copies it to ~/Applications and runs `rh setup`

Set up

1. Open Right Here. Choose your terminal, your editor and your agents. Press Set Up.
2. Turn on the Finder extension in System Settings › General › Login Items & Extensions › Finder. The setup window has a button that opens this page.
3. Right-click a folder in Finder. The first time an agent starts in your terminal, macOS asks whether Right Here may control it: choose Allow.

You can also run setup in a terminal. Before setup, the command is inside the app: "/Applications/Right Here.app/Contents/Helpers/rh" setup. Setup links it as ~/.local/bin/rh and says the line to add to your shell's startup file when that folder is not on your PATH. Or let an AI assistant do it: press Copy Setup Prompt for AI in the app, and paste the prompt.

To update, download the new DMG and drag the app over the old one. Choose Replace. With Homebrew, run brew upgrade --cask right-here instead. Then open Right Here and press Install or Repair. Your config file stays as it is.

If the menu is missing, run rh doctor: it checks each part and says what to fix. In a folder in iCloud Drive (Desktop and Documents too, when they are in iCloud), Finder shows no menus of extensions: use right-click › Quick Actions there. rh docs troubleshooting has the rest.

This is the beginning of the README. Read the rest at the original. Read the full README ↗