Repository navigation
Description
Problem or use case
Orca already provides a configurable Right-click to paste terminal setting on Windows (requested in #560, implemented in #571): right-click pastes the clipboard directly, Ctrl+right-click still opens the context menu, and the toggle lives in Settings → Terminal.
On macOS this setting is not available: right-click always opens the context menu, and the toggle is hidden from Settings. Users who prefer right-click paste cannot enable the same behavior, so the terminal behaves differently across operating systems for the same user.
This is inconvenient for:
- users who run Orca on both Windows and macOS and have to switch mouse workflows per platform;
- users migrating from iTerm2, where a mouse button can be bound to Paste from Clipboard — that established workflow is lost after switching to Orca.
Notably, the plumbing already exists and is platform-agnostic: terminalRightClickToPaste is already a field on GlobalSettings (src/shared/types.ts), and the paste path in the terminal pane is shared. Only two places restrict it to Windows:
- the behavior gate:
const rightClickToPaste = isWindowsUserAgent() && (settings?.terminalRightClickToPaste ?? true) - the Settings UI and settings search, which only render the toggle when
platform.isWindows(src/renderer/src/components/settings/TerminalPane.tsx,src/renderer/src/components/settings/terminal-search.ts).
Proposed solution
Show the existing Right-click to paste toggle in Settings → Terminal on macOS, driving the same behavior as on Windows:
- when enabled: right-click pastes the clipboard contents directly into the terminal, and the context menu stays reachable via a modifier (mirroring the Ctrl+right-click escape hatch from fix: paste on right-click in Windows terminals #571 — Cmd+right-click or Ctrl+right-click, whichever fits Orca's macOS conventions);
- when disabled: right-click opens the context menu, exactly as today.
The default on macOS should remain unchanged (context menu), so nothing changes for existing users. Since terminalRightClickToPaste currently defaults to true (correct for Windows), exposing it on macOS likely needs a per-platform default rather than simply removing the isWindowsUserAgent() gate.
Alternatives or additional context
- There is currently no workaround on macOS: the stored setting value is ignored off-Windows by the behavior gate, and the toggle is filtered out of settings search.
- Precedent: iTerm2 (Settings → Profiles → Pointer) allows binding right-click to "Paste from Clipboard", so many macOS terminal users already have this muscle memory.
- The scope appears small: fix: paste on right-click in Windows terminals #571 already built the setting, the paste path, and the modifier escape hatch — this request is only about lifting the platform restriction with a safe macOS default.
- The same argument may apply to Linux, but this request is scoped to macOS.
Activity
nwparker commentedon Jul 11, 2026
sure this is easy. Will make a PR