Fresh Eyes: AI Editorial Feedback

By Adam Silverstein

0+ active installationsVersion 1.0.3

A fresh pair of eyes on your draft: AI feedback, suggested edits and quick fixes, left as notes on your blocks in the editor.

Description

Fresh Eyes is an AI agent that reviews your posts right in the block editor, like a fresh pair of eyes on a story before it runs. It leverages the WordPress 7.0 core AI Client and Connectors API for provider-agnostic AI access, and uses the native Notes API to provide contextual, block-level feedback on your content.

Features

  • 🤖 AI-Powered Reviews: Intelligent feedback on content quality, tone, flow, and design
  • 📝 Native Notes Integration: Feedback appears as WordPress block comments
  • 🔌 Core Connectors API: Uses the credentials you’ve already configured in Settings → Connectors
  • 🔄 Multiple AI Providers: Works with Anthropic, OpenAI, Google, and any other registered AI provider
  • 🎯 Focus Areas: Content Quality, Tone & Voice, Flow & Structure, Design & Formatting

Requirements

  • WordPress: 7.0 or higher
  • PHP: 8.1 or higher
  • AI Provider: At least one provider configured under Settings → Connectors

Development

The plugin is actively developed on GitHub:
https://github.com/adamsilverstein/fresh-eyes

Contributions are welcome.

Credits

  • Built on the WordPress 7.0 core AI Client and Connectors API
  • Uses the WordPress Notes API for block-level comments

Installation

Prerequisites

WordPress 7.0 introduced the core AI Client and Connectors API. Fresh Eyes uses both directly — there is no longer any custom AI plumbing or separate “AI Experiments” plugin to install.

Before using Fresh Eyes, configure an AI provider:

  1. In WordPress admin, go to Settings → Connectors.
  2. Pick a provider (Anthropic, OpenAI, Google, etc.) and add an API key, or define one as an environment variable / PHP constant.
  3. Save.

Installing Fresh Eyes

  1. Upload the plugin to /wp-content/plugins/fresh-eyes/, or install via the WordPress plugins screen.
  2. Activate the plugin through the Plugins screen.
  3. Open any post in the block editor — the Fresh Eyes panel appears in the sidebar.

FAQ

What AI providers are supported?

Any text generation provider connected through the WordPress 7.0 core AI Client. Settings → Connectors lists Anthropic, OpenAI, and Google, and installs each provider’s plugin when you set it up. Other providers can be added with their own AI provider plugins.

Where do I configure my API key?

Settings → Connectors. The Connectors API also supports environment variables (e.g. ANTHROPIC_API_KEY) and PHP constants for credentials, taking precedence over database-stored values.

What version of WordPress do I need?

WordPress 7.0 or higher. Earlier versions are not supported because the plugin relies on wp_ai_client_prompt() and the Connectors API.

Can I customize the feedback focus areas?

Yes. The plugin provides Content Quality, Tone & Voice, Flow & Structure, and Design & Formatting focus areas, and you can pick which ones to apply per review.

Is my content sent to external services?

Yes — your content is sent to whichever AI provider you’ve configured in Settings → Connectors. Please review your provider’s privacy policy and terms of service.

Screenshots

Changelog

1.0.3

  • Renamed the plugin to Fresh Eyes: AI Editorial Feedback. The text domain is now fresh-eyes.
  • The notes and settings REST routes now require per-post and administrator capabilities.
  • Requirement notices only show on the Plugins and Updates screens.

1.0.2

  • AI replies to notes are now answered from the editor, so they no longer depend on WP-Cron.
  • The Try again button waits out the short retry cooldown after a failed AI reply, with a hint next to it.
  • Replies that were left waiting are answered when the post is next opened in the editor.
  • AI suggestion markers stay credited to the note’s author.
  • Note badges are kept when a note’s status is saved.
  • AI notes are re-linked to their blocks after reloading an unsaved post.
  • The next and previous feedback shortcuts work after a reload.
  • Review settings show before the first review and collapse after it.
  • Review History shows times in the site timezone.

1.0.1

  • Renamed the plugin to Copydesk AI for the WordPress.org plugin directory. The text domain is now copydesk-ai.
  • Load translations for the editor script.

1.0.0

  • First stable release.
  • Quick fixes: apply mechanical text changes straight from a note, with a preview of the old and new wording.
  • Quick fixes are added as Gutenberg suggestions when Suggestion Mode is on, so they can be accepted or rejected.
  • Reply to an AI note and get an AI answer in the same thread; replies are answered right away in the editor, with WP-Cron as the fallback.
  • Feedback items are scored by priority, with quick actions in the sidebar.
  • Large documents are reviewed in chunks, and the sidebar updates after each part.
  • Staged progress during a review, and retries when the AI service is unavailable.
  • Review history panel, plus export and share options for reviews.
  • Usage analytics screen.
  • Keyboard shortcuts for running a review and moving between feedback items.
  • Contextual tooltips in settings and progressive tips for new users.
  • Accessibility fixes: review errors are announced once, with an “Error:” prefix.
  • Bug fixes from plugin testing.

0.2.0

  • Migrated to the WordPress 7.0 core AI Client (wp_ai_client_prompt()).
  • Adopted the WordPress 7.0 Connectors API for credential management; the AI Experiments plugin is no longer required.
  • Bumped minimum requirements to WordPress 7.0 and PHP 8.1.
  • Removed the wordpress/php-ai-client Composer dependency.
  • Updated onboarding and error messaging to point users at Settings → Connectors.
  • Default model is now Claude Sonnet 5.5; a saved default that is no longer offered falls back to it.
  • Rate-limited AI requests are now retried with backoff; auth and billing failures still fail fast.
  • AI requests use a 60 second timeout (filterable via ai_feedback_http_timeout) instead of core’s 30 second default.

0.1.0

  • Initial release.
  • Plugin scaffold with build system.
  • Settings UI and REST API.
  • Model selection with provider grouping.
  • Focus areas and tone selection.
  • Review button with loading states.