Introduction

AI-powered content generation and text editing for the Kirby Panel.

Kirby Copilot is a plugin for Kirby CMS that integrates AI features into your Kirby projects, letting you generate and refine content – from simple text to complex page layouts – directly from the Panel. This documentation guides you through the installation, configuration, and usage of the plugin.

Explore the interactive playground or install the plugin to try Kirby Copilot for yourself.

Features

Whether you are building sites for clients or managing content yourself, Kirby Copilot brings AI-assisted creation and editing to the Panel.

  • 🦙 Multi-Provider: Choose from leading AI providers – configure once and switch anytime.
  • 🧱 Structure-Aware Generation: Generate entire layouts from a single prompt, based on your project's unique block definitions.
  • Inline Suggestions: Ghost text appears after a brief pause. Press Tab to accept.
  • 📇 In-Context Editing: Use the Copilot button in writer/textarea fields to refine text. Works perfectly with selected text.
  • 🌞 Prompt Templates: Tailor AI responses with user instructions. Save frequently used prompts as templates.
  • 🎀 Rich Context: Use other fields, images, and PDF documents as context for relevant AI responses.
  • 🔒 Secure by Default: API keys are protected via server-side proxy – never exposed to Panel users.

Supported AI Providers

OpenAI

GPT-5 and GPT-5 Mini models for content generation.

Google

Gemini models. Recommended for blocks and layout generation. Free tier available!

Anthropic

Claude models for nuanced content generation.

Mistral

European AI models with multilingual strengths.

Choose Your Workflow

Kirby Copilot offers three ways to generate content. Choose the one that fits your use case:

MethodBest ForKey Features
View ButtonMulti-field generation, quick accessGenerate all fields at once from any Panel view
Toolbar ButtonsIn-field editing for writer and textarea fieldsAppend or replace text, work with selected text
Inline SuggestionsInline suggestions in writer fieldsTab to accept, ghost text preview
Copilot SectionDedicated workflowsSingle field focus, auto file context

The Panel view button is the easiest way to get started – add it to your blueprint and generate content for a single field or multiple fields at once.

View Button

With the copilot view button, you can access the prompt dialog from anywhere in the Panel. It is especially useful for generating content for multiple fields at once, but it works equally well for single fields.

Open the dialog, select the fields you want to generate content for, and let your AI assistant handle the rest.

Learn more about this workflow in the Panel View Button documentation.

Writer and Textarea Fields

Kirby Copilot integrates directly into writer and textarea fields with two complementary features:

Inline Suggestions appear as ghost text after a brief pause in typing – press Tab to accept or keep typing to dismiss. This feature is enabled by default for all writer fields.

Toolbar Buttons open the prompt dialog for more control. Select text before clicking to use it as context, then choose to replace or append the generated content.

Learn more in the Toolbar Buttons and Inline Suggestions documentation.

Blocks & Layout Generation

One of Kirby Copilot's key features is its ability to generate content for blocks and layout fields. This feature is especially useful for creating content for complex layouts such as landing pages, product pages, and blog posts.

Copilot discovers your project's custom block definitions and generates content based on their structure. No additional configuration is required.
Learn more about this feature in the Blocks & Layout Generation documentation.

Playground

Experience Kirby Copilot firsthand in the interactive playground.

To play with the plugin, please enter your API key in the playground settings. The playground uses client-side requests so you can transparently see your key in action. For production use, Kirby Copilot v3 routes all requests through a server-side proxy, keeping your API keys hidden from Panel users.

Get your API key:

Get Started

Ready to add AI-powered content generation to your Kirby project?

Installation Guide

Install the plugin, configure your AI provider, and start generating content in minutes.