Ray Bogman AI Sync for Jekyll & GitHub Pages

Ray Bogman AI Sync for Jekyll & GitHub Pages lets you edit content in WordPress and publish it to a Jekyll site hosted on GitHub Pages. Jekyll and GitHub are projects/trademarks of their respective owners; this plugin is an independent integration and is not affiliated with or endorsed by either.

Features:

• One-click “Login with GitHub” — OAuth login, no manual token pasting
• Live repository picker — all your repos load instantly after login via AJAX
• Live branch picker — select a repo and branches load automatically, no page refresh
• Top-level Jekyll Sync admin menu with Dashboard, Articles, and Settings subpages
• Articles list with Approved toggle per item, type filter, search, per-row push/preview/AI/diff/delete/verify
• Bulk Publish approved to Jekyll button + bulk actions for approve, push, delete
• Converts post HTML to Markdown with Jekyll YAML front matter
• Style-aware conversion — reads your existing Jekyll site’s _config.yml and sample posts to match its front matter schema, permalink pattern, and Markdown conventions
• Featured & inline image sync — uploads images to your Jekyll repo and rewrites URLs to Jekyll-native paths
• Internal link rewriting — WordPress domain links automatically rewritten to your Jekyll site URL
• AI SEO descriptions (optional) — Claude or OpenAI generates 1-2 sentence descriptions on demand
• AI image alt text (optional) — Claude or OpenAI vision describes images missing alt text
• Two-way sync — pull Jekyll posts back into WordPress as drafts
• Scheduled auto-sync — WP-Cron based intervals (1/6/12/24 hours)
• Auto-push on publish — push automatically when WordPress posts are published or updated
• Sync verification — compare stored push hash against the live Jekyll file
• Diff view — preview color-coded additions/deletions before re-pushing
• Sync history log — every push, pull, and delete recorded with user, post, path, and result
• GitHub Actions trigger — optionally dispatch a build workflow after each push
• SEO plugin support — auto-detects Yoast SEO and RankMath meta descriptions and focus keywords
• Per-post sidebar meta box

External Services

This plugin connects to external third-party services depending on your configuration:

WordPress 7.0+ — preferred path: When running on WordPress 7.0 or newer and the site owner has configured a provider through the core AI Client, AI SEO description generation is routed through that core AI Client first (wp_ai_client_prompt() → generateText()). In that case the plugin never contacts api.anthropic.com or api.openai.com directly — the request goes to whichever provider the site owner has set up at the site level, with credentials managed by WordPress core. The plugin’s own direct integrations below are used only as a fallback on older WordPress versions, or when no core provider has been configured.

GitHub API

• Service: GitHub REST API
• Used for: OAuth authentication, listing repositories and branches, reading and writing Jekyll post files, uploading images, deleting files, triggering GitHub Actions workflows.
• When: Every time you push, pull, delete, verify, or detect styles from your Jekyll repository.
• Data sent: Your GitHub OAuth token, post content as Markdown, image files, commit messages.
• GitHub Terms of Service
• GitHub Privacy Statement

Anthropic Claude API (Optional)

• Service: Anthropic Messages API
• Used for: AI-generated SEO descriptions and image alt text.
• When: Only when you click “Generate” in the AI panel or enable auto-generation. Never called without user action.
• Data sent: Post text content (up to 2000 characters) for descriptions. Image data (base64 encoded) for alt text generation.
• Requires: A valid Claude API key entered by the user.
• Anthropic Terms of Service
• Anthropic Privacy Policy

OpenAI API (Optional)

• Service: OpenAI Chat Completions API
• Used for: AI-generated SEO descriptions and image alt text (alternative to Claude).
• When: Only when you click “Generate” in the AI panel or enable auto-generation. Never called without user action.
• Data sent: Post text content (up to 2000 characters) for descriptions. Image data (base64 encoded) for alt text generation.
• Requires: A valid OpenAI API key entered by the user.
• OpenAI Terms of Use
• OpenAI Privacy Policy