Skip to content

Providers

The plugin ships with sixteen built-in providers. Five of them are enabled by default; the rest are off by default and can be opted into with a single line of config. This page lists every default and every field you can override.

The five providers that appear in the dropdown out of the box:

ProviderStrategyURL template
ChatGPTurl-prompthttps://chatgpt.com/?q={prompt}
Claudeclipboard-openhttps://claude.ai/new
Geminiclipboard-openhttps://gemini.google.com/app
GitHub Copiloturl-prompthttps://github.com/copilot?prompt={prompt}
Perplexityurl-prompthttps://www.perplexity.ai/?q={prompt}

These five are the largest providers by user base; the goal is to keep the default dropdown short and recognisable. To use any other provider, opt in explicitly (see Opting in to a provider).

ProviderDefaultStrategyURL templateNotes
ChatGPT✅ onurl-prompthttps://chatgpt.com/?q={prompt}Auto-submits
Claude✅ onclipboard-openhttps://claude.ai/newWeb prefill broken Oct 2025
Gemini✅ onclipboard-openhttps://gemini.google.com/appNo native prefill
GitHub Copilot✅ onurl-prompthttps://github.com/copilot?prompt={prompt}Officially documented
Perplexity✅ onurl-prompthttps://www.perplexity.ai/?q={prompt}
Google AI Studiooffurl-prompthttps://ai.studio/prompts/new_chat?prompt={prompt}
Cursoroffinline-contenthttps://cursor.com/link/prompt?text={prompt_with_markdown}8 KB cap, falls back to url-prompt
DeepSeekoffclipboard-openhttps://chat.deepseek.com/No prefill
DuckDuckGo AI Chatoffurl-prompthttps://duckduckgo.com/?q={prompt}&ia=chat&duckai=1
Grokoffurl-prompthttps://grok.com/?q={prompt}
HuggingChatoffclipboard-openhttps://huggingface.co/chat/No prefill
Kagi Assistantoffurl-prompthttps://kagi.com/assistant?q={prompt}Subscribers only
Mistral Le Chatoffclipboard-openhttps://chat.mistral.ai/chatNo prefill
Phindoffclipboard-openhttps://www.phind.com/agentNo prefill
T3 Chatoffurl-prompthttps://t3.chat/new?q={prompt}Path must be /new
You.comoffurl-prompthttps://you.com/search?q={prompt}

For why each provider uses its assigned strategy, see Concepts: per-provider strategies.

When configuring providers, use these exact ids:

  • aistudio — Google AI Studio
  • chatgpt
  • claude
  • copilot — GitHub Copilot
  • cursor
  • deepseek
  • duckduckgo
  • gemini
  • grok
  • huggingchat
  • kagi
  • mistral — Mistral Le Chat
  • perplexity
  • phind
  • t3chat
  • youcom — You.com

Default-off providers must be opted into explicitly. Pass true for the shortest form:

starlightLlmActions({
actions: {
openIn: {
providers: {
cursor: true,
t3chat: true,
kagi: true,
},
},
},
})

Or pass an override object — that also opts the provider in:

starlightLlmActions({
actions: {
openIn: {
providers: {
cursor: { maxBytes: 4000 },
},
},
},
})

Pass false for any provider — including default-on ones — to remove it from the submenu:

starlightLlmActions({
actions: {
openIn: {
providers: {
copilot: false,
gemini: false,
},
},
},
})

Pass a ProviderOverride object. Every field is optional; unset fields fall back to the built-in defaults.

starlightLlmActions({
actions: {
openIn: {
providers: {
chatgpt: {
label: 'ChatGPT (work account)',
description: 'Send the page to ChatGPT for summary',
prompt: 'Summarise the linked Acme docs page: {url}',
},
},
},
},
})

Cursor’s default maxBytes is 8000 (8 KB). To force the fallback for any page over 4 KB:

starlightLlmActions({
actions: {
openIn: {
providers: {
cursor: {
maxBytes: 4000,
fallbackStrategy: 'clipboard-open',
},
},
},
},
})

If a provider ships URL prefill in the future, you can switch its strategy without waiting for a plugin release:

starlightLlmActions({
actions: {
openIn: {
providers: {
claude: {
strategy: 'url-prompt',
url: 'https://claude.ai/?q={prompt}',
},
},
},
},
})

Provider icons are SVGs sourced from Simple Icons (CC0). To use official brand assets:

starlightLlmActions({
actions: {
openIn: {
providers: {
chatgpt: {
icon: 'https://example.com/openai-official.svg',
},
},
},
},
})

icon accepts:

  • An SVG filename under the package’s icons/ folder (e.g. 'chat-bubble.svg').
  • An absolute URL.
  • false — hide the icon.

A handful of providers (Google AI Studio, Grok, Phind, You.com) ship with the generic chat-bubble.svg because Simple Icons doesn’t carry an official mark for them. Override providers.<id>.icon if you have your own asset.

Each provider can use a different prompt:

starlightLlmActions({
prompt: 'Help me understand this page: {url}',
actions: {
openIn: {
providers: {
cursor: {
prompt: 'Use this docs context to scaffold an integration.',
},
chatgpt: {
prompt: 'Summarise in one paragraph: {url}',
},
},
},
},
})

{md_url} is substituted with the absolute URL of the current page’s .md route (preferred — gives LLMs clean markdown). {url} substitutes the rendered HTML URL instead. {prompt_with_markdown} in the URL template appends the page’s markdown body to the prompt — useful for inline-content providers.

Brand names (ChatGPT, Claude, Gemini, GitHub Copilot, Perplexity, Cursor, T3 Chat, Google AI Studio, DeepSeek, DuckDuckGo, Grok, HuggingChat, Kagi, Mistral, Phind, You.com) and marks remain trademarks of their respective owners and appear nominatively in the plugin only to identify the linked services. No endorsement is implied. The bundled icons are from Simple Icons under CC0; to use official brand assets, override providers.<id>.icon.