🚀 Features

• Blueprint guidance: Agents now read each field's help, placeholder, and when condition, and the text of info fields and info sections, as editors do. House rules you write there guide agents too. See What Agents Are Told.
• Plugin field types: A plugin can map its own field type to a core type, and agents and Copilot in the Panel then write it like that field. See Supported Field Types.
• Tools by role: An agent now sees every tool your role allows, and a tool its connection lacks answers with the permission it needs. When the agent asks for it, the consent view starts from the permissions you gave that agent's last connection.
• Paused connections: Admins now see the connections of users whose role may no longer connect agents, marked Role has no access, and can revoke them.

🐞 Bug Fixes

• Open Panel views: Typing in a page you have open no longer saves over what an agent wrote in the meantime. Clicking Save or Discard after an agent's write reloads the view first, so you see what would go live or be thrown away.

🚀 Features

• Edits inside a field: An agent now rewrites a single passage instead of the whole field – in a blocks or layout field, only inside the block that holds it. It also adds, moves, or removes single blocks and leaves the others untouched. See Tools.
• Finding open work: Agents now find the pages and files not yet translated into a language, and search files across the site, such as images without alt text. An agent that starts a new translation also learns which fields still hold the default language's text.
• Before publishing: An agent can now tell you what publishing a page would change. When it writes to a page that holds unsaved changes a colleague left, it tells you that too, since the Panel then shows them as yours. See Working Alongside an Agent.

🐞 Bug Fixes

• Values a field doesn't take: A write that Kirby would empty or cut short, such as an option a select doesn't have or a block type a field doesn't offer, is now refused, and the agent learns what the field takes. Before, the field ended up empty or held a block the site doesn't show.

🚀 Features

• Agents: An AI agent outside the Panel can now read your content and prepare changes to it. You approve each connection in the Panel, and the agent works as your Kirby user, within your role. By default, its edits wait as unsaved changes until you publish them. See Connect an Agent Over MCP.
• Agents view: A new Panel view shows the MCP URL you add to your agent and checks whether agents can reach your server. It lists your connections with their permissions and when each was last active, and lets you change a connection's permissions or revoke it. See Manage Connections.
• Connection permissions: Every connection can read; preparing, publishing, and deleting are yours to allow. Role blueprints can keep publishing and deleting out of agents' reach altogether. See Permissions & Review.
• An open page reloads: When an agent writes to a page you have open, the view reloads within 10 seconds and tells you why, so you see its changes without refreshing. See Working Alongside an Agent.

🐞 Bug Fixes

• Prompt dialog in the writer: Opening the prompt dialog from the writer while text is selected no longer crashes the browser tab in Chromium-based browsers.

🐞 Bug Fixes

• No generation into content you can't edit: While someone else is editing a page, or you lack permission to update it, the view button and the Copilot section are disabled instead of starting a run.

🔄 Updated Default Models

🚀 Features

• Request timeout for PHP runs: A new per-provider timeout option bounds every request the Client class makes, defaulting to 120 seconds. A stalled connection used to block the script indefinitely.

🐞 Bug Fixes

• Bounded retry delay: When an OpenAI-family provider asks for a pause with Retry-After, the retry now waits at most one minute instead of however long it asked. See the OpenAI provider reference.
• Structured responses without content: An OpenAI-family response with no content made Client::generateObject() fail with an error that slipped past a ProviderException handler. It now throws a ProviderException, like any other provider failure.

🚀 Features

• Config validation for skills and prompt templates: With Kirby's debug option on, a malformed skills or promptTemplates entry – and two skills sharing an id – now throw instead of failing silently. See the exceptions reference.

🐞 Bug Fixes

• Failed generations report the failure: A run that fails now shows the provider's message instead of the success notification, and leaves the incomplete result unsaved.
• Inline suggestions follow your typing: Only your own keystrokes start an inline suggestion – text from a generation run, an undo, or a redo no longer does. A provider that just failed is left alone for half a minute, and a superseded request stays cancelable.
• Skills in programmatic prompts: Skill mentions resolve in every generation run, not just after the prompt dialog has been opened. See the skills documentation.
• Unresolved mentions: An unknown skill ID or an unreadable page reference now names itself in a browser console warning instead of vanishing silently.

🚀 Features

• Kirby queries in the view button: userPrompt and systemPrompt now resolve Kirby queries for the view button, not just for the section. A prompt like {{ page.customPrompt.value }} follows the content instead of reaching the model verbatim.

🐞 Bug Fixes

• Unresolvable page references: A page reference that no longer resolves is skipped instead of failing the whole generation.

🚀 Features

• Expanded reasoningEffort options: New provider-default, minimal, and xhigh levels join the existing none / low / medium / high. Configure the effort once – it works across all reasoning-capable OpenAI, Google, Anthropic, and Mistral models. See the Global Configuration documentation.

🔄 Updated Default Models

🚀 Features

• PHP classes: Generate text and structured JSON from any PHP context – no Panel required. See the PHP classes documentation.
• Client::generateObject(): Generate JSON objects conforming to a JSON Schema across all supported providers with a single API. See the client reference.
• ProviderException: Every upstream provider failure surfaces as one dedicated exception class. See the exceptions documentation.

🚀 Features

• Skills: Define reusable prompt instructions – tone, style, or house rules – in your Kirby config. Editors add them to a prompt with an @skill://id mention from the new typeahead dropdown. See the skills documentation and the skills config reference.

🚀 Features

• Chat Completions mode for OpenAI-compatible gateways: Set providers.openai.api to chat for endpoints that don't expose the Responses API. This unlocks Cloudflare AI Gateway's Unified API – route Gemini, Claude, and more through a single endpoint via the OpenAI SDK shape. See the global configuration documentation.

🔒 Security

• Proxy target allowlist: The proxy now restricts upstream requests to known AI provider hosts plus any configured baseUrl. Prevents authenticated Panel users from redirecting traffic to attacker-controlled hosts.
• Scoped API key forwarding: API keys are now only injected into authentication headers. Prevents a Panel user from exfiltrating the key via other forwarded headers.

🐞 Bug Fixes

• Proxy error handling: Upstream provider errors and network failures now surface to the Panel with proper status codes and messages instead of a silent empty stream.

🔄 Updated Default Models

🚀 Features

• Page references: Reference other Kirby pages in your prompt with @page://page-id to include their content as context for the AI. Insert pages via the toolbar dropdown or type the syntax manually. See the page references documentation for details.
• Syntax highlighting: The prompt editor now highlights {placeholder} tokens and @page:// references with distinct colors for better readability.

🐞 Bug Fixes

• Custom field types no longer block generation: A custom field type that extends a standard one, such as 'extends' => 'text', stopped generation with an "Unsupported field type" error. Copilot now generates content for it, and skips a field type it cannot fill instead of failing. (#8)

🔄 Updated Default Models

🚀 Features

• Block descriptions: Custom block blueprints now support an optional description key that is passed to the AI schema, giving the model richer context about each block's purpose. See the Blocks & Layouts documentation.
• Nested blocks support: A custom block with its own type: blocks field – blocks within blocks – now gets content for its nested blocks too, one level deep. See the Blocks & Layouts documentation.

🚀 Features

• System view license management: View your license key, activation status, and version compatibility directly in the Kirby Panel system view, and activate a new license from there.

🐞 Bug Fixes

• Inline Suggestions trigger: Suggestions will now reliably appear only when the writer field is in focus.

🚀 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 a closure, so the key can depend on the current user or other context at runtime. 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.

🔒 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: Writer fields show a suggested continuation as ghost text after a brief pause in typing, or on Cmd + , / Ctrl + ,. Press Tab to accept it or Escape to dismiss it. Suggestions run on a separate, faster model, set per provider as completionModel. See the Inline Suggestions documentation.
• Global reasoningEffort: One option controls how deeply every reasoning-capable model (GPT-5, Gemini 3, Claude 4) reasons 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

• Temperature removal: 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.
• Insert field placeholder: A new button in the prompt dialog lists the fields of the current page, file, or site and inserts a {fieldName} placeholder at the cursor. See the Field Placeholders documentation.

🚀 Features

• Custom user prompts: Define a userPrompt on a writer or textarea field to pre-fill its Copilot dialog with instructions for that field. Works with nested fields in blocks and layouts.

🚀 Features

• Reasoning effort support: Support reasoningEffort for OpenAI GPT-5 and GPT-5 Mini, replacing temperature for these models.
• Customizable view button props: Configure the Copilot view button in your blueprints, overriding the global defaults. Set its label, theme, and logLevel, pre-fill the dialog with a userPrompt, or steer the output with a systemPrompt that editors never see.

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']
    ]
];

🚀 Features

• 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.
• Object and entries fields: Support object and entries fields for content generation.

🚀 Features

• Structure-aware blocks generation: Supports every project's block configuration and generates content based on your unique block definitions. See the Blocks & Layouts documentation.
• Layout fields: Content generation for layout fields.
• Google Gemini: Added Google Gemini models as supported AI provider.

🚀 Features

• Kirby 5 license status integration: The plugin now displays its license status on the Panel's system page, alongside Kirby's own license, following Kirby 5's plugin license management conventions.

🚀 Features

• Anthropic image input: Enable image input for prompts when using an Anthropic model.
• Per-site prompt history: Prompt history is stored per hostname in the browser's local storage.
• API error handling: Pass all API errors to the Panel user interface for better error handling.

🚀 Features

• Prompt history navigation: Use the arrow keys (↑/↓) in the Copilot dialog to step through your earlier prompts. See prompt history.
• 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 full support for Kirby 5 and 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

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

🚀 Features

• Toolbar buttons: New toolbar buttons for writer and textarea fields.
• Kirby 5: Full compatibility with Kirby 5 including the new Panel architecture.

🚀 Features

• Anthropic Claude: Added Anthropic Claude models as supported AI provider.

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

🚨 Breaking Changes

• OpenAI model configuration: The OpenAI provider takes only the model name.

🚀 Features

• Dynamic prompts with Kirby queries: The userPrompt and systemPrompt section properties now resolve Kirby queries, so {{ page.title }} puts the page title into the prompt.

🚀 Features

• Automatic file context: files: auto on a file model copilot section to automatically use the current file (image or PDF) as context source.
• Debug logging: logLevel section property to debug system and user prompts.
• Custom API base URL: 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: Some hosts serve .mjs files with the wrong MIME type, so the browser refused to load Copilot's AI library and generation failed. The plugin now ships its scripts as .js.

🏎 Performance

• Reduced bundle size: A smaller initial Panel bundle loads the Panel faster.

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: The file picker offered every image type, including ones vision-capable models reject. It now accepts only PNG, JPEG, WEBP, and GIF, though the models do not support animated GIFs.

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.