Inline Suggestions

Writer fields support AI-powered inline suggestions that appear as ghost text after a brief pause in typing. This feature is enabled by default for all writer fields – no configuration required.

Inline suggestions and the toolbar button complement each other: use inline suggestions for quick writing flow, and the toolbar button for generating or editing larger text blocks via the prompt dialog.

How It Works

After a brief pause in typing (1 second by default), Copilot analyzes your current text and suggests a completion. The suggestion appears as ghost text in a subtle gray color after your cursor. Press ⇥ (Tab) to accept it, Esc to dismiss it – or just keep typing.

fields:
  text:
    type: writer
    marks:
      - bold
      - italic
      # Append the Copilot toolbar button
      - copilot
      # Enable inline suggestions
      - copilot-suggestions

Keyboard Shortcuts

Completion Model

Inline suggestions use a dedicated lightweight model optimized for speed. Configure the completionModel per provider in your global configuration:

return [
    'johannschopplich.copilot' => [
        'provider' => 'google',
        'providers' => [
            'google' => [
                'apiKey' => env('GOOGLE_API_KEY'),
                'model' => 'gemini-3-pro-preview',
                 // Fast model for completions
                'completionModel' => 'gemini-3-flash-preview'
            ]
        ]
    ]
];

Disabling Inline Suggestions

To disable inline suggestions globally for all writer fields:

return [
    'johannschopplich.copilot' => [
        'completion' => false
    ]
];

Customizing Debounce Timing

The debounce controls how long Copilot waits after you stop typing before suggesting a completion. Customize the debounce duration (in milliseconds) in your configuration:

return [
    'johannschopplich.copilot' => [
        'completion' => [
            'debounce' => 1500 // Wait 1.5 seconds
        ]
    ]
];