ACE - Support Mac Clipboard

macOS clipboard support for text, files, and image payloads used by ACE tools. ACE Logo

Gem Version Ruby License: MIT

Works with: Claude Code, Codex CLI, OpenCode, Gemini CLI, pi-agent, and more.

macOS only. ace-support-mac-clipboard integrates with macOS NSPasteboard so ACE tools can consume richer clipboard inputs than plain text. It handles screenshots, Finder file selections, and formatted content, presenting normalized Ruby structures to downstream packages.

Use Cases

Attach image and context content from clipboard - support screenshot-based and file-based workflows in ACE tools like ace-prompt-prep without manual file handling.

Handle Finder selections and formatted text - process files and rich content from macOS pasteboard without manual conversion steps.

Keep platform details isolated - encapsulate macOS-specific clipboard behavior in one package so the rest of ACE stays platform-neutral.

Testing Contract

This package is fast-only in the ACE testing model.

  • Deterministic coverage lives under test/fast/.
  • This migration does not introduce test/feat/ or test/e2e/ for this package.

Run:

  • ace-test ace-support-mac-clipboard
  • ace-test ace-support-mac-clipboard all

Part of ACE