AI Actions & LLM Integration
User GuideAI Actions & LLM Integration

AI Actions & LLM Integration

On-device Apple Intelligence, Ollama, Cloud LLM providers, prompt templates, and native result card UI.

Supported AI Providers

OpenClip features a unified AI subsystem supporting local, on-device, and cloud models:

Apple Intelligence

macOS 15.1+

macOS native FoundationModels writing tools. 100% on-device, completely private, zero API keys.

Ollama (Local LLM)

Local

Self-hosted local models running via http://localhost:11434 (Llama 3, Mistral, Qwen, DeepSeek).

Cloud API

Cloud

OpenAI, Anthropic Claude, Google Gemini, DeepSeek, Groq, OpenRouter, or custom OpenAI endpoints.

Browser Redirection

Web

Forward selected text directly to ChatGPT, Claude, Perplexity, Gemini, or DeepSeek web interfaces.

Cloud API Providers & Live Models

ProviderDefault Base URLDefault ModelsProtocol Format
OpenAI (ChatGPT)https://api.openai.com/v1gpt-4o-mini, gpt-4o, o1-miniOpenAI Chat Completions
Anthropic (Claude)https://api.anthropic.com/v1claude-3-5-sonnet-latest, claude-3-5-haikuAnthropic Messages API
Google Geminihttps://generativelanguage.googleapis.com/v1betagemini-2.0-flash, gemini-1.5-proGemini generateContent
DeepSeekhttps://api.deepseek.com/v1deepseek-chat, deepseek-coder, deepseek-reasonerOpenAI-Compatible
Groqhttps://api.groq.com/openai/v1llama-3.3-70b-versatile, mixtral-8x7bOpenAI-Compatible
OpenRouterhttps://openrouter.ai/api/v1openai/gpt-4o-mini, anthropic/claude-3.5-sonnetOpenAI-Compatible
Custom EndpointUser specifiedUser definedOpenAI-Compatible

Dynamic Model Discovery

When configuring Cloud APIs, clicking the refresh button in Preferences queries the provider's models API in real-time to populate the latest available model options.

Native AI Result Card UI

When an AI action completes, the popup smoothly transitions into a native content card:

  • Processing Glow: An animated cyan-and-blue gradient border indicates active model generation.
  • Selectable Response Body: Fixed 120pt scrollable text view with native text selection.
  • Action Footers: Instant Paste (⏎) and Copy (⇧⏎) buttons.
  • Paste-Safe Fallback: If the destination application cannot accept paste (e.g. read-only previews), the Paste button is hidden and Return copies to clipboard.

Prompt Presets & XML Tag Stripping

OpenClip includes built-in presets: Proofread, Rewrite, Summarize, Explain, Translate, Fix Code, Make Shorter, and Formal Tone.

Prompts use a strict system instruction wrapping output inside <result>...</result> tags. OpenClip automatically parses and strips the enclosing XML tags, delivering clean transformed text.

Keychain Security & Key Management

macOS Keychain Storage

API keys are never stored in UserDefaults or plaintext files. They are encrypted in the macOS Keychain under service com.openclip.app with accessibility attribute kSecAttrAccessibleAfterFirstUnlock.