Changelog

🚀 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 Fields as Context 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 (Kirby 5+ only). You can now configure the Copilot view button directly in your blueprints, overriding global defaults. Available options:
  • label – Custom button label (default: "Copilot")
  • userPrompt – Pre-filled prompt text that users can edit
  • systemPrompt – Hidden system instructions for the AI
  • theme – Visual appearance (blue-icon, positive, etc.)
  • logLevel – Debug level (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.
• Set o3-mini as default OpenAI model. Note that the o3-mini model does not support image input. To enable image input, set the model to gpt-4o in the provider model configuration
• 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

• 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 localStorage. Now, working with multiple Kirby projects keeps each site's prompt history isolated, making it easier to reuse site-specific prompts.

🚀 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.

To use Claude Sonnet models, add the configuration for the anthropic provider:

return [
    'johannschopplich.copilot' => [
        'provider' => 'anthropic',
        'providers' => [
            'anthropic' => [
                'apiKey' => 'YOUR_API_KEY',
                'model' => 'claude-sonnet-4-20250514'
            ]
        ]
    ]
];

🚀 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.

To update your configuration from Kirby Copilot v1.5 and earlier to the latest version, reduce the model configuration to only include the model name:

return [
    'johannschopplich.copilot' => [
        'providers' => [
            'openai' => [
-                'model' => [
-                    'default' => 'gpt-4-turbo-preview',
-                    'vision' => 'gpt-4-vision-preview'
-                ]
+                'model' => 'gpt-4-turbo'
            ]
        ]
    ]
];

🚀 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.