Changelog

🚀 Features

• Config-defined prompt templates: Predefine prompt templates in the Kirby config that appear for all Panel users. Templates support multilingual labels and prompts via language arrays. Config templates are read-only and displayed alongside user-created templates. See the Prompt Templates documentation.

return [
    'johannschopplich.copilot' => [
        'promptTemplates' => [
            [
                'label' => 'Apply House Style',
                'prompt' => 'Format the text according to our editorial style: artist names in bold, album titles in italics, use curly quotation marks.'
            ]
        ]
    ]
];

return [
    'johannschopplich.copilot' => [
        'promptTemplates' => [
            [
                'label' => [
                    'en' => 'Apply House Style',
                    'de' => 'Redaktionsstil anwenden'
                ],
                'prompt' => [
                    'en' => 'Format the text according to our editorial style: artist names in bold, album titles in italics, use curly quotation marks.',
                    'de' => 'Formatiere den Text nach unserem Redaktionsstil: Künstlernamen fett, Albumtitel kursiv, typografische Anführungszeichen verwenden.'
                ]
            ]
        ]
    ]
];

🚀 Features

• Dynamic API key resolution: The apiKey option now accepts closures for dynamic key resolution at runtime. The closure receives the Kirby instance as its first argument, enabling user-specific or context-dependent API keys. See the Global Configuration documentation.
• Localized prompt templates: Default prompt templates are now available in English, German, French, and Dutch. Templates are automatically selected based on the Panel user's language setting.

Kirby Copilot v3 is a free upgrade for all users with a valid license key for v2. This major release brings significant security improvements and powerful new features.

🔒 Security

• Server-side API proxy: All AI provider requests now route through a server-side proxy instead of direct client-side requests. Your API keys are no longer exposed in browser network requests, protecting them from Panel users.

🚀 Features

• Inline suggestions in writer fields with dedicated completionModel configuration per provider. Press Tab to accept AI suggestions, Escape to dismiss. Ghost text appears after a brief pause. Manually trigger with Cmd + , / Ctrl + ,. See the Inline Suggestions documentation.
• Global reasoningEffort configuration for all reasoning-capable models (GPT-5, Gemini 3, Claude 4). Controls the depth of reasoning during generation. See the Global Configuration documentation.
• Writer mark formatting preservation: Replacing selected text now preserves all formatting (bold, italic, links, etc.). Generation supports all Kirby writer built-in marks.
• Prompt preview: Expand the Preview section in the prompt dialog to see field placeholders replaced with their actual values before sending.
• Prompt templates: Save frequently used prompts as templates. Five built-in templates included (Fix Grammar, Make Concise, Simplify, Extend, Summarize). See the Prompt Dialog documentation.
• Enhanced prompt history: Access recent prompts via dropdown menu with arrow key navigation.

🚨 Breaking Changes

• The temperature option has been removed. Modern reasoning models (GPT-5, Gemini 3, Claude 4) manage creativity internally. Use reasoningEffort instead.

🚀 Features

• Native PDF parsing: PDF files are now sent directly to the AI provider, allowing models to understand document structure, formatting, and content natively. For files larger than 50 MB, the plugin automatically falls back to text extraction. See the Processing PDF Files documentation.
• New Insert field placeholder button in the prompt dialog. Click the dropdown to see all available fields from the current Kirby model and insert {fieldName} placeholders at the cursor position. See the Field Placeholders documentation.

🚀 Features

• Custom user prompts for writer and textarea fields. Define a userPrompt in your field configuration to pre-fill the Copilot dialog with context-specific instructions. Works with nested fields in blocks and layouts.

fields:
  text:
    type: writer
    marks:
      - copilot
    copilot:
      userPrompt: Check grammar and improve writing style. Keep the original meaning and tone.

🐞 Bug Fixes

• Temperature default handling: The plugin no longer sets a default temperature value, allowing AI providers to use their own optimal defaults. Previously, a hardcoded temperature could conflict with certain models (like reasoning models) that work best with provider defaults. If you want explicit control, you can still set temperature in your provider configuration.

🚀 Features

• New global Kirby Panel icon copilot-ai-generate.
• Customizable icon option for view buttons and sections.

For example, the view button with icon: copilot-ai-generate:

🐞 Bug Fixes

• Italic formatting and lists are formatted correctly when generating text with the Copilot writer mark.

🚀 Features

• Support reasoningEffort for OpenAI GPT-5 and GPT-5 Mini, replacing temperature for these models.
• Customizable Panel view button props. You can now configure the Copilot view button directly in your blueprints, overriding global defaults. Available options:
  • label – Custom label for the view button. The default depends on the Panel language.
  • userPrompt – Default user prompt that appears when the generation dialog opens. Users can edit the prompt before generating content.
  • systemPrompt – Custom system prompt that controls how the AI structures and formats the generated content. Users cannot see or edit this prompt.
  • theme – Controls the visual appearance and color theme of the button (e.g., blue-icon, positive, negative-icon).
  • logLevel – Set the logging level for debugging AI generation. Options: error, warn, info, debug.

For example, the view button with theme: blue-icon:

🚀 Features

• Block type exclusions: The new excludedBlocks global option lets you prevent specific block types from being generated by Copilot. This is useful when you have custom blocks that require manual content (e.g., embed blocks, form blocks) or blocks that should only be added by editors intentionally.

return [
    'johannschopplich.copilot' => [
        'excludedBlocks' => ['embed', 'form', 'code']
    ]
];

Another minor version release, but a major feature release!

🚀 Features

• New Panel view button to open the prompt dialog anywhere. You can select multiple fields and generate their content with a single prompt.
• Support object and entries fields for content generation.

Although a minor release, this is a major release in terms of features!

🚀 Features

• Structure-aware blocks generation that supports every project's block configuration and generates content based on your unique block definitions. See the Blocks & Layouts documentation.
• New content generation for layout fields.
• Support for Google Gemini models.

🚀 Features

• Kirby 5 license status integration: The plugin now displays its license status on the Panel's system page, following Kirby 5's plugin license management conventions. This provides a unified view of all plugin licenses alongside Kirby's own license information.

🚀 Features

• Enable image input for prompts when using an Anthropic model.
• Per-site prompt history: Prompt history is now stored separately for each Kirby installation, identified by hostname. Previously, all sites shared the same history in local storage. Now, working with multiple Kirby projects keeps each site's prompt history isolated, making it easier to reuse site-specific prompts.
• Pass all API errors to the Panel user interface for better error handling. This helps to catch issues, such as the following with the o3-mini model:

  Invalid content type. image_url is only supported by certain models.

🚀 Features

• Prompt history navigation: Use arrow keys (↑/↓) to navigate through your prompt history in the Copilot dialog. This makes it easy to reuse and modify previous prompts. See toolbar buttons for details.
• Markdown formatting in writer fields: Generated content now supports bold, italic, and code Markdown formatting when using writer fields. The AI output is automatically converted to the writer field's rich text format.

Kirby Copilot v2 is a major release with support for Kirby 5 and improvements across the board. This major release requires a new license key. If you already have a license, you receive either a free upgrade to v2 or a 50% discount on your new license. Head over to the Kirby Tools Hub to get your discount or read more in the license compatibility guide.

🚨 Breaking Changes

• New global system prompt to cover text generation for all fields. No need to manually configure prompts for response formatting anymore.

🚀 Features

• New toolbar buttons for writer and textarea fields.
• Support for Kirby 5.
• Many more improvements and bug fixes under the hood.

🚀 Features

• Support Anthropic Claude models.

🚀 Features

• Panel license activation: Activate and manage your license directly in the Kirby Panel without manual file editing. Click the activation link in the Copilot section to enter your license details. Visit the Kirby Tools Hub to purchase or manage licenses.
• Packagist distribution: The plugin is now available via Packagist, simplifying Composer-based installations. The private Composer repository has been deprecated.

🚀 Features

• GPT-4o as default model: The default OpenAI model is now gpt-4o, which combines strong reasoning capabilities with native vision support for image understanding. This model offers improved performance over GPT-4 Turbo at a lower cost. You can still configure a different model in the provider configuration.

🚨 Breaking Changes

As of April 2024, OpenAI has added vision capabilities to the GPT-4 Turbo model. Following this change, the configuration for the OpenAI provider has been simplified to only include the model name.

🚀 Features

• Migrate from ModelFusion to Vercel's AI SDK Core.
• Set gpt-4-turbo as default OpenAI model.

🚀 Features

• Dynamic prompts with Kirby queries: The userPrompt and systemPrompt section properties now support Kirby queries. This allows you to dynamically generate prompts based on page content, site settings, or other data. For example, use {{ page.title }} to include the page title in your prompt.

🚀 Features

• files: auto on a file model copilot section to automatically use the current file (image or PDF) as context source.
• logLevel section property, i.e. to debug system and user prompts.
• Provider option baseUrl to define the base URL of a custom Mistral API instance.

🚀 Features

• PDF context support: Add PDF files as context for AI prompts. Text content is extracted from each PDF and appended to the prompt, enabling AI generation based on document content. Configure PDF files using the files section property.

🐞 Bug Fixes

• Hosting compatibility: Changed plugin asset extension from .mjs to .js for better compatibility with hosting providers that do not serve .mjs files with the correct MIME type.

🏎 Performance

• Reduced bundle size: Externalized the ModelFusion library to the plugin's assets directory. This significantly reduces the initial Panel JavaScript bundle size, resulting in faster Panel loading times.

Official Release

This version marks the official public release of Kirby Copilot. The plugin is now available for purchase and production use.

🚀 Features

• Mistral AI support: Use Mistral AI models as an alternative to OpenAI. Configure the mistral provider in your global configuration with your API key.
• Image context: Add images as context for AI prompts to generate content based on visual input. Configure image files using the files section property.

🐞 Bug Fixes

• Image format restrictions: Limited image context file types to PNG, JPEG, WEBP, and non-animated GIF. These are the formats supported by vision-capable AI models. Animated GIFs and other image formats are not supported for context.

Initial Release

Kirby Copilot v1.0 brings AI-powered content generation directly to the Kirby Panel. Generate text content from prompts using OpenAI's GPT models.

🚀 Features

• Panel section: Add the Copilot section to any page blueprint to enable AI content generation. The section provides a prompt input field and generates content for your configured blueprint fields.
• OpenAI integration: Generate content using OpenAI GPT models. Configure your API key and preferred model in the global configuration.
• Customizable prompts: Define user prompts and system prompts to tailor AI responses for specific content types.
• Field targeting: Configure which field the generated content should populate using the field section property.

For setup instructions, see the Installation guide.