README.md

GitHub Release Posts for WordPress

Automatically generate blog posts from GitHub releases using AI.

A WordPress plugin that monitors GitHub repositories for new releases and uses AI to research each release and generate a human-readable blog post about it. Posts can be automatically published or held as drafts for review, with email notifications when new posts are ready.

Built by Jake Goldman, founder of 10up, and now a Partner / Advisor at Fueled since the merger with 10up.

How it works

1. Monitor — Add any GitHub repository and the plugin checks for new releases daily via WP-Cron.
2. Generate — When a new release is detected, the AI researches the release and writes a blog post tailored to your audience.
3. Publish — Posts are created as drafts for review, or published automatically based on your per-repository settings.

You can also generate a post on demand at any time from the Repositories tab.

Screenshots

Repositories tab

Monitor multiple GitHub repos with last post version, status, and one-click post generation.

Settings tab

View your AI connector status and configure audience level, custom prompt instructions, and notifications.

Inline editing

Per-repo settings including name, project link, post status, author, categories, tags, and featured image — following the familiar WordPress Quick Edit pattern.

Generated post in the block editor

AI-written content with embedded images, plus the GitHub Release sidebar panel for source attribution and regeneration.

Features

• Monitor multiple GitHub repositories for new releases
• AI-powered post generation via WordPress Connectors — works with Anthropic, OpenAI, Google, and any other configured connector
• Significance-aware content — patch, minor, major, and security releases get tailored tone and structure
• Choose the research depth — Standard reviews release notes, linked issues and PRs, metadata, and the README; Deep adds commit messages and file changes since the last release
• SEO-friendly post slugs and excerpts generated automatically by AI
• Configurable publish/draft workflow with per-repository overrides
• Per-repository post defaults (categories, tags, post status, author, featured image)
• Custom prompt instructions to guide AI writing style, tone, and voice
• Regenerate posts with feedback — refine AI output directly from the block editor sidebar
• Email notifications on draft creation, publication, or both
• Source attribution in the block editor — see which GitHub release generated each post
• Idempotency — the same release never creates duplicate posts
• Optional project link support — enter a URL or WordPress.org slug for download CTAs
• Optional AI disclosure note appended to generated posts

Requirements

• WordPress 7.0 or later
• PHP 8.2 or later
• At least one AI connector configured under Settings → Connectors (Anthropic, OpenAI, or Google recommended)

Installation

1. Download the latest release zip from Releases.
2. In WordPress admin, go to Plugins → Add New → Upload Plugin and upload the zip.
3. Activate the plugin.
4. Go to Tools → Release Posts to configure your AI provider and add repositories.

For developers

Filters

The plugin is extensible via filter hooks at every stage of the pipeline:

Filter	Purpose
ghrp_default_post_status	Default status when creating a repo (default: draft)
ghrp_default_categories	Default categories for new repos
ghrp_default_tags	Default tags for new repos
ghrp_post_status_options	Post status dropdown choices
ghrp_post_status	Override status per-release before it's applied
ghrp_post_terms	Override categories/tags per-release
ghrp_post_featured_image	Override featured image per-release
ghrp_ai_disclosure_text	Customize or suppress the AI disclosure note
ghrp_max_release_body_length	Truncation threshold for large release bodies
ghrp_sideload_allowed_domains	Domains allowed for image sideloading
ghrp_check_frequency	WP-Cron schedule (default: daily)
ghrp_register_ai_providers	Register custom AI provider connectors
ghrp_wp_ai_client_model_preferences	Ordered list of preferred model IDs for WordPress Connectors
ghrp_openai_reasoning_effort	Reasoning effort level for OpenAI models (default: high)
ghrp_generate_prompt	Full prompt customization
ghrp_release_body	Filter release body before prompt building

Custom AI providers

Register a custom provider by implementing AIProviderInterface and hooking into ghrp_register_ai_providers:

add_filter( 'ghrp_register_ai_providers', function( $providers ) {
    $providers['my_provider'] = new My_Custom_Provider();
    return $providers;
} );

Development

npm start                # Dev build with watch
npm run build            # Production build
composer install          # Install PHP dependencies
composer test             # Run PHPUnit tests
vendor/bin/phpcs --standard=phpcs.xml.dist includes/  # WPCS lint

License

GPL-2.0-or-later. See LICENSE.

Trademarks

GitHub Release Posts is an independent project. It is not affiliated with, endorsed by, or sponsored by GitHub, Inc. or the WordPress Foundation. "GitHub" and "WordPress" are used here for descriptive purposes only.

Like what you see?