Changelog

All of the changes to the Kirby Copilot plugin.

Where to Find the Latest Version?

If you have installed the plugin via Composer, you can update it by running the following command in your terminal:

composer update

If you have downloaded the plugin as a ZIP file, you can download the latest version from the releases page on GitHub.

What's New?

v2.9.0

December 6, 2025

๐Ÿš€ 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.

v2.8.1

November 30, 2025

๐Ÿž Bug Fixes

  • The userPrompt blueprint property for writer and textarea fields now works correctly in deeply nested field configurations.

v2.8.0

November 29, 2025

๐Ÿš€ 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.

v2.7.2

November 24, 2025

๐Ÿž Bug Fixes

  • Unset default temperature to allow AI providers to use their own defaults when no temperature is specified in the configuration.

v2.7.1

October 9, 2025

๐Ÿš€ 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:

Copilot Panel view button with custom icon

๐Ÿž Bug Fixes

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

v2.7.0

October 1, 2025

๐Ÿš€ 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:

Copilot Panel view button with custom theme

v2.6.0

July 15, 2025

๐Ÿš€ Features

  • New excludedBlocks global option for excluding specific block types from content generation.

v2.5.0

July 2, 2025

Another minor version release, but a major feature release!

๐Ÿš€ Features

Copilot Panel view button
  • 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.

v2.4.0

July 1, 2025

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.

v2.3.0

June 24, 2025

๐Ÿš€ Features

v2.2.4

March 4, 2025

๐Ÿš€ 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.

v2.2.0

December 29, 2024

๐Ÿš€ Features

  • Dedicated prompt history per Kirby installation (derived from hostname).

v2.1.0

December 23, 2024

๐Ÿš€ Features

  • Navigate through prompt history with arrow keys. See toolbar buttons to learn more.
  • Support bold, italic and code Markdown formatting in writer fields.

v2.0.0

December 19, 2024

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.

v1.8.0

July 10, 2024

๐Ÿš€ Features

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

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

v1.7.0

June 18, 2024

๐Ÿš€ Features

  • New license management that allows activating licenses directly in the Panel.
  • Deprecated the private Composer repository in favor of Packagist.

v1.6.1

June 1, 2024

๐Ÿš€ Features

  • Set gpt-4o as default OpenAI model.

v1.6.0

April 29, 2024

๐Ÿšจ 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.

v1.5.0

March 21, 2024

๐Ÿš€ Features

v1.4.0

February 21, 2024

๐Ÿš€ 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.

v1.3.0

January 27, 2024

๐Ÿš€ Features

  • Support adding PDF files to prompt โ€“ the text will be extracted from each PDF and appended to the prompt.

๐Ÿž Bug Fixes

  • Prefer .js plugin asset extension instead of .mjs for better hosting provider compatibility.

v1.2.0

January 26, 2024

๐ŸŽ Performance

  • Externalize ModelFusion library to the plugin's assets directory for smaller section component bundle size.

v1.1.0

January 24, 2024

This version marks the official release! ๐ŸŽ‰

๐Ÿš€ Features

  • Support Mistral AI models.

๐Ÿž Bug Fixes

  • Limit image context file types to PNG, JPEG, WEBP, and non-animated GIF.

v1.0.0

January 18, 2024

  • Initial internal release! ๐ŸŒˆ๐Ÿฆ„
  • Implemented the base of the section plugin.