Added Claude-powered image alt text generation by vitrixbot · Pull Request #29317 · TryGhost/Ghost

vitrixbot · 2026-07-14T16:06:59Z

What changed

added a settings-backed Claude integration with a masked API-key configuration flow
added an authenticated Admin API endpoint that downloads Ghost/CDN images server-side and requests accessibility-focused alt text from Claude
added Generate controls for feature images and inline Koenig image cards
aligned feature-image alt-text validation with the existing 2,000-character storage limit
protected the Claude API key from imports and exports
added migration, API, service, settings, Ember editor, and Koenig coverage

Why

Writing useful alt text is easy to miss during publishing. This adds an optional editor workflow that generates a concise description while keeping the provider credential server-side. Existing alt text is only replaced after a successful response and is preserved when generation fails.

Koenig now lives in this monorepo, so the inline-image callback and UI are implemented directly in koenig/koenig-lexical without an external package release or dependency version bump.

Validation

285 focused automated tests passed across Ghost Core, Ghost Admin, Admin X settings, and Koenig
Koenig image-card acceptance suite: 38 passed, 2 existing skips
verified the Claude key save, masked, active, clear, and inactive states in Ghost Admin
verified feature-image and inline-image Generate controls in the live editor
verified existing alt text is preserved and inline errors are surfaced when generation is rejected
verified the temporary API key and browser-test draft were removed after testing

no ref - keeps Claude credentials server-side while making the setting available to both Admin clients - aligns feature image alt text validation with the existing 2000-character storage limit

no ref - keeps image fetching and Claude credentials on the server behind an authenticated editor endpoint - validates Ghost image URLs and image data before sending a bounded request to Claude

no ref - gives administrators a built-in integration card for configuring server-side alt text generation - masks saved credentials and provides an explicit clear action so enablement follows key presence

no ref - lets configured editors replace feature image alt text without exposing the Claude key - blocks duplicate requests and preserves existing descriptions when generation fails

Expose the shared image alt text service to Koenig only when Claude is configured so inline cards can use the same protected backend flow as feature images.

no ref Fresh test databases need to reflect migrated installs, and API cleanup keeps the shared settings cache isolated for the rest of the suite.

no ref The upgrade path needs a direct assertion that the versioned migration inserts the nullable setting with the expected type and group.

no ref Koenig now lives in the monorepo, so the feature branch needs the current workspace layout before integrating editor source changes. # Conflicts: # ghost/admin/app/styles/layouts/editor.css

no ref - exposes an optional card callback without coupling the editor package to a provider - replaces image alt text on success while preserving it and showing feedback on failure

no ref Keep the legacy alt toggle structure unless generated alt text controls are visible, avoiding markup regressions for existing image card states.

coderabbitai · 2026-07-14T16:07:10Z

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 937345d9-5c35-494d-a98a-fc7da0e3e7ce

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

github-actions · 2026-07-14T16:07:14Z

nx-cloud · 2026-07-14T16:08:16Z

🤖 Nx Cloud AI Fix

Ensure the fix-ci command is configured to always run in your CI pipeline to get automatic fixes in future runs. For more information, please see https://nx.dev/ci/features/self-healing-ci

View your CI Pipeline Execution ↗ for commit f374753

Command	Status	Duration	Result
`nx run @tryghost/admin-x-settings:test:acceptance`	✅ Succeeded	9m 58s	View ↗
`nx run-many --target=build --projects=tag:publi...`	✅ Succeeded	<1s	View ↗
`nx run ghost:test:ci:integration`	✅ Succeeded	2m 9s	View ↗
`nx run-many -t test:unit -p @tryghost/admin-x-f...`	✅ Succeeded	6m 19s	View ↗
`nx run ghost:test:integration`	✅ Succeeded	2m 48s	View ↗
`nx run ghost:test:legacy`	✅ Succeeded	2m 59s	View ↗
`nx run ghost-admin:test`	✅ Succeeded	2m 57s	View ↗
`nx run @tryghost/koenig-lexical:test:acceptance`	✅ Succeeded	2m 23s	View ↗
`Additional runs (8)`	✅ Succeeded	...	View ↗

💡 Verify your cache is correct by running tasks in a sandbox. Read docs ↗

☁️ Nx Cloud last updated this comment at 2026-07-14 20:17:55 UTC

codecov · 2026-07-14T16:18:45Z

Codecov Report

❌ Patch coverage is 51.02041% with 120 lines in your changes missing coverage. Please review.
✅ Project coverage is 74.00%. Comparing base (0fa9d88) to head (f374753).
⚠️ Report is 17 commits behind head on main.

Files with missing lines	Patch %	Lines
.../services/image-alt-text/image-alt-text-service.js	27.56%	113 Missing ⚠️
.../core/core/server/services/image-alt-text/index.js	66.66%	7 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #29317      +/-   ##
==========================================
+ Coverage   73.99%   74.00%   +0.01%     
==========================================
  Files        1572     1580       +8     
  Lines      136697   137062     +365     
  Branches    16520    16585      +65     
==========================================
+ Hits       101143   101438     +295     
- Misses      34560    34615      +55     
- Partials      994     1009      +15

Flag	Coverage Δ
admin-tests	`55.43% <100.00%> (+0.53%)`	⬆️
e2e-tests	`76.09% <46.18%> (-0.01%)`	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

vitrixbot added 10 commits July 14, 2026 16:41

✨ Added Claude alt text integration settings

71ef743

no ref - keeps Claude credentials server-side while making the setting available to both Admin clients - aligns feature image alt text validation with the existing 2000-character storage limit

✨ Added Claude image alt text API

f28c8f8

no ref - keeps image fetching and Claude credentials on the server behind an authenticated editor endpoint - validates Ghost image URLs and image data before sending a bounded request to Claude

✨ Added Claude integration settings UI

2bed78a

no ref - gives administrators a built-in integration card for configuring server-side alt text generation - masks saved credentials and provides an explicit clear action so enablement follows key presence

✨ Added feature image alt text generation

3a95b82

no ref - lets configured editors replace feature image alt text without exposing the Claude key - blocks duplicate requests and preserves existing descriptions when generation fails

✨ Added generated alt text to Koenig editor

2aeba85

Expose the shared image alt text service to Koenig only when Claude is configured so inline cards can use the same protected backend flow as feature images.

Fixed Claude settings API regression coverage

12344e1

no ref Fresh test databases need to reflect migrated installs, and API cleanup keeps the shared settings cache isolated for the rest of the suite.

Added Claude setting migration regression coverage

077266b

no ref The upgrade path needs a direct assertion that the versioned migration inserts the nullable setting with the expected type and group.

Merged current Ghost main into Claude alt text branch

f7282c9

no ref Koenig now lives in the monorepo, so the feature branch needs the current workspace layout before integrating editor source changes. # Conflicts: # ghost/admin/app/styles/layouts/editor.css

✨ Added generated alt text to Koenig images

f95dcee

no ref - exposes an optional card callback without coupling the editor package to a provider - replaces image alt text on success while preserving it and showing feedback on failure

🐛 Preserved Koenig image card markup

150eda9

no ref Keep the legacy alt toggle structure unless generated alt text controls are visible, avoiding markup regressions for existing image card states.

github-actions Bot added the migration [pull request] Includes migration for review label Jul 14, 2026

vitrixbot added 2 commits July 14, 2026 21:04

Fix Claude settings migration version

f4aff65

Fix Claude migration test path

f374753

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

Added Claude-powered image alt text generation#29317

Added Claude-powered image alt text generation#29317
vitrixbot wants to merge 12 commits into
TryGhost:mainfrom
vitrixbot:codex/claude-alt-text

vitrixbot commented Jul 14, 2026

Uh oh!

coderabbitai Bot commented Jul 14, 2026 •

edited

Loading

Review skipped

Uh oh!

github-actions Bot commented Jul 14, 2026

Uh oh!

nx-cloud Bot commented Jul 14, 2026 •

edited

Loading

Uh oh!

codecov Bot commented Jul 14, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Uh oh!

Conversation

vitrixbot commented Jul 14, 2026

What changed

Why

Validation

Uh oh!

coderabbitai Bot commented Jul 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review skipped

Uh oh!

github-actions Bot commented Jul 14, 2026

General requirements

Schema changes

Data changes

Uh oh!

nx-cloud Bot commented Jul 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🤖 Nx Cloud AI Fix

Uh oh!

codecov Bot commented Jul 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

coderabbitai Bot commented Jul 14, 2026 •

edited

Loading

nx-cloud Bot commented Jul 14, 2026 •

edited

Loading

codecov Bot commented Jul 14, 2026 •

edited

Loading