Skip to content

Changelog

Statamic

1.3.0

16 October 2026

Suggest edits and Content to revisit, which find what has gone stale on your published pages and help you fix it; a live preview of every draft through your own templates, with other layouts to choose from and comments you pin on the page; drafts that arrive linked to your other pages, with a search title and description; and Connections, one place to set up every key. Requires 1994/ghostwriter-core ^1.10, Statamic 6.30 or later and PHP 8.3 or later.

Added

  • Suggest edits, in the menu beside Edit with Ghostwriter on an existing entry. Free checks look for candidates: a past year written as current ("New for 2024"), "this year" on an old page, a count or claim about you that may have changed ("our team of 6"), a sentence that runs on, a link to a deleted page, an image with no alt text, SEO text over its limit or missing, a heading over 70 characters, and a long page with no links to your other pages. A confirm says what the review costs before anything is sent. The review keeps a candidate only if it's a real problem in its paragraph, adds its own suggestions for voice and clarity, and a second call checks every suggestion again before you see it. The guide shows each change in its sentence, with the reason and where it comes from, and Accept, Edit, Another version, It's still right and Dismiss, with Undo; category filters; Accept all wording fixes; links to your other pages; and alt text saved to the image, after a confirm that says how many pages use it. Accepted words go into the form; nothing is saved but alt text. Decisions are shared and remembered. See Suggest edits.
  • Content to revisit (Ghostwriter → Content to revisit, and a tile on the Overview): every published page in the collections Ghostwriter writes for, ranked by free checks (no AI): past years written as current, a closing date that has passed, broken links, images without alt text, empty fields that pages like it fill, unfinished markers, SEO text over its limit, no SEO description, no links to your other pages, heading levels, and age. Tiles filter the list; Review opens a page with Suggest edits ready to run; Snooze for 90 days; a collection filter. Only the collections you can view are listed. It's kept up to date as entries are saved and deleted, and by php please ghostwriter:revisit, which runs daily at 03:00 on Laravel's scheduler (a full pass weekly).
  • A weekly check of links to other sites, off by default. Turned on in settings, it runs on Sundays at 04:00: each address at most once a week, one request a second per site, and a link counts as broken after two failed checks in a row.
  • Three settings, under Suggest edits and Content to revisit: Check claims and counts (on), Check links to other sites once a week (off) and Count age in full in these dated collections (none). Each can be set in config/ghostwriter.php instead (suggest.claims, revisit.external_links, revisit.age_in_full).
  • The Preview tab. The draft now has three tabs, Preview | Blocks | Text. Preview shows the unsaved draft rendered through your site's own templates, at Desktop or Phone width, and renders again as the draft changes. Hovering outlines each block with its name. Nothing is saved to show it. A template that fails says why, with Show blocks instead and Try again. Preview pages get headers that keep them private and out of search engines and block third-party scripts. Templates can test {{ live_preview:ghostwriter }} to leave things out of Ghostwriter's previews. New config: preview.enabled, preview.script_hosts, preview.timeout. See The Preview tab.
  • Layouts. With a first draft, Ghostwriter offers up to two other layouts of the same words, ranked against your collection's own pages, with the most like them marked Suggested. They show as a row of names above the draft; Compare layouts shows them as cards with a thumbnail of each page. Each says what it changes ("Quote moved up · Text blocks joined"), and choosing one scrolls to and outlines what changed. Only layouts that really differ are offered. The choice is shared with everyone on the piece. See Layouts.
  • Extras. The writer prepares stats, FAQs, a pull quote and the like, only for the block types your blueprint has and only from what you gave it. The Text tab lists each with where it came from, and every part can be edited or deleted. See Extras.
  • Comments on the page. Turn on Comment above the Preview (Alt+Shift+C), click a block or select words, and write a comment. Comments stay yours, in your browser, until you Apply them: one call revises only the commented blocks, and the reply says what happened to each (Changed, with Before / after and Put it back; Replied; Not applied; or Skipped because someone else changed the block). Comments can be resolved and reopened, follow their words between layouts, and work by keyboard. See Comments.
  • Gaps as chips in the draft. In the Preview and the Text tab, a fact to add, a count to check and a link to choose show as small chips instead of raw markers. Click one to deal with it there: type the fact, confirm or change the count, or choose the page to link to. Under plain text fields on the publish form, a row of chips names each gap as you type. The saved entry keeps its markers until they're dealt with.
  • Questions before a draft, one box each. When Ghostwriter needs to ask, it lists at most four short questions, each with its own box (or choices), (optional) where it is, and Skip. Send answers, or Just draft it with what you have.
  • Model it on picks entries for you. In a collection with no learned kind, the brief now arrives with up to six published entries ticked, the closest in purpose and shape to the new piece. Your own ticks always win.
  • Links to your other pages in every first draft. Ghostwriter links a new draft to the most relevant pages of your site (about one link per 250 words, two to five), and a second call checks each one. Links Ghostwriter added are marked in the Text and Blocks tabs, where you can see where each goes and Remove link. Every routed collection and taxonomy term page can be linked to; drafts, noindex pages, utility pages and other sites never are.
  • Suggest links in Finish this page: Link to your other pages finds pages to link to on the page as it stands, in the background, and offers each as a step: "Link “…” to Contact us?", Link it or Skip.
  • A search title, description and address with the first draft. Ghostwriter writes the page's SEO description, and a search title when the page title is too long, from what the page says. They're in a Search section at the end of the Text tab, editable, with a live character count and Try again. Use this draft puts them into SEO Pro or your plain SEO fields, never over text someone wrote, and fills the slug on a new or unpublished entry. Photo file names are made from the alt text.
  • Headings fit your template. Drafts start at H2 under the page's H1, never skip a level, and use only the heading levels each Bard field allows. The Preview reads how your template prints headings, and super users see a note on the Overview when a template prints no H1, or several.
  • Finish this page gains: - counts to check: a number Ghostwriter counted from a list you gave ("3 areas") is a step, with Looks right, Change it and Remove it, and blocks publishing like a fact to add; - Shorten a heading for a heading over 70 characters (Write it for me, one small call); - Link to your other pages on a page of 300 words or more with no links to your site; - Add a description for search when the SEO description is empty or too short; - a prompt for an image the page looks like it needs (required, the hero, or one most pages in the collection have).

These suggestions never block publishing, except counts to check.

  • Connections (Tools → Ghostwriter → Connections), for managers: a card for every service Ghostwriter uses, under Writing (Anthropic, OpenAI, Gemini, OpenRouter), Images (Unsplash, Pexels, Pixabay, Openverse) and Stock photos (Shutterstock). Set up opens the page where the key is made and takes you through it; Check & save tests the key with one small call before keeping it. Each card says whether it's connected (showing only the key's last four characters), set in .env, or has stopped working, with Replace key and Disconnect. Connect with OpenRouter and Shutterstock's Connect account are on their cards. A key in .env or config always wins. See Connections.
  • Keys set up in Connections are encrypted with APP_KEY, in a new ghostwriter_credentials table (php artisan migrate), or in an encrypted file without a database. If APP_KEY changes, set them up again.
  • A per-person limit on starting work that calls a model: 30 a minute by default (rate_limit, or GHOSTWRITER_RATE_LIMIT; 0 turns it off).
  • German, French, Dutch and Spanish for the new SEO and Connections wording.

Changed

  • The publish guard only acts on what an editor publishes in the Control Panel. Saves from console commands, imports, queued jobs and other addons are never refused. In collections Ghostwriter doesn't write for, it holds back only a stock photo previewed but not licensed, so an old link to a deleted page no longer stops a save there.
  • Ghostwriter only reads entries you can view. Learning or suggesting kinds, writing for a collection, and the entries listed under Model it on need Statamic's permission to view that collection's entries; collections you can't view aren't offered.
  • Remove preview on the stock images list needs permission to delete assets in the preview's container.
  • When a draft's preview fails, only people signed in to use Ghostwriter see the error's details; anyone else with the link sees a plain line.
  • One menu beside Edit with Ghostwriter. The "things to finish" and "suggestions" pills are replaced by one count on a menu holding Finish this page, Review suggestions and Suggest edits.
  • The writing panel works at every width. Below about 900 px the conversation and the draft are one column, with Conversation | Draft at the top, and nothing in the panel covers anything else. The draft scrolls as one page.
  • The writer keeps its own links to real pages instead of turning them into links to choose. For a link it couldn't place, Finish this page suggests the page it most likely means first.
  • Better link suggestions: pages are matched by word stems in English, German, French, Dutch and Spanish ("seed" meets "seedheads"), rare words count for more, key pages are always considered, and pages that link to each other or share a category rank higher.
  • Finish this page leaves required fields to Statamic's own validation; an empty required field is no longer a step.
  • Addresses keep the whole title ("what-to-do-in-the-garden-in-march"); only a title over about 60 characters loses its little words.
  • Suggest edits shows only what to act on, never how many things were found fine.
  • Settings' API keys section is now a summary linking to Connections. The OpenRouter key and Shutterstock account move into Connections by themselves, and their old files are removed.

Fixed

  • Editing an entry in conversation keeps the sets in its Bard fields (images, stats and the like) instead of dropping them.
  • Ghostwriter's note to the writer when editing an entry no longer shows in the conversation as if you'd sent it.
  • SEO Pro descriptions and titles are read as SEO Pro prints them: the entry, then the collection's defaults, then the site's, including @seo: fields, Bard sources and noindex.
  • An entry removed without an event (its file deleted, a deploy) is forgotten by the weekly pass.
  • "1 thing still to finish" always opens onto that thing.
  • A link to choose whose hint has a space is listed in Finish this page.
  • The guide's mark points at the words, not the field, and its words never cover the page's text or run off the window. Long button labels are cut short inside the card.
  • Suggest edits' spinner sits beside its words.
  • Teach a kind's name box is labelled for screen readers.

Removed

  • The Images section under a draft. Use this draft still puts a placeholder in each empty image field, and Finish this page turns each into a step with Find a photo and Choose from Assets. Asking for images in the conversation still works.

Upgrading

bash composer update 1994/ghostwriter-statamic 1994/ghostwriter-core php artisan vendor:publish --tag=ghostwriter-statamic --force php artisan migrate php artisan ghostwriter:revisit --full php artisan queue:restart

  • migrate makes the ghostwriter_credentials table for Connections. Without a database, skip it: keys are kept in an encrypted file.
  • Keys in .env keep working. The OpenRouter key and Shutterstock account move into Connections by themselves.
  • ghostwriter:revisit --full builds Content to revisit and the link index straight away; otherwise they fill in over the daily pass. Make sure Laravel's scheduler runs (php artisan schedule:run every minute).
  • See Upgrading from 1.2 to 1.3.

1.2.0

3 October 2026

Requires 1994/ghostwriter-core ^1.6.1, which no longer brackets quoted titles or figures you gave in a filled-in brief.

Requires 1994/ghostwriter-core 1.6.

Added

  • OpenRouter, a fourth provider. Choose OpenRouter under Settings → AI provider to write (and make images) with Claude, GPT, Gemini and others through one OpenRouter account, paid for with OpenRouter credit. Connect with OpenRouter signs in and comes back with a key, kept encrypted in storage/ghostwriter/provider-keys.json; or set OPENROUTER_API_KEY in .env, which always wins. The settings row offers Connect, Disconnect and Check connection (the credit left), a model for writing and one for quick jobs (openrouter.models.* in the config), and says that requests pass through OpenRouter. Only people who may change the settings can connect. See API keys.

Changed

  • The brief is in the conversation. The brief screen is gone. Once you've chosen what you're writing, Ghostwriter asks for the quick details in one message ("What’s it called, and what should it say? A line or two is plenty."), fills in the kind's whole brief from your reply with one model call, and shows it as a brief card: the working title, every question with its answer and Model it on, all editable. Looks right, start writing stores the brief on the piece and starts writing; Try again fills it in again, keeping the answers you changed. Anything only you know stays in [square brackets] (they become gaps in the draft for Finish this page); figures and quotes you didn't give are never filled in. The writing then goes on as before, and the agreed card collapses to Show the brief, still editable (Save the brief runs no turn). Draft this on the content plan skips the question: the card arrives filled in from the idea. Pieces carried on and shared conversations show the card in the thread; pieces started before keep their brief behind Show the brief. The card is a labelled region, its arrival is announced to screen readers and takes the keyboard to it, and spinners stand still under reduced motion. A kind looked at and left keeps nothing: the piece is saved once you send the details. See Writing a new entry.
  • Core's reworded gap messages ("Only you know this") come from core; the addon's own copy of them is gone.

Removed

  • The brief screen's Fill in the brief and its route (types/{type}/brief). POST types/{type}/sessions now opens a piece (with details or idea) instead of taking the answers.

1.1.1

3 October 2026

Fixed

  • Finish this page: Link to … on a Link field (in URL mode, holding #gw-link:) set the form's value but the field kept showing the old address. It now switches the field to Entry with the entry showing, through the field's own meta, and the value is entry::<id>.
  • Choose an entry on such a Link field only focused it. It now switches the field to Entry and opens its entry selector; cancelling puts the field back to URL and the link to choose. On a link inside Bard it opens Bard's own link editor on the link's words.
  • A fix counts as done only when the field's value really changed, read back from the form; the guide no longer moves on otherwise.
  • The guide and the flying mark step out of the way while a selector or dialog (entry picker, asset browser, License & replace) is open.
  • Remove it leaves no stray space where the text was.

1.1.0

3 October 2026

Stock photos from paid libraries, licensed from your own account; Finish this page, which marks what only a person can finish and walks you through it; and drafts that start unpublished. Requires 1994/ghostwriter-core 1.4. Statamic 6.30 or later and PHP 8.3 or later, as before.

Added

  • Finish this page. Ghostwriter never makes up a fact: where a draft needs a price, a date, a name or a quote it wasn't given, it writes [[ask: adult ticket price]], and a link it can't place points at #gw-link:contact-page. On any entry in a collection Ghostwriter writes for, whoever wrote it, the form then shows: - a count beside Save ("5 things to finish", then "Ready to publish"); - highlighted fields (amber to do, indigo current, green fixed) with a numbered tag beside each field's name, and the markers underlined inside Bard; - a guide that steps through each gap: an answer box for a fact, Link to … (an entry whose title or slug matches), Find a photo, Choose from Assets, Leave it empty, License (the stock photos License & replace), and, each one small model call, Write around it and Write it for me. Ghostwriter never fills in a fact. Fixes go into the form; nothing is saved until you save; - the Ghostwriter mark flying to the field, and the guide tucking into a corner button with a count, all still under reduced motion; - Alt+Shift+N / P / G, a live region and labelled tags for keyboard and screen-reader users; dark mode; a bottom sheet on phones. It's checked as you type, for nothing (no model, no save), remembered per person (it starts tucked away) and opens after Use this draft (finish.open_after_draft). See Finish this page.
  • Stock photos from paid libraries, licensed from your own account with your own keys. See Stock photos. - Shutterstock (API plan required). Set SHUTTERSTOCK_API_KEY and SHUTTERSTOCK_API_SECRET, then Connect account on the settings screen. Its own watermarked previews are shown; nothing is stored. On a local site its sandbox is used. Getty Images and iStock are coming: their keys can be set now. - Demo stock (no charge) to try the whole flow on a local site, never in production. - Search in (free libraries, a paid library or everything), cost and Editorial chips, and Include editorial images with a short explanation, offered only for libraries that have editorial images. - Insert preview: a labelled stand-in in the field, the watermarked comp kept privately for signed-in editors (and shown to them in Live Preview), and a Preview · not licensed badge. - License & replace: the options, what it uses from your account and the credit line, then the licensed original swapped in byte for byte, keeping alt text, title and focal point. Never bought twice. - A stock image ledger (one YAML file per photo in content/ghostwriter/stock/, made when first needed), a Stock images screen with a CSV export, a Stock photo panel in the asset editor, and ghostwriter:stock-cleanup hourly on the scheduler. - A License stock images permission, given to nobody by default (super users have it), as licensing spends from the site's account.
  • A "Finish this page" section on the settings screen: When a page with something unfinished is published, Block (default) or Warn.
  • Continuous integration: PHPUnit and Pint on PHP 8.3 and 8.4 against the lowest and newest dependencies, and the guide's logic on Node.

Changed

  • One publish guard. A page can't be published, scheduled or have its working copy published while it holds a fact to add, a link to choose or to a deleted entry, an image placeholder, template text left in, or a stock preview not licensed. One message per field ("Add adult ticket price before publishing."); saving unpublished always works. publish.on_unfinished (GHOSTWRITER_ON_UNFINISHED_PUBLISH) or the settings screen can make it a warning; stock.on_publish is still read when it isn't set.
  • Drafts start unpublished. Use this draft on a new or unpublished entry switches the form's Published toggle off (drafts_unpublished, default true). A published entry is left as it is.
  • After Use this draft, image placeholders and links still to choose are Finish this page's steps, not lines in the notes notice.
  • Images from a paid library, and any file named or credited as Getty Images or iStock, are never sent to a model.
  • Requires 1994/ghostwriter-core 1.4 (was 1.0).

Fixed

  • A link a new page usually has, but whose target the examples didn't agree on, pointed at https://example.com, a real address if published. It now points at #gw-link:<hint>, a place on the same page, and publishing waits until it's chosen.

1.0.1

2 October 2026

Changed

  • The image button on assets fields is easier to spot: it now reads Find a photo beside the ghost, at the size of the field's own controls, instead of a 10px icon.
  • Requires Statamic 6.30 or later (was ^6.0). The settings screen relies on an API added in 6.30, so earlier 6.x releases failed when the addon booted. Tested on 6.30 with Laravel 12.40, and on 6.35 with Laravel 13.
  • Requires guzzlehttp/psr7 2.6 or later, which the connection to the providers already needed; an older lock could have resolved 1.x.

Fixed

  • On a phone, the writing panel no longer runs off the side of the screen: the conversation and the draft stack and fit the width, the draft's buttons wrap, and image choices under a draft stack above their controls.
  • On a phone, Write with Ghostwriter / Edit with Ghostwriter shows as the ghost alone, so Save & Publish keeps its shape beside it.

1.0.0

2 October 2026

First release. Ghostwriter learns how your site writes and what its pictures look like, then drafts new entries and edits existing ones in that voice, in a panel beside the entry form. Get started walks through setup, the Overview shows what is in progress, and a widget sits on the Control Panel's dashboard.

Writing

  • Write with Ghostwriter on a collection's Create Entry screen, its entry list, the Overview, the widget and the content plan.
  • Choose a kind you taught it, something like what is already here, or a general brief that works on every collection with no setup.
  • The brief: answer its questions, or give a working title and notes and have it fill them in. Model it on up to six entries.
  • A follow-up conversation: Ghostwriter asks at most three questions when it needs facts only you know, then takes changes in plain words. It never invents figures, quotes or client names.
  • The draft in Blocks and Text views. Click any writing (or Tab to it) to change it in place; Edit YAML for the whole draft.
  • Use this draft fills the form, to check and save. Nothing is published for you.
  • Edit with Ghostwriter on an existing entry changes its writing in conversation, keeping images, links and settings.
  • Text, Bard, Markdown, Replicator, Grid and Group fields, with sets written to the collection's usual shape.

Learning the site

  • Voice guide, written from your published entries, edited by hand or by asking for a change.
  • Image style guide, written from the images your entries use, a section per collection.
  • Kinds of content: suggested per collection with examples and why each is worth teaching, learned on request, or taught by hand with their own questions, guidance, checklist and examples.
  • Guides, kinds and the plan are files in your project, to commit with it.

House style

  • New entries copy what your entries agree on: block settings, links, nested items and how rich text is dressed.

Images

  • A Ghostwriter button on every assets field: Find a photo on Openverse, Unsplash, Pexels and Pixabay, ranked by the model against the page's words and the images already in that place, with a second round of searches when nothing fits.
  • Found photos are named, titled and given alt text from the library's description, with the credit and licence saved on the asset.
  • Make the picture with OpenAI or Gemini, in the style of the images already there, optionally with your own image in it.
  • Photos offered for every image field under a draft, and striped placeholders where a new entry is still missing an image (Mark images still to choose).

Content plan

  • Ideas for entries each collection is missing, reviewed before they join the plan, optionally steered. A new batch joins any still waiting. Draft this opens a new entry with the brief filled in.
  • A piece started from the plan shows its stage there; Back to ideas returns one not yet saved to the plan, and Put back returns a dismissed idea.

Teams

  • Conversations are shared with everyone who may use Ghostwriter, showing who sent each message and who started and last changed each piece. Turn this off with shared_conversations.
  • One permission, Write content and edit the voice guide with Ghostwriter. Putting a draft or image into an entry needs Statamic's own permission to do so by hand. Super users and those who may edit the addon's settings manage Ghostwriter.

Providers

  • Writing with Anthropic (Claude), OpenAI (ChatGPT) or Google (Gemini); images with OpenAI or Gemini. Defaults: claude-opus-5-5, gpt-6.1-sol and gemini-3.8-flash for writing; gpt-image-2.5-sunburst and gemini-3.1-flash-image for images.
  • Keys are read from .env (ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY) and never stored or shown.
  • base_urls for a gateway or proxy that speaks a provider's own API.
  • A busy or rate-limited provider is tried again, up to three attempts in all, following its retry-after.
  • A reply cut off at its length limit is asked for once more with twice the room; a draft or the voice guide is never saved half-written.
  • Each call is logged with the provider, model, tokens and time, never the words.

Requirements

  • PHP 8.3 or later, with GD; Statamic 6.
  • An API key for Anthropic, OpenAI or Gemini.
  • A queue worker (--timeout=960), or PHP-FPM on the sync queue.
  • Work whose worker was stopped before it finished (a time limit, a restart) shows as failed once its job can no longer be running, ready to try again. This holds for conversations, the plan, the guides, kinds and images.

Craft CMS

1.3.0

16 October 2026

Suggest edits and Content to revisit, which find what has gone stale on your live pages and help you fix it; a live preview of every draft through your own templates, with other layouts to choose from and comments you pin on the page; drafts that arrive linked to your other pages, with a search title and description; and Connections, one place to set up every key. Requires 1994/ghostwriter-core ^1.10.

Added

  • Suggest edits, in the Ghostwriter menu beside Edit with Ghostwriter on an existing entry. Free checks look for candidates: a past year written as current ("New for 2024"), "this year" on an old page, a count or claim about you that may have changed ("our team of 6"), a sentence that runs on, a link to a deleted entry, an image with no alt text, SEO text over its limit or missing, a heading over 70 characters, and a long page with no links to your other pages. A confirm says what the review costs before anything is sent. The review keeps a candidate only if it's a real problem in its paragraph, adds its own suggestions for voice and clarity, and a second call checks every suggestion again before you see it. The guide shows each change in its sentence, with the reason and where it comes from, and Accept, Edit, Another version, It's still right and Dismiss, with Undo; category filters; Accept all wording fixes; links to your other pages; and alt text saved to the image, after a confirm that says how many pages use it. Accepted words go into your draft; nothing is saved but alt text. Entries nested in CKEditor fields are read and edited too. Decisions are shared and remembered. See Suggest edits.
  • Content to revisit (Ghostwriter → Content to revisit, and a tile on the Overview): every live page in the sections Ghostwriter writes for, ranked by free checks (no AI): past years written as current, a closing date that has passed, links to deleted entries or assets, images without alt text, empty fields that pages like it fill, unfinished markers, SEO text over its limit, no SEO description, no links to your other pages, heading levels, and age. Tiles filter the list; Review opens a page with Suggest edits ready to run; Snooze for 90 days; a section filter and a site switcher. Only the sections you can view are listed. It's kept up to date as entries are saved and deleted, and by php craft ghostwriter/revisit/refresh, the daily pass, from cron (a full pass weekly). Without cron, Craft's garbage collection runs it once it's over a day old.
  • A weekly check of links to other sites, off by default: php craft ghostwriter/revisit/check-links does nothing unless an admin turns it on. Each address at most once a week, one request a second per site, and a link counts as broken after two failed checks in a row.
  • Three settings, under Suggest edits and Content to revisit: Check claims (on), Check links to other sites once a week (off) and Dated sections where age counts in full (none). Each can be set in config/ghostwriter.php instead (claimChecks, checkExternalLinks, ageInFullSections).
  • The Preview tab. The draft now has three tabs, Preview | Blocks | Text. Preview shows the unsaved draft rendered through your section's own template, at Desktop or Phone width, and renders again as the draft changes. Hovering outlines each block with its name. Nothing is written to show it: no draft, no element. A template that fails says why (with the error, for admins), with Show blocks instead. Preview pages get headers that keep them private and out of search engines and block third-party scripts. Templates can test ghostwriterPreview. New settings: preview and previewScriptHosts. See Preview.
  • Layouts. With a first draft, Ghostwriter offers up to two other layouts of the same words, ranked against your section's own pages, with the most like them marked Suggested. They show as a row of names above the draft; Compare layouts shows them as cards with a thumbnail of each page. Each says what it changes ("Call to action added · Paragraphs as lists"), and choosing one scrolls to and outlines what changed. Only layouts that really differ are offered. The choice is shared with everyone on the piece. See Layouts.
  • Extras. The writer prepares numbers, FAQs, a pull quote, a call to action and the like, only for the block types your section has and only from what you gave it. The Text tab lists each with where it came from, and every part can be edited or deleted. See Extras.
  • Comments on the page. Turn on Comment in the draft's toolbar (Alt+Shift+C), click a block or select words, and write a comment. Comments stay yours, in your browser, until you Apply them: one call revises only the commented blocks, and the reply says what happened to each (Changed, with Before / after and Put it back; Replied; Not applied; or Skipped because someone else changed the block). Comments can be resolved and reopened, follow their words between layouts, and work by keyboard. See Comments.
  • Gaps as chips in the draft. In the Preview and the Text tab, a fact to add, a count to check and a link to choose show as small chips instead of raw markers. Click one to deal with it there: type the fact, confirm or change the count, or choose the page to link to. Under Plain Text fields and Table cells on the entry form, a row of chips names each gap as you type. The saved entry keeps its markers until they're dealt with.
  • Questions before a draft, one box each. When Ghostwriter needs to ask, it lists at most four short questions, each with its own box (or choices), (optional) where it is, and Skip. Send answers, or Just draft it with what you have.
  • Model it on picks entries for you. In a section with no learned kind, the brief now arrives with up to six live entries ticked, the closest in purpose and shape to the new piece. Your own ticks always win.
  • Links to your other pages in every first draft. Ghostwriter links a new draft to the most relevant pages of your site (about one link per 250 words, two to five), and a second call checks each one. Links Ghostwriter added are marked in the Text and Blocks tabs, where you can see where each goes and Remove link. Every section with URLs, and category pages with enough text of their own, can be linked to; disabled, noindex and utility pages and other sites never are.
  • Suggest links in Finish this page: Link to your other pages finds pages to link to on the entry as your form has it, in the background, and offers each as a step: "Link “…” to Contact us?", Link it or Skip.
  • A search title, description and address with the first draft. Ghostwriter writes the page's SEO description, and a search title when the page title is too long, from what the page says. They're in a Search section at the foot of the Text tab, editable, with a live character count and Try again. Use this draft puts them into SEOmatic or your plain SEO fields, never over text someone wrote, and sets the slug on a new entry. Photo file names are made from the alt text.
  • Headings fit your template. Drafts start at H2 under the page's H1, never skip a level, and use only the heading levels each CKEditor field allows. The Preview reads how your template prints headings, and the settings show a note when a template prints no H1, or several.
  • Finish this page gains: - counts to check: a number Ghostwriter counted from a list you gave ("3 counties") is a step, with Looks right, Change it and Remove it, and stops publishing like a fact to add; - Shorten a heading for a heading over 70 characters (Write it for me, one small call); - Link to your other pages on a page of 300 words or more with no links to your site; - Add a description for search when the SEO description is empty or too short; - a prompt for an image the page looks like it needs (required, the hero, or one most entries in the section have).

These suggestions never stop publishing, except counts to check.

  • Create entry on a new entry's draft is checked before publishing, like Save on a live entry (Craft 5.9 and later).
  • Connections (Ghostwriter → Connections), for admins: a card for every service Ghostwriter uses, under Writing (Anthropic, OpenAI, Gemini, OpenRouter), Images (Unsplash, Pexels, Pixabay, Openverse) and Stock photos (Shutterstock). Set up opens the page where the key is made and takes you through it; Check & save tests the key with one small call before keeping it. Each card says whether it's connected (showing only the key's last four characters), set in .env, or has stopped working, with Replace key and Disconnect. Connect with OpenRouter and Shutterstock's Connect account are on their cards. A key in .env always wins. See Connections.
  • Keys set up in Connections are kept in a new ghostwriter_credentials table, encrypted with your security key, never in project config. If CRAFT_SECURITY_KEY changes, set them up again.
  • German, French, Dutch and Spanish for the new SEO and Connections wording.

Changed

  • The publish guard only acts on what an editor saves in the control panel. Console commands (resave/entries, migrations, imports), queued jobs and the front end are never refused or warned about.
  • Ghostwriter only reads entries you can view. Learning or suggesting kinds, writing in a section, and the entries listed under Model it on need Craft's View entries for that section (and View other users' entries for theirs); sections you can't view aren't offered.
  • Keeping a photo, a made picture or a stock preview in an Assets field needs Upload files in that volume.
  • Remove preview on Stock images needs permission to delete the preview's asset.
  • One menu beside Edit with Ghostwriter. The "things to finish" pill is replaced by one count on a menu holding Finish this page, Review suggestions and Suggest edits.
  • The writing panel works at every width. Below about 900 px the conversation and the draft are one column, with Conversation | Draft at the top. The draft, its layouts and the Preview scroll as one column.
  • The writer keeps its own links to real pages instead of turning them into links to choose. For a link it couldn't place, Finish this page suggests the page it most likely means first.
  • Better link suggestions: pages are matched by word stems in English, German, French, Dutch and Spanish ("seed" meets "seedheads"), rare words count for more, key pages are always considered, and pages that link to each other or share a category rank higher.
  • Finish this page leaves required fields to Craft's own validation; an empty required field is no longer a step.
  • SEOmatic values are written with their override switch on, so a value the field offers can be written even when it was inherited. A description inherited from an empty field is written, as if empty.
  • Addresses keep the whole title ("what-to-do-in-the-garden-in-march"); only a title over about 60 characters loses its little words.
  • Suggest edits shows only what to act on, never how many things were found fine.
  • The settings' API keys table is now a summary linking to Connections. The OpenRouter key and Shutterstock account move into Connections when you run php craft up.

Fixed

  • Try again is offered when the first draft fails right after Looks right, start writing.
  • The Overview and Get started fit a phone.
  • Ghostwriter's note to the writer when editing an entry no longer shows in the conversation as if you'd sent it.
  • An SEOmatic description the page inherits is read as SEOmatic prints it (the field, then the section, then the global setting), including robots, instead of as an empty one Ghostwriter could write.
  • An entry removed without an event is forgotten by the weekly pass.
  • A busy server (502, 503, 504) is no longer reported as a page that refuses to show in a frame.
  • "1 thing still to finish" always opens onto that thing.
  • A link to choose whose hint CKEditor holds encoded is found and highlighted.
  • The guide's mark points at the words, not the field, and its words never cover the page's text or run off the window. Long button labels are cut short inside the card.
  • Editing writing with a link in the Text tab keeps the link as Craft's reference tag.
  • In the Extras list, Enter finishes an item and Esc puts it back.
  • Suggest edits' spinner sits beside its words.

Upgrading

bash composer update 1994/ghostwriter-craft 1994/ghostwriter-core php craft up php craft ghostwriter/revisit/refresh --full

  • php craft up adds the new tables and moves the OpenRouter key and Shutterstock account into Connections. Keys in .env keep working.
  • ghostwriter/revisit/refresh --full builds Content to revisit and the link index straight away; otherwise they fill in over the daily pass. Add it to cron daily (see Daily jobs).
  • See Upgrading from 1.2 to 1.3.

1.2.0

3 October 2026

Requires 1994/ghostwriter-core ^1.6.1, which no longer brackets quoted titles or figures you gave in a filled-in brief.

Requires 1994/ghostwriter-core ^1.6.

Added

  • OpenRouter, a fourth provider (openrouter). Claude, GPT or Gemini through one OpenRouter account, for writing and for making images, from OPENROUTER_API_KEY or Connect with OpenRouter. See OpenRouter.
  • Connect with OpenRouter in the settings (admins): sign in at openrouter.ai and come back with a key, kept encrypted with Craft's security component in ghostwriter_state (provider-key:openrouter). The state and PKCE verifier are kept together in the control panel session and used once. Check connection shows the credit left; Disconnect forgets the key. A key in .env always wins. New routes: ghostwriter/providers/openrouter/connect, callback, disconnect and check.
  • OpenRouter model for writing and OpenRouter model for quick jobs (openrouterModels), and a privacy note when OpenRouter is chosen. provider, imageProvider and baseUrls take openrouter.

Changed

  • The brief is in the conversation. The separate brief screen is gone. After you choose what you're writing, Ghostwriter asks in one message for the quick details ("What’s it called, and what should it say? A line or two is plenty."), fills in the whole brief for that kind from your answer (one model call) and shows it in the conversation as an editable brief card: the working title, every question with its answer, and Model it on with the entries it will follow ticked. Anything only you know stays in [square brackets]; facts about your organisation are never made up. Looks right, start writing starts the writing; Try again fills it in again, keeping the answers you changed. The questions, Just draft it with what you have, the draft and changes work as before. Once agreed, the card folds away to Show the brief and stays editable (Save the brief). See Writing a new entry.
  • Draft this on the content plan skips the question: the brief card arrives already filled in from the idea. Pieces carried on, and shared conversations, show the card in the thread. Pieces started from the old brief screen still show their brief behind Show the brief.
  • The brief card is a labelled region, and its arrival is announced to screen readers. ⌘↵ in the card agrees to it.
  • New control panel actions: ghostwriter/sessions/open, from-idea, try-again, agree and edit-brief, and a FillBrief queue job. ghostwriter/sessions/brief and ghostwriter/sessions/start are removed. Nothing is stored until you answer the first question, so choosing a kind and closing the panel leaves no empty piece behind.
  • Core's English for the brief is copied into Craft's translations as brief.* keys, by bin/sync-core-strings (was bin/sync-gap-strings). The temporary "Finish this page" wording overrides (src/translations/wording.php) are gone now that core words them the same way.

1.1.1

3 October 2026

Fixed

  • Finish this page: Link to … on a Link field showed the chosen entry but saved nothing, so the field was empty after the next autosave. The guide now reports the choice the way Craft's own picker does, and the link is saved.
  • A fix counts only when the field reads back different. Otherwise the guide says "That didn't change the field" and stays on the step. Craft's own pickers are checked the same way when they close.
  • Cancelling a picker opened by the guide leaves the field as it was: no pending replacement, and a Link field switched to Entry goes back to URL.
  • The guide and the flying mark step aside while a slideout is open, and come back with a fresh check when it closes.
  • Remove it in CKEditor no longer leaves a double space.

1.1.0

3 October 2026

Stock photos, "Finish this page", and new entries that start unpublished, on 1994/ghostwriter-core ^1.4.

> {warning} Ghostwriter now requires Craft CMS 5.8 or later. 1.0.0 said Craft 5.6, but it could never be installed on Craft 5.6 or 5.7: 1994/ghostwriter-core needs symfony/yaml ^6.4, which Craft allows only from 5.8. After updating, run php craft up (or apply the update in the control panel): it adds the stock image ledger's two tables.

Added

  • The stock image ledger: a record of every stock photo Ghostwriter puts into the site, free or paid: its library and ID, its asset, its licence state, the credit and licence, who added it and an append-only history. Kept in two new tables, ghostwriter_stock_images and ghostwriter_stock_usages (schema 1.2.0). Records are never deleted: deleting an asset marks its record removed and keeps any licence.
  • Use this on a free library's photo records it in the ledger as licensed, with the entry and field it went into.
  • Where each ledger image is used is read from Craft's relations whenever an entry is saved, following drafts and Matrix and Neo blocks to the entry at the top.
  • Photo libraries beyond the free four: paid libraries are searched once their keys are in .env and they are switched on. A demo library, "Demo stock (no charge)" (core's FakeLibrary), is offered in dev mode or with stockDemo in config, and never when CRAFT_ENVIRONMENT is production. Shutterstock is listed with its keys' status (SHUTTERSTOCK_API_KEY/SHUTTERSTOCK_API_SECRET); Getty Images (with iStock) is listed with its keys' status (GETTY_API_KEY/GETTY_API_SECRET) and marked as coming. Others can be added with StockLibraries::EVENT_REGISTER_LIBRARIES.
  • Settings → Stock photos: the free libraries' keys and the Openverse switch; each paid library's keys (read from .env, never stored or shown), Check connection (the account and what it has left), and an enabled switch; Search in, by default; Include editorial images by default; and When a page with an unlicensed preview is published (Block or Warn). New settings stockLibraries, stockDefaultSource, stockIncludeEditorial, stockOnPublish, stockDemo and stockUnusedDays.
  • The image dialog searches stock libraries: Search in (Free libraries, each paid library, or Everything) beside the search box, remembered for each person in their Craft user preferences. Each result has a source chip and a cost chip (Free, or the library's hint such as "1 download"), and an Editorial chip with its restrictions; editorial-only images are left out unless Include editorial images is ticked. A paid library's results are in its own order, never shown to a model; the intro says "Searches Demo stock for this part of the page. Results are in Demo stock's order." and a line above the results "Shown in Demo stock's order. Ghostwriter doesn't rank paid libraries." A preview the field holds now shows at the top under In this field now.
  • Insert preview on a paid photo: the field gets a stand-in asset (stripes at the photo's aspect ratio, labelled "Demo stock demo-01 · preview, not licensed", named, titled and described from the photo), the watermarked comp is kept privately in Ghostwriter's own files until the library's comp period ends, and the ledger records a preview. "Preview added. Only signed-in editors see the photo; license it before publishing."
  • Editors see the comp where the stand-in is: a control-panel-only comp route (ghostwriter/stock/<id>/comp, Cache-Control: private, no-store, X-Robots-Tag: noindex), and Asset::EVENT_DEFINE_URL turning a preview's address into it for control panel requests and for previews (Live Preview, View draft, share links) by someone signed in who may use Ghostwriter. Anyone else, including a share link opened signed out, gets the stand-in. A transform of a preview gets the comp at its own size.
  • Marked on the field and the asset: a badge under the image field ("Preview · not licensed", the library and photo ID) with License, or "Ask a manager to license" and Request licence; "Preview expired" with Refresh preview (once); a Stock licence panel in the asset's sidebar; and a Stock licence column for the asset index.
  • License & replace: a confirm step with the licence options, the cost in the account's own terms ("Uses 1 of your 100 remaining downloads (Demo pack)"), restrictions, an acknowledgement for editorial-only images, the credit to be kept ("If this page is news, a blog post or other editorial use, show this credit next to the image."), and the iStock and Premium Access seat notices. The licence is bought once (core's StockImages::license()), and Assets::replaceAssetFile() swaps the stand-in's file for the licensed original byte for byte (Craft's image cleaning is skipped, so embedded metadata stays), keeping the asset's ID, relations, title, alt text and focal point, and filling the credit field. The comp is deleted. Failures are said plainly: not connected, nothing left, the price changed (with the new price), refused, or not confirmed ("We couldn't confirm the purchase. Ghostwriter will check with Getty in a few minutes; don't buy it again.").
  • Only a real image is put in place: before License & replace swaps a file in, its type is read from its own bytes (the JPEG, PNG or WebP signature, and getimagesizefromstring() agreeing), not from the type the library sent, and the asset is named to match. Since Craft's image cleaning is skipped, anything else (an SVG, an HTML page, a truncated download) is refused with "The file Getty Images sent isn't a JPEG, PNG or WebP image, so it wasn't put in place." and the stand-in stays.
  • No page goes live holding a preview: on Entry::EVENT_BEFORE_SAVE, a canonical entry enabled for its site, saved live or updated from a draft (applying a draft), is refused with "The hero image is a Demo stock preview, not licensed yet. License it, or choose another image, before publishing." on the field, at any depth in Matrix and Neo blocks. Drafts and disabled entries always save. Warn (stockOnPublish) saves with a notice; global sets and categories are only warned.
  • Ghostwriter → Stock images: every stock photo in the site, by tab (Previews, with requested licences first; Licensed; Failed; All), with where each is used, its state, cost, licence and credit, and License, Reconcile, Remove preview, Download licence record, Export CSV and Check where they're used. An Overview tile, "N stock previews to license", and a line on the widget.
  • Cleanup with Craft's garbage collection and php craft ghostwriter/stock/cleanup: comps deleted when their period ends (the stand-in stays: "Preview expired"), previews no entry has used for stockUnusedDays removed, and licences whose answer was lost settled with reconcile() after ten minutes. php craft ghostwriter/stock/usages looks again at where each is used.
  • Shutterstock (API plan required) (core's adapter), from SHUTTERSTOCK_API_KEY and SHUTTERSTOCK_API_SECRET: search with the app's key and secret; licensing needs a Shutterstock API plan and the account connected (a shutterstock.com web plan can't license through the API). Nothing of a preview is stored: editors see Shutterstock's own watermarked preview. Shutterstock sandbox (shutterstockSandbox) uses api-sandbox.shutterstock.com, by default in dev mode.
  • Connect account / Disconnect in the settings for libraries that license with a person's own sign-in, following core's docs/connecting-accounts.md: three control panel routes (ghostwriter/libraries/<id>/connect, /callback, /disconnect), admins only, a random single-use state kept in the session and checked with hash_equals(), the same absolute callback (built from the site's own URL, never the request's host) in both calls, and the host-and-path to register shown on the row. Tokens are kept through core's LibraryTokens, encrypted with Craft's security component (DbLibraryTokens).
  • Docs: Stock photos.
  • ghostwriter:license permission ("License stock images"), given to nobody by default; admins have it.
  • Uninstalling writes the ledger to storage/ghostwriter-stock-ledger-<date>.json before its tables are dropped, and says so.
  • Finish this page, on the server (core 1.3's Gaps, finish-this-page design phases 2, 4, 5 and 9): - One publish guard for unfinished pages and stock previews (core's PublishReadiness), on the existing Entry::EVENT_BEFORE_SAVE hook: a live save, or applying a draft (updatingFromDerivative), is refused while a fact to add ([[ask: …]]), a link to choose (#gw-link:), a link to a deleted entry, an image placeholder, template text or an unlicensed stock preview remains, with core's message on each top-level field, named by its block inside Matrix and Neo ("Feature: Heading: Add opening days before publishing."). In warn mode, one notice lists them all. Drafts, provisional drafts and disabled entries always save. In sections Ghostwriter doesn't write for, only stock previews are looked for. - New settings under Finish this page: When a page with things to finish is published (onUnfinishedPublish, block or warn, reading stockOnPublish when unset; it replaces the stock photos setting on the settings screen) and Open the guide after a draft is added (finishOpenAfterDraft, on). - Ports for core's detectors: CraftPlaceholderAssets (the placeholder by its file name), CraftAssetRefs (Assets field IDs, and images inline in CKEditor by their {asset:…} reference tags, which Craft's relations don't hold) and CraftLinkTargets (entries by title and slug for "Link to Contact"; {entry:…} references that point at nothing). - ghostwriter/gaps/check: what is unfinished in an entry as the form has it (its draft or provisional draft, by element ID), translated, with each gap's place in the form (the element whose field it is, inside Matrix and Neo blocks) and the stock badge for previews. It never calls a model. - "Write it for me" and "Write around it" (ghostwriter/gaps/fill, queued as FillGap, polled with ghostwriter/gaps/fill-status): one small gap-filler request each, shown only to whoever asked, never put into the entry by the server, and never for a fact (core refuses). - The guide's state (open or minimised) is remembered per person, for every entry, in Craft's user preferences (ghostwriter/gaps/guide); minimised for someone new. - The session keeps what a draft left for a person (Session::$gaps, from core's SessionGaps::fromDraft()), so the guide can say "I didn't want to guess." The image placeholders note is no longer added to the notice after Use this draft: each placeholder is a step in the guide. - Links the house style can't settle now point at core's sentinel, https://example.com/#gw-link:<hint> (LayoutOptions::withLinkSentinels()), and are noted as "(link still to choose)". - Craft translations for core's gap strings, in src/translations/en/ghostwriter.php, copied by bin/sync-gap-strings (a test fails when they drift from core). - Core's contract tests run against Craft: PlaceholderAssetsContract, AssetRefsContract, MarkerRoundTripContract (through the real Applier) and PublishGuardContract (live save, draft, warn mode, a preview with a marker, applying a draft).
  • Finish this page, the guide (finish-this-page design §7 and §8.2, phases 6 to 8 and 10 for Craft), on every entry in a section Ghostwriter writes for, for anyone who may use Ghostwriter: - A count beside Save ("8 things to finish", then "Ready to publish"), shown on load only when something stops the page going live, so a new, empty entry isn't nagged. - Highlights: each field with a gap outlined (amber; purple for the current step; green once it had gaps and has none left), with a tag beside the field's name that jumps to its step: the current step and its kind ("7 · Oops"), or the field's steps ("4–7 · 4 to do"). Inside CKEditor the marker, the link's words or the template text itself is marked with CKEditor's own markers, so the highlight follows typing. - The guide (bottom right): each step's message, the fixes, and Back / Skip for now / Next, with a progress bar; things to finish first ("2 of 8"), then suggestions, numbered on their own ("Suggestion 1 of 1"). Fixes write into the form, never save: the fact typed into a box goes where the marker was (Enter or leaving the box; Esc leaves it), Link to … points the link at the matching entry (in CKEditor, or Craft's Link field, whose "Link to choose" label is cleared), Choose an entry and Choose from Assets open the field's own picker through its input (a full image field replaces its placeholder), Remove the link, Remove it, Leave it empty, It's fine, Find a photo (the image dialog for that field) and, for stock previews, the stock feature's own License dialog, Request licence and Refresh preview. Write it for me and Write around it ask Ghostwriter once each, and say so. - One live list, as the Statamic addon keeps it: the entry is checked again after each autosave of Craft's draft, and the steps are exactly the gaps found then. A gap that's gone is no longer a step; one a fix made (a placeholder swapped for a stock preview) is a new open step; the count, the "2 of 8" and the bar come from that one list. Gaps keep their identity when Craft gives a provisional draft's blocks new IDs, and blocks are found through Craft's draftElementIds. - The flying Ghostwriter mark goes to each field, just past its tag, with a short label, follows scrolling (in any pane), resizing and the form moving under it, and waits by the guide when its field is off screen. Minimise folds the guide into the mark in a round dock with the count (genie, wisps, a wave, a peek every seven seconds; the badge pulses when the count changes); restoring unfurls it. The choice is remembered for each person on every entry; after Use this draft the guide opens by itself (finishOpenAfterDraft). - Matrix and Neo: collapsed blocks are expanded and tabs opened when a step comes up; in Matrix's cards view the card is highlighted and Open block opens Craft's slideout, where its fields are highlighted too. The guide steps aside while one of Craft's modals is open. - Keyboard and screen readers: Alt+Shift+N / P / G, Esc inside the guide; a labelled region, a polite live region, tags as buttons, focus moved to the step and to the dock. - Phones (below 640px): a bottom sheet that folds to a bar, no flying mark. Reduced motion: nothing flies, bobs or folds. - The guide's words, and core's, are Craft translations (Craft.t('ghostwriter', …), registered for the page). - Places in blocks are named once: "the Text block", or "Subheading (in the Hero block)", not "Text: Text", in the guide and in the publish guard's messages. - The guide's helpers have their own tests (node --test tests/js/*.test.mjs), run in CI.
  • Finish this page: fixes that stick (an audit of every fix in a browser, checking what the field shows, that it is saved, and that the gap clears): - Link to … on Craft's Link field showed the entry but saved nothing: the field writes its stored value only when its picker reports a choice. The guide now reports it the same way, so {entry:…} is saved. - A fix counts only when the field reads back different. Otherwise the guide says "That didn't change the field. Try another fix, or change it yourself." and stays on the step. A choice made in Craft's own pickers (Choose an entry, Choose from Assets, Find a photo) is checked the same way once the picker closes. - Cancelling a picker leaves the field as it was: the replace Craft was holding is dropped, and a Link field switched to Entry to open its picker goes back to the type (and address) it had. - The guide and the mark step aside while a slideout is open (a block opened from cards view), as they do for Craft's modals, and come back, checking again, when it closes. - Remove it in CKEditor no longer leaves two spaces where the template text was.
  • "Include editorial images" says what it means: an (i) with Craft's info icon (focusable, and opened by a tap) explains editorial photos and where they may be used, a hint under it reads "News and event photos. Not for advertising or promotion.", and it shows only when the source chosen in Search in can return editorial images (core's Capabilities::$editorial; never the free libraries). Each Search in option now says whether it can (editorial).
  • Docs: Finish this page.

Changed

  • New entries start unpublished (draftsUnpublished, on by default, matching Statamic's drafts_unpublished): when a draft goes into a new entry, its Enabled switch is turned off in the form (for the site too), so it can be saved straight away and an AI draft is never published by accident. The notification says "Ghostwriter drafts start unpublished. Switch on Enabled when you're ready." Existing entries are never changed.
  • Requires 1994/ghostwriter-core ^1.4.
  • Requires Craft CMS 5.8 or later (was 5.6). Core needs symfony/yaml 6.4 or later, which Craft allows from 5.8, so Ghostwriter could never be installed on Craft 5.6 or 5.7.
  • Schema version 1.2.0: one new migration, m261003_000000_stock_ledger, adds ghostwriter_stock_images and ghostwriter_stock_usages.
  • Continuous integration: the test suite runs on GitHub Actions for every pull request, on PHP 8.2, 8.3 and 8.4, against the lowest Craft Composer will install and the newest.
  • Images a stock library's terms keep from AI (Getty Images and iStock) never go to a model: not as reference images for finding or making a picture, nor as samples for the image style guide. Files named GettyImages-* or iStock-*, or whose embedded credit names Getty Images or iStock, are left out too.

Fixed

  • The minimum Craft version in composer.json and the docs: 1.0.0 claimed Craft 5.6, which Composer could never satisfy alongside core.
  • Reading an entry's Matrix and Neo blocks and relations now uses what was posted with the form (the query's cached result) before what is saved.

1.0.0

2 October 2026

First release. Ghostwriter learns how your site writes and what its pictures look like, then drafts new entries and edits existing ones in that voice, in a panel beside the entry form. Get started walks through setup, the Overview shows what is in progress, and a widget sits on Craft's dashboard.

Writing

  • Write with Ghostwriter on a section's new entries, beside New entry on the entry index, and from the Overview, the widget and the content plan.
  • Choose a kind you taught it, something like what is already here, or a general brief that works on every section with no setup.
  • The brief: answer its questions, or give a working title and notes and have it fill them in. Model it on up to six entries.
  • A follow-up conversation: Ghostwriter asks at most three questions when it needs facts only you know, then takes changes in plain words. It never invents figures, quotes or client names.
  • The draft in Blocks and Text views. Click any writing (or Tab to it) to change it in place; Edit YAML for the whole draft.
  • Use this draft writes into the entry's Craft draft, to check and save. Nothing is saved or published for you.
  • Edit with Ghostwriter on an existing entry changes its writing in conversation, into your provisional draft, keeping images, relations, links and settings.
  • Plain text, CKEditor and Redactor fields, Matrix and Neo page builders, and Tables.

Learning the site

  • Voice guide, written from your published entries, edited by hand or by asking for a change.
  • Image style guide, written from the images your entries use, one part per section.
  • Kinds of content: suggested per section with examples and why each is worth teaching, learned on request, or taught by hand with their own questions, guidance, checklist and examples.
  • Everything is kept in the database, so it works on read-only and load-balanced hosts.

House style

  • New entries copy what your entries agree on: block order, settings, links and heading markup. Links Ghostwriter can't decide point to https://example.com and are listed for you to set.

Images

  • A Ghostwriter button on Assets fields: Find a photo on Openverse, Unsplash, Pexels and Pixabay, ranked by the model against the page's words and the images already in that place, with a second round of searches when nothing fits.
  • Found photos are named and titled from the library's description, which also fills Craft's own alt text, with the credit kept in a credit field where the volume has one.
  • Make the picture with OpenAI or Gemini, in the style of the images already there, optionally with your own image in it.
  • Photos offered for every image field under a draft, and striped placeholders where a new entry is still missing an image (Mark images still to choose).

Content plan

  • Ideas for entries each section is missing, reviewed before they join the plan, optionally steered. Draft this opens a new entry with the brief filled in.

Teams

  • Conversations are shared with everyone who may use Ghostwriter, showing who sent each message and who started and last changed each piece. Turn this off with Share conversations (sharedConversations).
  • One permission, Use Ghostwriter. Writing into an entry still needs Craft's own permission to save it. Admins manage Ghostwriter.

Providers

  • Writing with Anthropic (Claude), OpenAI (ChatGPT) or Google (Gemini); images with OpenAI or Gemini. Defaults: claude-opus-5-5, gpt-6.1-sol and gemini-3.8-flash for writing; gpt-image-2.5-sunburst and gemini-3.1-flash-image for images.
  • Keys are read from .env (ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY) and never stored or shown.
  • baseUrls for a gateway or proxy that speaks a provider's own API.
  • A busy or rate-limited provider is tried again, up to three attempts in all, following its retry-after.
  • A reply cut off at its length limit is asked for once more with twice the room; a draft or the voice guide is never saved half-written.
  • Each call is logged to Craft's log with the provider, model, tokens and time, never the words.

Requirements

  • PHP 8.2 or later; Craft CMS 5.6 or later.
  • An API key for Anthropic, OpenAI or Gemini.
  • Craft's queue, which runs by itself from the control panel unless your site uses a worker.

Filament

1.2.0

16 October 2026

Suggest edits and Content to revisit, which find what has gone stale on your published records and help you fix it; drafts that arrive linked to your other pages, with a search title, description and address; and Connections, one place to set up every key. Requires 1994/ghostwriter-core ^1.10.

Added

  • Suggest edits, in the menu beside Edit with Ghostwriter on a record's Edit page. It reads the form as it is now, unsaved typing included. Free checks look for candidates: past years written as current, counts and claims to check, unclear wording, missing alt text, SEO text over its limit or missing, long headings, duplicates, and a long page with no links to your other pages. A confirm says what the review costs before anything is sent. The review keeps a candidate only if it's a real problem in its sentence, adds its own suggestions for voice and clarity, and a second call checks every suggestion again before you see it. The guide shows each change in its sentence, with the reason and where it comes from, and Accept, Edit, Another version, It's still right and Dismiss, with Undo; category filters; Accept all wording fixes; links to your other pages; a fact's answer box that never guesses; and alt text saved to the ->ghostwriterAlt() field after a confirm. Accepted changes go into the form only; nothing is saved until you save. Decisions are kept as the record's history. See Suggest edits.
  • Content to revisit, a page in the Ghostwriter cluster: published records ranked by free checks (no AI), with their reasons, a priority bar, tiles that filter, Review (opens the record with Suggest edits), Snooze for 90 days and Open without reviewing. It's kept current as records are saved, and by php artisan ghostwriter:revisit, daily on the scheduler (every record weekly).
  • A weekly check of links to other sites, off by default (ghostwriter:check-links): one HEAD request per address a week, at most one a second per site.
  • Three settings: Flag counts and claims to check (on), Check links to other sites once a week (off) and Weigh age in full for (resources with a date field weigh age at a quarter unless ticked). The free checks read English, German, French, Dutch and Spanish, from the app's locale or ghostwriter.suggest.language.
  • Links to your other pages in every first draft. Tell Ghostwriter where your records are public with ->publicUrlUsing(Resource::class, fn ($record) => …) on the plugin (liveFrom: and liveUntil: for scheduled and expired records). A new draft is then linked to the most relevant of them (about one link per 250 words, two to five), and a second call checks each one. Links Ghostwriter added are marked in the draft, where you can see where each goes and Remove link. Records with no public address, noindex records (->ghostwriterSeo('noindex'), or toggles such as noindex or hide_from_search) and utility pages are never linked to. See Links to your pages.
  • Suggest links in Finish this page: Link to your other pages finds pages to link to on the form as it is now, and offers each as a step: "Link “…” to Contact us?", Link it or Skip.
  • A search title, description and address with the first draft, where the form has SEO fields (->ghostwriterSeo(), or fields named seo_title, meta_description and the like) or a slug field (->ghostwriterSlug() for one not called slug). Ghostwriter writes them from what the page says. They're in a Search section in the draft's Text view, editable, with a live character count and Try again. Use this draft puts them into the form, never over text someone wrote, and fills the slug on a Create page. Photo file names are made from the alt text.
  • Headings fit your page and each RichEditor's toolbar. Drafts start at H2 under the page's H1, never skip a level, and use only the heading levels the editor offers. ->ghostwriterHeadings(from: 1) on a RichEditor or MarkdownEditor whose # is the page's main heading. See Headings.
  • Finish this page gains Shorten a heading (over 70 characters; Write it for me, one small call), Link to your other pages (300 words or more and no links to your site), Add a description for search (empty or too short), Check the links Ghostwriter added, and a prompt for an image the page looks like it needs (required, the hero, or one most records of the resource have). These never block publishing. A count to check can be fixed in the guide (Looks right, Change it).
  • Questions before a draft, one box each. When Ghostwriter needs to ask, it lists at most four short questions, each with its own box (or choices), optional where it is, and Skip.
  • Model it on picks records for you. For a resource with no learned kind, the brief now arrives with up to six published records ticked, the closest in purpose and shape to the new piece. Your own ticks always win.
  • Get started shows the whole guide, with Read the whole guide and a link to edit it.
  • Work in hand shows everywhere: a button that starts queued work stays down and spinning, with words such as Learning your voice…, until it lands.
  • Connections (Ghostwriter → Connections), for those who manage Ghostwriter: a card for every service Ghostwriter uses, under Writing (Anthropic, OpenAI, Gemini, OpenRouter), Images (Unsplash, Pexels, Pixabay, Openverse) and Stock photos (Shutterstock). Set up opens the page where the key is made and takes you through it; Check & save tests the key with one small call before keeping it. Each card says whether it's connected (showing only the key's last four characters), set in .env or config, or has stopped working, with Replace key and Disconnect. Connect with OpenRouter and Shutterstock's Connect account are on their cards. A key in .env always wins. See Connections.
  • Keys set up in Connections are kept in a new ghostwriter_credentials table, per workspace, encrypted with APP_KEY. If APP_KEY changes, set them up again.
  • German, French, Dutch and Spanish for the new SEO and Connections wording.

Changed

  • Ghostwriter only reads records you can view. The writing panel, Teach a kind, and suggesting or learning kinds need the resource's policy to let you list its records (viewAny), and Model it on lists only records it lets you view. A resource you can't list isn't on the Overview.
  • One menu beside Edit with Ghostwriter. The "things to finish" pill is replaced by one count on a menu holding Finish this page, Review suggestions and Suggest edits, on Create and Edit pages. Pages with their own header actions use GhostwriterMenu::make() in place of GhostwriterAction::make().
  • The writer keeps its own links to real pages instead of turning them into links to choose. For a link it couldn't place, Finish this page suggests the page it most likely means first.
  • Better link suggestions: pages are matched by word stems in English, German, French, Dutch and Spanish ("seed" meets "seedheads"), rare words count for more, key pages are always considered, and records that link to the one being edited rank higher.
  • Finish this page leaves required fields to Filament's own validation; an empty required field is no longer a step.
  • Addresses keep the whole title ("what-to-do-in-the-garden-in-march"); only a title over about 60 characters loses its little words.
  • Suggest edits shows only what to act on, never how many things were found fine.
  • The Ghostwriter mark replaces generic icons on its buttons, navigation and widget.
  • Below 1024 px the draft scrolls with the panel, and Get started's steps wrap.
  • The settings' API keys section is now a summary linking to Connections. The OpenRouter key and Shutterstock account move into Connections when you run the migration.

Fixed

  • Editing a record no longer shows Ghostwriter's note to the writer as if you'd sent it.
  • Content to revisit forgets deleted records in every workspace, including records saved or deleted outside a panel.
  • An empty SEO description shown from its fallback field isn't called missing.
  • The Finish tab counts what the menu counts.
  • A link to choose whose hint has a space is found and fixed.
  • Find a photo's results say what each photo shows.
  • Finish this page sees a picture put in with the image button straight away.
  • Get started no longer announces a done step as "Not completed", and the first voice or image guide starts at once.
  • Field tags number a suggestion among the suggestions ("Suggestion 2 of 3").
  • Ghostwriter's tabs wrap at 1440 px, the Overview fits a phone, and a long Search line no longer widens the draft.
  • "The Posts form has changed…", not "Posts’s form".
  • The guide's mark points at the words, not the field, and its words never cover the page's text or run off the window. Long button labels are cut short inside the card.

Upgrading

bash composer update 1994/ghostwriter-filament 1994/ghostwriter-core php artisan vendor:publish --tag=ghostwriter-suggest-migrations php artisan vendor:publish --tag=ghostwriter-link-index-migrations php artisan vendor:publish --tag=ghostwriter-seo-migrations php artisan vendor:publish --tag=ghostwriter-connections-migrations php artisan migrate php artisan filament:assets php artisan ghostwriter:scan php artisan ghostwriter:revisit --full php artisan queue:restart

  • The plugin publishes its migrations rather than loading them: publish the four new ones, then migrate. They add Suggest edits and Content to revisit, the link index, the SEO state on a piece, and Connections (which also moves the OpenRouter key and connected accounts out of ghostwriter_states).
  • On pages with their own getHeaderActions(), replace GhostwriterAction::make() with GhostwriterMenu::make().
  • Add ->publicUrlUsing() on the plugin for drafts to link to your records.
  • Make sure the scheduler runs (php artisan schedule:run every minute).
  • See Upgrading from 1.1.

1.1.0

3 October 2026

Requires 1994/ghostwriter-core ^1.6.1, which no longer brackets quoted titles or figures you gave in a filled-in brief.

Added

  • OpenRouter, a fourth provider (openrouter), for writing and making images: Claude, GPT, Gemini and others through one account, paid for with OpenRouter credit. The key is OPENROUTER_API_KEY, or Connect with OpenRouter in the settings. See docs/api-keys.md.
  • Connect with OpenRouter: the settings sign in to OpenRouter (OAuth with PKCE) and keep the key it gives, encrypted with the app's key and per tenant, never shown. Check connection and Disconnect beside it, for people who manage Ghostwriter. A key in .env always wins.
  • A model for each tier of work with OpenRouter (Model for writing, Model for quick jobs), and a note in the settings that requests pass through OpenRouter when it writes or makes images.

Changed

  • The brief is in the conversation. Choosing what you're writing stays as it is; then, instead of the brief screen, Ghostwriter asks in one message for a working title and a few notes ("What’s it called, and what should it say? A line or two is plenty."), fills in the kind's whole brief from the reply (one model call) and shows it in the conversation as an editable brief card: the working title, the kind's questions with their answers, and Model it on with records ticked. Anything only you know stays in [square brackets]; it never makes up facts about your organisation. Looks right, start writing stores the brief on the piece and starts the writing; Try again fills it in afresh and keeps the answers you changed. The conversation then carries on as before (questions, Just draft it with what you have, the draft, changes). Once agreed, the card folds away to Show the brief and stays editable (Save the brief). See docs/writing.md.
  • Draft this on the content plan skips the question: the brief card arrives already filled in from the idea, ready to check.
  • Pieces carried on, and colleagues' shared pieces, show the brief card in the thread. Pieces started before keep their brief behind Show the brief.
  • The card is a labelled region, and screen readers hear when the brief is filled in. "Model it on" counts ticks in the browser, so ticking costs no round trip.
  • The brief-filler prompt replaces brief-writer: an override of brief-writer.md is no longer used.
  • Requires 1994/ghostwriter-core ^1.6.

Fixed

  • Connect account, stock previews and demo thumbnails work on panels with tenancy. Inside a tenant the routes' first parameter is the tenant, which the controllers took for the library or the image, so Connect account, Disconnect, a preview's comp and the demo thumbnails answered 404 there. They now read their parameters by name, and every Ghostwriter route is tested on a panel with and without tenancy.
  • The panel stays open when it was opened from the address (from the list page, the Overview, the content plan or a reload) on a resource with an upload field. The upload field's first request could answer after the panel opened, with the page as it was before, so the panel closed the next time it opened a piece.

Removed

  • The separate brief screen, its quick brief and Fill in the brief.

1.0.1

3 October 2026

Fixed

  • The guide, the dock and the flying mark step aside while one of Filament's modals is open (Find a photo, License, Ghostwriter's panel).
  • A fix counts only when the field's value, as Livewire holds it, changed. Otherwise the guide says so ("That didn’t change the field…") and stays on the step, and the answer box can be used again.

1.0.0

3 October 2026

First release. Ghostwriter learns how your app's content reads and what its pictures look like, then drafts new records and edits existing ones in that voice, in a panel beside the resource form. Where it doesn't know a fact it marks the place, and Finish this page walks you through what's left before a record goes live. Stock photos from paid libraries (Shutterstock; Getty Images and iStock are coming) go in as watermarked previews and are licensed in place, with a ledger of every one. Get started walks through setup, the Overview shows what is in progress, and a widget sits on the dashboard.

Writing

  • Write with Ghostwriter on a resource's Create page (WritesWithGhostwriter), its list page (ListsWithGhostwriter), the Overview, the widget and the content plan.
  • Choose a kind you taught it, something like what is already here, or a general brief that works on every resource with no setup.
  • The brief: answer its questions, or give a working title and notes and have it fill them in. Model it on up to six records.
  • A follow-up conversation: Ghostwriter asks at most three questions when it needs facts only you know, then takes changes in plain words. It never invents figures, quotes or client names.
  • The draft in Blocks and Text views. Click any writing (or Tab to it) to change it in place; Edit YAML for the whole draft.
  • Use this draft fills the form, to check and save. Nothing is saved for you.
  • Edit with Ghostwriter on an existing record changes its writing in conversation, keeping images, relationships, links and settings.
  • Each resource's form is read and kept as a form map: text, rich text, choices, toggles, Builder blocks and Repeater rows, with ->ghostwriter(false), ->ghostwriterHint() and php artisan ghostwriter:scan.

Learning the site

  • Voice guide, written from your published records, edited by hand or by asking for a change.
  • Image style guide, written from the images your records use, a section per resource.
  • Kinds of content: suggested per resource with examples and why each is worth teaching, learned on request, or taught by hand with their own questions, guidance, checklist and examples.
  • A closure per resource says which records count as published, the ones Ghostwriter learns from.

House style

  • New records copy what your records agree on: block order and settings. Settings that differ are listed for you to set.

Images

  • A Ghostwriter button on image upload fields: Find a photo on Openverse, Unsplash, Pexels and Pixabay, ranked by the model against the page's words and the images already in that place, with a second round of searches when nothing fits.
  • Found photos are named and titled from the library's description; ->ghostwriterAlt() fills an alt text field beside the upload, and a PhotoKept event carries the alt text, title and credit.
  • Make the picture with OpenAI or Gemini, in the style of the images already there, optionally with your own image in it.
  • Photos offered for every image field under a draft, and striped placeholders where a new record is still missing an image (Mark images still to choose).

Content plan

  • Ideas for records each resource is missing, reviewed before they join the plan, optionally steered. Draft this opens a new record with the brief filled in.

Teams

  • Conversations are shared with everyone who may use Ghostwriter, within the current tenant, showing who sent each message and who started and last changed each piece. Turn this off with shared_conversations.
  • Two gates, useGhostwriter and manageGhostwriter, and ->canManage() on the plugin to say who manages it. Writing into a record still needs the resource's own permission.
  • Tenancy: guides, kinds, the plan and pieces are kept per tenant, and only the current tenant's records are read.

Providers

  • Writing with Anthropic (Claude), OpenAI (ChatGPT) or Google (Gemini); images with OpenAI or Gemini. Defaults: claude-opus-5-5, gpt-6.1-sol and gemini-3.8-flash for writing; gpt-image-2.5-sunburst and gemini-3.1-flash-image for images.
  • Keys are read from .env (ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY) and never stored or shown.
  • base_urls for a gateway or proxy that speaks a provider's own API.
  • A busy or rate-limited provider is tried again, up to three attempts in all, following its retry-after.
  • A reply cut off at its length limit is asked for once more with twice the room; a draft or the voice guide is never saved half-written.
  • Each call is logged with the provider, model, tokens and time, never the words.

Stock image ledger

  • Every stock photo put into a record is recorded in a ledger: the library and photo, the file's disk and path, its licence state, credit, who put it in and when, and an audit trail. A free photo is recorded as licensed when Use this saves it.
  • Two tables, ghostwriter_stock_images and ghostwriter_stock_usages, with tenant columns like the others. Licence records are never deleted; rolling the migration back keeps the tables unless GHOSTWRITER_DROP_STOCK_LEDGER=true.
  • Where each image is used is kept up to date by an observer on the models of the resources Ghostwriter writes for: saving a record finds the ledger's images in its data (JSON columns and Builder blocks included), and whether the record is live comes from the resource's published rule.

Paid libraries and previews

  • Search in beside the search box in Find a photo: Free libraries, each paid library, or Everything. It starts from the settings' default source, then each person's last choice. Shown only when there is a paid library to choose.
  • Result cards carry the source and cost chips (Free, or the library's hint such as "1 download"), and an Editorial chip with the library's restrictions. Editorial images are left out unless Include editorial images is ticked.
  • Insert preview for a paid photo: the field gets a stand-in JPEG at the photo's aspect ratio, labelled with the library and photo ID, which is safe at a public address. The watermarked comp is kept privately on the local disk under ghostwriter/stock, and the ledger records a preview. Paid photos are never shown to the model; they keep their library's order.
  • Demo stock (no charge): core's FakeLibrary, with a dozen made-up photos. It is on in a local environment or with GHOSTWRITER_STOCK_DEMO=true, and never in production.
  • A Stock photos section in Settings: the free libraries (the Openverse switch and the key status), each paid library with its switch and Check connection, the default source, Include editorial images by default, and what happens when a page with an unlicensed preview is published (Block or Warn; GHOSTWRITER_STOCK_ON_PUBLISH wins). Shutterstock's row shows its keys' status.

Previews and License & replace

  • A field holding a preview says so: beside its Ghostwriter button, Preview · not licensed (the library and photo ID in its tooltip) and License. For people who may not license it says Ask a manager to license, with Request licence. The badge opens the watermarked comp, and the image panel shows it too.
  • The comp is served only inside the panel, to people who may use Ghostwriter, at ghostwriter/stock/{id}/comp with Cache-Control: private, no-store and X-Robots-Tag: noindex. A library that stores nothing redirects to its own preview. Ghostwriter::stockPreviewUrl($disk, $path) gives the address to apps with a preview of their own (null for anyone else).
  • License & replace: the confirm step shows the licence option, its cost against what the account has left, restrictions, the credit line ("If this page is news, a blog post or other editorial use, show this credit next to the image"), and the seat notices. Editorial images need a tick. The licensed file is written over the stand-in at the same path, byte for byte, so the record and its alt text don't change, and the comp is deleted. A StockImageLicensed event carries the credit for apps with media tables.
  • Failures in plain words: an empty balance, a changed price (the options are shown again), a library not connected, or an unknown outcome ("We couldn't confirm the purchase…; don't buy it again"), which is left for reconciling. A file that can't go in place keeps its licence, with Download again and replace.
  • ->canLicense(fn ($user) => …) on the plugin says who may license (it spends money). By default, whoever may manage Ghostwriter. A licenseGhostwriterStock gate of the app's own wins.

Publishing, the ledger and cleanup

  • ->publishedWhen(fn (Model $record): bool => …) on the plugin says what "live" is. With it, saving a record that will be published with an unlicensed preview is refused, with the message under the image field ("Cover is a … preview, not licensed yet. License it, or choose another image, before publishing."). Drafts save freely. Set to Warn, it saves with a warning. Without publishedWhen, every save with a preview shows a persistent warning.
  • Stock images, a page in the Ghostwriter cluster, with tabs for Previews (licence requests first), Licensed, Failed and All. Each row shows the picture, library and ID, where it's used (with links, and whether the record is live), its state, cost, who licensed it and when, the credit line and restrictions. Actions: License, Request licence, Reconcile, Remove preview, Download licence record, plus Export CSV.
  • A Stock previews tile on the Overview ("N to license"), shown only while there are any, and a warning once one is on a live record. A line on the widget too.
  • ghostwriter:stock-cleanup, daily on the scheduler, in every tenant: it deletes comps whose time is up (the stand-in stays: "Preview expired", with Refresh preview once), removes previews used nowhere for 30 days (ghostwriter.stock.unused_days), and reconciles licences whose outcome wasn't known, without buying again.
  • ->unpublishWith('status', 'draft') (or a closure over the form's data): Use this draft on a Create page sets the new record unpublished in the form, so it saves straight away, even with a stock preview in it, and says so ("Ghostwriter drafts start unpublished. Switch it on when you're ready."). It never touches an existing record.
  • In running text and messages a library is named without its suffix ("Demo stock", "Shutterstock"); only Search in shows "(no charge)" or "(sandbox)". The Find a photo intro follows Search in, paid results say "Shown in …'s order. Ghostwriter doesn't rank paid libraries.", and a stock image the field already holds is shown first under In this field now.
  • Docs: Stock photos.

Shutterstock and Connect account

  • Shutterstock (API plan required), core's adapter, from SHUTTERSTOCK_API_KEY and SHUTTERSTOCK_API_SECRET. It searches with the app's keys and licenses through the customer's connected account. Its previews are Shutterstock's own watermarked address, never stored. SHUTTERSTOCK_SANDBOX uses its sandbox, which charges nothing (on by default in a local environment).
  • Connect account / Disconnect in Settings, for managers, following core's docs/connecting-accounts.md: three panel routes (ghostwriter/libraries/{library}/connect, /callback, POST /disconnect), a random single-use state kept in the session and checked with hash_equals(), and the same absolute callback address (from APP_URL) in both calls. The Shutterstock row shows the host and path to register as its Callback URL.
  • Tokens are kept through core's LibraryTokens, encrypted with the app's key, per tenant. A lost connection shows Connect again in the License dialog. GHOSTWRITER_STOCK_DEMO_CONNECT=true makes the demo library need connecting, to try it.
  • No Getty or iStock image reaches a model. Photo ranking's reference images, the imagery analyst's samples and a made picture's references go through core's model-input guard, which checks the ledger, the file's name and its embedded credit.

Shutterstock access token

  • SHUTTERSTOCK_API_TOKEN: a fixed access token, generated on your Shutterstock app's page with the scopes licenses.create, licenses.view, purchases.view and user.view, used instead of Connect account. Settings shows Using the token from .env in place of Connect account and Disconnect, whose routes are then gone; Check connection shows the subscriptions and downloads left. Read from .env only, never stored or shown. A refused token is said plainly, and nothing is bought.

Editorial images, explained

  • Include editorial images in Find a photo shows only when the chosen source can return editorial images (core's Capabilities::$editorial): never for the free libraries or the demo library. A box that isn't shown asks for none.
  • It has a one-line hint under it ("News and event photos. Not for advertising or promotion.") and an info button beside it whose tooltip says what editorial use allows (hover, focus or tap; read out to screen readers).

Finish this page

  • One publish guard for unfinished pages and stock previews, core's PublishReadiness. With ->publishedWhen(), a record can't be saved as live while a fact is still to add ([[ask: …]]), a link still to choose (#gw-link:), an image placeholder, leftover template text ([[item]]) or an unlicensed stock preview is in it: each message is under its field, Builder and Repeater items included. Drafts save freely; required fields are left to Filament. Without ->publishedWhen() nothing is refused, and each save with something unfinished shows one warning. The rule has its own Publishing section in Settings ("When a page is published with something unfinished": Block or Warn), and GHOSTWRITER_PUBLISH_ON_UNFINISHED wins over it. While it isn't set, GHOSTWRITER_STOCK_ON_PUBLISH is read.
  • Core's ports, Gaps\StorageAssets: images in upload fields and inline in RichEditor (data-id, HTML or TipTap JSON), and the striped placeholder by its file name. Core's contract tests run against the workbench: placeholder assets, asset references, the marker round trip through the real apply path (TipTap JSON included), and the publish guard.
  • What the guide is told: $wire.ghostwriterGaps() on pages using WritesWithGhostwriter finds every gap in the form as it is now (unsaved typing included), each with its Livewire state path; Builder and Repeater items are named by their keys, so a gap stays with its block. Nothing asks a model.
  • Fixes that write: ghostwriterFillGap() makes one small request (core's gap-filler) per click: "Write around it" for a fact still to add, "Write it for me" for an empty prose field. Never a fact.
  • The session keeps what a draft left for a person (core's Session::$gaps), in a nullable gaps column. The guide points at each striped placeholder a draft leaves.
  • The RichEditor's attachments disk is kept in the form map.

Finish this page: the guide

  • The pill beside Write with Ghostwriter counts what's left ("5 things to finish", then "Ready to publish"). On load it appears only when something would block (or, without publishedWhen, be warned about on) publishing, so empty new records aren't nagged.
  • Highlighted fields with a tag beside each field's name: the current step and its kind where the guide is ("2 · Swap me"), a range elsewhere ("2–4 · 3 to do"), "Fixed ✓" when finished. The pill, the guide's "2 of 5", the progress bar and the tags all come from one list; suggestions come after the steps and are numbered on their own. Each place is named once ("Body (in the Text block)", "Answer (in Questions 1)").
  • Inside RichEditors the marker's own words get a dashed underline: a TipTap extension added to every RichEditor through a RichContentPlugin (ProseMirror decorations; the content is untouched).
  • The guide (bottom right; a bottom sheet below 640px) with Back, Skip for now and Next. It opens the field's tab, section or collapsed Builder or Repeater item (Filament's expand event) and scrolls it clear of the guide. The flying Ghostwriter mark goes to each field with a short label, which follows when a step's kind changes. Minimise folds it into a corner dock with a count badge. Every animation is off under reduce motion.
  • Fixes write into the form, never save: type a fact in, add a link's address, remove a link or template text, Find a photo, Upload an image (the field's own picker, even on a full field), Leave it empty, License (the stock badge's own dialog), and the two that use Ghostwriter (one request per click, never a fact).
  • Moving about never asks the server: tags, Next, Back, minimise and restore are all in the browser, and checking (ghostwriterGaps()) and writing (ghostwriterFillGap()) are renderless, so FilePond and the editors are never rebuilt. Whether the guide is open is remembered with a plain POST. Skipped steps are remembered per record for the browser session.
  • Keyboard and ARIA: Alt+Shift+N, P and G; a labelled region with a polite live region; tags as buttons; focus moves to each step's message.
  • Every field's wrapper says its state path (data-gw-path).
  • The guide's logic is pure JavaScript, tested with Node's own runner in a no-install CI job.
  • Docs: Finish this page.

Under the hood

  • Pieces, the content plan, kinds, guides, image requests and the queue notice use the rules in 1994/ghostwriter-core (^1.4), shared with the Statamic and Craft addons.
  • Changes to a piece are made under a cache lock (lock_store), so two people, or a person and a running job, can't save over each other.
  • A piece, guide scan, kind suggestion or plan look that stopped without finishing (its worker cut off) shows as failed once its job can no longer be running (time limit × 3 + 60 seconds, plus two minutes), and can be tried again.
  • A new batch of plan suggestions joins the one waiting for review; a finished idea can't be put back (Back to ideas and Put back are for started and dismissed ones); Try again only re-runs a failed request.
  • Ghostwriter's save hooks are trait-named lifecycle hooks (afterValidateWritesWithGhostwriter()), which Filament calls from 5.8, hence the minimum.
  • GitHub Actions run the tests on PHP 8.3 with the oldest versions allowed (Laravel 12, Filament 5.8) and on PHP 8.3 and 8.4 with the newest, plus Pint and the guide's JavaScript tests.

Requirements

  • PHP 8.3 or later; Laravel 12 or 13; Filament 5.8 or later (with Livewire 4); 1994/ghostwriter-core ^1.4.
  • A licence from Anystack. Install from the Composer repository https://ghostwriter-filament.composer.sh (see Installation).
  • An API key for Anthropic, OpenAI or Gemini.
  • A queue worker (--timeout=960), and Laravel's scheduler for the daily stock cleanup. GD for placeholders and Imagick for smaller image copies are optional.