Skip to content

[Feature]: Expose "Right-click to paste" terminal setting on macOS #8315

Description

@danl8

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

  1. self-assigned this
    on Jul 11, 2026
  2. nwparker commented on Jul 11, 2026

    @nwparker
    Contributor

    sure this is easy. Will make a PR

  3. added theissue type on Jul 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

enhancementNew feature or request

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions