Quick Reference

Keyboard Shortcuts

Shortcut	Action
Cmd+Shift+A	Transform current clipboard content (global)
Cmd+Shift+H	Open clipboard history (global, customizable)
Cmd+Q	Quit application

Tip: The History shortcut can be changed in Settings → Keyboard Shortcuts.

Common Tasks

Accessing the App

1. Look for the clipboard icon in your menu bar
2. Click it to see available actions
3. Select “Settings…” to configure

Adding Your API Key

1. Click menu bar icon → “Settings…”
2. Select your AI provider from the dropdown
3. Paste your API key
4. For Vertex AI, also enter your Google Cloud Project ID
5. Click “Save”

Creating a Workflow

1. Click menu bar icon → “Workflows…”
2. Click the ”+” button to create a new workflow
3. Give it a name and description
4. Select trigger type (Code, Text, Error, URL)
5. Choose an action (Explain, Summarize, Fix Grammar, etc.)
6. Toggle “Auto-trigger” if you want it to run automatically
7. Click “Save”

Transforming Text

Manual:

1. Copy text to clipboard
2. Press Cmd+Shift+A or click menu bar icon
3. Select desired transformation
4. Choose “Copy” or “Replace”

Automatic:

1. Enable “Auto-process clipboard changes” in Workflows
2. Set specific workflows to auto-trigger
3. Content matching the trigger automatically transforms

Supported AI Providers

• Claude (Anthropic)
• OpenAI
• Google Gemini
• Google Vertex AI
• OpenRouter
• Cerebras
• Together AI
• z.ai

Content Types

The app can detect and handle:

• Code - Programming code in any language
• Error Messages - Stack traces and error output
• URLs - Web links and addresses
• Text - General text content
• Custom - Keyword-based matching

Built-in Actions

Action	Use Case
Explain	Understand code or complex concepts
Summarize	Condense long text or articles
Fix Grammar	Correct spelling and grammar
Translate	Convert text between languages
Search Solutions	Find answers to error messages
Generate Code	Create code from descriptions
Simplify	Make text easier to understand
Custom Prompts	Use your own instructions

Distribution Commands

# Build the application
./build.sh

# Create simple DMG installer
./create-dmg.sh

# Create fancy DMG with layout
./create-fancy-dmg.sh

# Create ZIP package
./sign-and-package.sh

Testing Commands

# Test DMG locally
open ClipboardRecast-v1.0.0.dmg

# Create git release tag
git tag -a v1.0.0 -m "Initial release"
git push origin v1.0.0

Troubleshooting Quick Fixes

Problem	Solution
App not in menu bar	Restart app or check Activity Monitor
Hotkey not working	Grant accessibility permissions in System Preferences
API key error	Verify key is correct and account has quota
Transformations slow	Check internet connection and API provider status
”Can’t be opened” / damaged error	Run xattr -cr /Applications/ClipboardRecast.app in Terminal, then relaunch

First Installation (macOS)

1. Download ClipboardRecast-v1.0.0.dmg
2. Open the DMG file
3. Drag ClipboardRecast to Applications folder
4. First launch: Right-click app → choose “Open”
5. Click “Open” in the dialog
6. After first launch, open normally from Applications or Spotlight

System Requirements

• macOS 13.0 (Ventura) or later
• Internet connection (for AI transformations)
• One AI provider API key

Privacy & Data

• API keys stored locally in macOS UserDefaults
• No data collection
• No network traffic except to your chosen AI provider
• Clipboard access only when you trigger transformations

File Locations

Item	Location
Application	/Applications/ClipboardRecast.app
Settings	macOS UserDefaults (system)
Workflows	Stored with settings
API Keys	Encrypted in UserDefaults

Support & Resources

• Documentation
• Troubleshooting
• Privacy & Security