Releases

What's New in Respira CLI v0.1.0

The modern WordPress command line for developers working with AI coding agents.

Three npm packages

• @respira/cli: the oclif-based CLI with 29 commands across auth, sites, read, write, find-element, tools, docs, snapshots, exec, init-claude-code
• @respira/sdk: the typed TypeScript client with zod validation on every method
• @respira/cli-core: shared auth store (OS keychain with file fallback), output formatter, and API client with retry plus rate-limit handling

Anonymous mode

• respira read structure <url> works on any public WordPress site with no account
• respira read design-system <url> returns colors, fonts, and spacing from any public site

Builder-native

• Elementor, Divi (4 and 5), Bricks, WPBakery, Beaver Builder, Oxygen, Breakdance, Brizy, Thrive Architect, Flatsome UX Builder, native Gutenberg blocks, plus WooCommerce

Safety-first

• Every write creates a snapshot first
• --dry-run on every write command
• --diff on write edit-page and write edit-element emits before/after for agent review
• Destructive operations require --confirm

AI agent integrations

• respira init-claude-code sets up Claude Code in the current directory with a skill + shortcut commands
• JSON output when piped, so every agent framework can consume results

Installation

npm install -g @respira/cli
respira auth login
respira sites list

Documentation: /cli/introduction. Source: github.com/respira-press/respira-wordpress-cli.

Not a WP-CLI replacement. WP-CLI is excellent for server-side WordPress administration and the two tools are complementary.

What's New in 7.4.0 "Clearing"

What the agent writes is what actually lands on the page. A deep pass through every supported builder, closing the gaps where a write reported success but the page stayed stale or blank.

Styling now lands

• Oxygen, Beaver Builder, Elementor v4 Atomic, Bricks, Divi 4 and Divi 5: style writes that previously saved to the database without changing the rendered page now render, each verified against the real front-end page.

Two builders moved from read to write

• Brizy: writes pages the Brizy editor opens and the front end renders. Front-end compile depends on Brizy's cloud compiler service, so the site needs internet.
• Visual Composer: writes in VC's canonical storage format. The editor loads the page, the front end renders, and VC recompiles on the next editor save.

Recovery goes deeper

• Custom CSS and page settings are now captured, and global objects are versioned: deleting a Bricks global class, a Divi preset, or an Elementor kit color leaves a recovery point.

Writes fail loudly, not silently

• When a value cannot be persisted in a shape the builder reads, Respira names exactly what did not land instead of reporting success, which cuts the retry loops that waste tokens.

12 builder legs verified end-to-end on real installs. Full notes: respira.press/releases/7.4.0.

What's New in 7.3.0

Reversibility extends past page edits to destructive structure operations and whole-session cascades.

• Cascade rollback (session-level recovery). Deleting an ACF field group, custom post type, or taxonomy, or changing an option, now captures a recovery snapshot first. A whole-session restore rolls back a multi-step destructive mess in one call, returning every object the session touched to its pre-session state. New MCP tools wordpress_begin_session / wordpress_end_session / wordpress_restore_session.
• The ACF structures the agent builds are editable and correctly typed.
• Images sideload into the media library by default.

Verified end to end on a local Bricks + Elementor + ACF environment.

What's New in 7.2.0

Connect AI apps to your site with a one-time browser sign-in, no API key and no file.

• Connect by browser sign-in (OAuth 2.0). Claude Desktop, claude.ai, Claude Code, ChatGPT (Developer Mode), Cursor, and Codex add your site as a custom connector by URL. The app discovers respira.press as the authorization server, you approve access once in the browser, and a site-scoped token is minted.
• Backward compatible: the existing API-key, connect-by-link, and .mcpb paths keep working exactly as before.

What's New in 7.1.0 "Roots"

The biggest release since launch: a rebuilt React admin around live telemetry, and the plugin ability ecosystem made safe to use.

• Four new builders, 16 total: Spectra, Kadence Blocks, GenerateBlocks, and SeedProd (audit-only).
• Playbooks: teach an agent a multi-step workflow once, then rerun it as one callable WordPress ability.
• Custom Structures: agents create custom post types, taxonomies, and ACF field groups.
• Redesigned admin: a React-first wp-admin with a bridge view of agent ↔ Respira ↔ site, driven by eleven new REST endpoints.
• Public add-on SDK so third-party plugin authors can register their own MCP abilities.
• generate_activity_report: turns your audit log into a client-ready report your own agent shapes into prose.

What's New in 7.0.0 "Bloom"

Every page-builder adapter promoted to deeper-intelligence parity, in lockstep.

• Five cross-cutting invariants every adapter now inherits: render-validation gate, universal write-trace, Variables CRUD shape, source-driven catalog auto-scan, and per-property typed validators.
• Per-builder slices close the family-bug arcs surfaced across the 6.10.x line.
• 1076 standalone test assertions across 27 alpha cycles, zero failures.

What's New in 6.11.0 "Self-Heal"

A bug-bash release. Closes 14 customer-reported bugs across 5 named trial threads and all 7 open public GitHub issues, plus 5 cross-cutting audits.

• New respira_diagnose_connection tool surfaces edge-layer interception, so REST returning homepage HTML instead of JSON stops being opaque.
• JSON post-meta unicode safety across every adapter, MCP tool-schema audit, duplicator kses bypass fix, and render-trace fields on every write.

What's New in 6.6.0 "ACF Intelligence"

54 Advanced Custom Fields tools covering field reads and writes, field-group management, ACF Pro repeaters, flexible content, galleries, options pages, relationships, and bulk updates.

• Every write snapshot-backed and dry-run previewable.
• Works on the roughly 2 million WordPress sites that use ACF today.

What's New in 6.2.0 + 6.3.0 "Deep Intelligence"

The deepest Oxygen and Breakdance MCP integrations available.

• Oxygen (6.2.0): 49 components, 140+ schema properties, a fuzzy-matching settings validator, a data-repair pipeline, Oxygen 6 detection, and 10 layout patterns.
• Breakdance (6.3.0): 84 elements across 7 categories, 120+ schema properties, nesting validation, fuzzy matching, content/design preservation, and 8 layout patterns.

What's New in 6.0.0 "Storefront"

Three coordinated releases. Twelve builders. Real commerce. One layer.

Flatsome UX Builder — Builder #12

• Full support for the most popular WooCommerce theme on ThemeForest (200K+ sales)
• 55 element definitions with attributes, nesting rules, and responsive patterns
• Shared ShortcodeParser utility for Divi 4 and Flatsome with strict tag allowlists
• Theme-based detection, mixed-builder site support, snapshots on every write

15 New WooCommerce Commerce Tools (36 total)

• Storefront design intelligence: analyze_shop_page, analyze_product_page, update_product_card_layout, add_low_stock_badge, add_sale_badge, update_checkout_layout
• Catalog operations: list_products_advanced, bulk_update_products, analyze_catalog_health, find_product_by_natural_language
• Pricing: bulk_update_prices (with dry-run), schedule_sale, revert_pricing
• Inventory: bulk_update_stock, find_low_stock
• All write tools create snapshots. 100-product hard cap on bulk operations.

Bundled WooCommerce Entitlement

• Studio and Founder plans now include the WooCommerce add-on at no extra cost
• Maker and Builder continue to purchase separately at €95/year

Context-Aware MCP Tool Filtering (MCP Server v6.0.0)

• Tools automatically filtered by detected builder and active plugins
• ~170 tools reduced to ~130 on typical sites
• Fail-open: full list returned if detection fails
• Cached with 1-minute TTL, invalidated on site switch

Bug Fixes

• Metrics undercounting: missing direct_edit_page, direct_edit_post, create_custom_post, update_custom_post, force_edit_custom_post actions
• Founder plan capacity: shows Unlimited instead of 999
• TagDiv/Newspaper detection: routes to WPBakery (TagDiv) instead of Gutenberg
• WooCommerce snapshot gap: all existing write tools now create before/after snapshots

Download: v6.0.0 on GitHub | WooCommerce Add-on v2.0.0 | Release notes

What's New in 5.5.3

Divi 5 Fixes

• inject_builder_content, update_element, batch_update, move_element — all Divi 5 mutations now correctly update the visual builder. The root cause: Divi's convert_divi_blocks_before_save filter was stripping block content from revisions created via wp_save_post_revision(). Revisions are now written directly to the database, bypassing Divi's filter.
• Trial badge no longer stuck after license upgrade — transient cache cleared on validation.

Divi 5 Simplified Settings Schema

• All divi/* modules now accept a settings object with 30+ shorthand keys for content and styling.
• Content: title, content, body, button_text, button_url, src, alt, url, author, job_title, number, etc.
• Styling: background_color, text_color, font_family, font_size, font_weight, text_alignment, padding, margin, heading_color, heading_font, heading_font_size, header_level/tag, button_color, button_bg_color, button_border_color, column_structure.
• New divi/person module definition.

See Divi 5 Simplified Settings for the full reference with examples.

Download: v5.5.3 on GitHub

What's New in 5.2.0 "Elemental"

The biggest upgrade to Respira's page builder intelligence. 39 new tools. 125 total.

Element-Level Editing (7 tools)

• find_element, update_element, move_element, duplicate_element, remove_element, batch_update, reorder_elements — target individual widgets without downloading the entire page.

Page Building

• build_page — create a complete page from a declarative structure in one API call. Returns preview URL.
• 27 widget shortcuts: add_heading, add_button, add_image, add_text, add_video, and 22 more.

HTML-to-Builder Conversion

• convert_html_to_builder — converts HTML/CSS prototypes into native builder content with CSS extraction, section mapping, style translation, and fidelity scoring.

Bulk Operations

• bulk_pages_operation — apply changes across up to 100 pages. Built-in ops: strip_inline_styles, find_and_replace, custom. Rate-limited with mandatory snapshots.

Stock Images

• search_stock_images and sideload_image — search Openverse, sideload with CC attribution, SSRF-protected.

Tool Governance

• Admin UI to disable/enable any MCP tool per-site. Single enforcement chokepoint for REST, Abilities API, and MCP.

API Key Access Profiles

• Generate keys with scoped permissions: Full Access, Read Only, Content Editor, or Builder. Two-layer security with governance.

Builder Intelligence

• Elementor dynamic schemas — runtime widget schema generation with "did you mean?" validation.
• Divi 5 intelligence — 40+ modules, 7 page patterns, design tokens, 13-point validation.
• Beaver Builder HTML conversion pipeline.
• Bricks CSS regeneration on inject and approval merge.
• Oxygen ct_template detection fix (checks both meta keys).

Infrastructure

• Version migration engine for safe upgrades from any previous version.
• Dual tool naming: respira_* (preferred) alongside deprecated wordpress_*.
• Version negotiation endpoint + plugin version header.
• UTF-8 passthrough for multibyte characters.
• Frontend cache purge for 9 cache plugins.
• RankMath SEO analysis tool.
• Direct edit mode — writes go straight to original when enabled.
• Top API Keys dashboard table for usage visibility.

Fixes: Oxygen ct_template detection, SQLite/Playground compatibility, trial-to-paid license orphans, duplicate admin banners, direct edit mode, trial emails for paid users, Gemini MCP schema compliance, Bricks approval merge cache.

Recommended Versions

• Respira for WordPress plugin: 5.2.0+
• MCP server: 5.2.0+

What's New

• Fixed character-based length counting for SEO meta title/description (was byte-based — Cyrillic showed ~1.75x actual length).
• Fixed Unicode-aware word tokenizer for non-ASCII scripts in word count and keyword density.
• Fixed Open Graph detection for RankMath, AIOSEO, and SEOPress (was only detecting Yoast).
• Fixed schema detection for RankMath and AIOSEO sites.

What's New

• Fixed include: "meta" now resolves to meta.allowlisted as expected.
• Fixed Divi Theme Builder meta writes reflected in before/after hashes.
• Added 10 Divi Theme Builder meta keys to the default allowlist.

What's New

• Added Bricks browser_events map for WebMCP DOM event awareness.
• Added Bricks duplicate filter gate for ID-dedup sync.
• Fixed Bricks 2.2 "inject succeeds but frontend shows no change" — CSS regeneration now fires on every inject.
• Fixed wrong Bricks meta key in AI context (missing _2 suffix).

What's New

• Added agency-first MCP setup from dashboard: account-wide multi-site export now includes stacked Starter + Agency inventory.
• Added guided MCP setup paths in dashboard: file downloads, one-time install command, and AI setup prompt.
• Added stronger setup security guidance for config/token handling and token rotation.
• Added safer write routing for original content: explicit confirmation flow for live vs duplicate targets when direct editing is enabled.
• Improved MCP token efficiency defaults with compact responses and better patch/discovery flows.

Recommended Versions

• Respira for WordPress plugin: 4.2.0+
• MCP server: 4.0.0+

What's New

• Clarified how Respira fits into the official WordPress Abilities API and MCP Adapter stack.
• Documented the four supported surfaces: standalone MCP server, default/public adapter server, dedicated Respira adapter server, and browser surfaces.
• Added dedicated docs for WordPress AI Stack Compatibility and Elementor Angie.
• Updated browser and desktop setup docs so the official adapter is presented as a compatible path rather than a separate product story.

Latest stable plugin version

Download: respira-for-wordpress-4.0.7.zip

What's New

• Fixed Elementor URL-control validation crashes by handling link-field array payloads before URL sanitization.
• Hardened fallback Elementor save path to clear _elementor_element_cache when direct _elementor_data writes are used.
• Added regression coverage for Elementor root-only wrapping and fallback save behavior.
• Added normalized X-Respira-Agent-* telemetry capture across plugin and MCP flows for clearer client attribution in logs/stats.

Recommended For

• All Elementor users, especially if you saw intermittent 500s during module updates.

Download

respira-for-wordpress-4.0.7.zip

What's New

• Strengthened Elementor payload normalization to prevent nested/double-serialized _elementor_data saves.
• Added type coercion guards to stop array payloads from reaching scalar sanitizers (ltrim()-style crashes).
• Added WooCommerce taxonomy CRUD parity for categories/tags and product assignment support.
• Updated Browser AI/WebMCP inventory contracts to current tool registry totals.

What's New

• Major wp-admin IA/UX refresh in 4.0.0 (Overview, Setup, Approvals, Reports, Add-ons, Logs, Settings).
• 4.0.1-4.0.3 shipped Elementor write-flow hardening and structured diagnostics for MCP clients.
• 4.0.2 centralized editing controls under Respira → Settings, with Setup → Health & Permissions as a focused read-only summary.
• 3.3.1 updated official WordPress MCP Adapter compatibility (mcp_adapter_init + legacy fallback).

What's New

• Added Divi 5 documentation and Migration Copilot toolkit docs.

Latest stable version

Download: respira-for-wordpress-1.9.1.zip

What's New

• Custom post updates (meta + CSS) - Update custom post types with meta and customCss
• Builder-aware Custom CSS - Detects Divi/Elementor and saves CSS to the right place
• Elementor CSS regeneration - Automatically clears/regenerates Elementor CSS cache after updates

Features

• Safe editing with automatic page duplication
• No SSH required, works with any WordPress hosting
• Built-in security validation for XSS and SQL injection
• Support for 12 page builders: Gutenberg, Divi, Elementor, WPBakery, Oxygen, Bricks, Beaver Builder, Brizy, Visual Composer, Thrive Architect, Breakdance
• Full menu management with hierarchy
• Taxonomy management (categories, tags, custom)
• User and comment management
• SEO, AEO, and performance analysis
• Core Web Vitals monitoring
• WPML multilingual support
• Complete audit logging

Download

respira-for-wordpress-1.8.41.zip

Notes

• Stability improvements
• Performance optimizations
• Page builder compatibility enhancements

Download

respira-for-wordpress-1.8.40.zip

Notes

• Added custom CSS API endpoints
• Enhanced Elementor cache management
• Improved builder detection

Latest MCP server version

Install: npx @respira/wordpress-mcp-server

npm: @respira/wordpress-mcp-server

What's New

• Added normalized agent telemetry headers on WordPress requests (X-Respira-Agent-*).
• Setup/discovery now sends the same agent signature headers as runtime tool calls.

What's New

• Added WooCommerce taxonomy tools for categories and tags (list/get/create/update/delete).
• Added product category/tag assignment fields to MCP write schemas.
• Updated Desktop MCP inventory contract to 82 WordPress tools + 21 WooCommerce tools (103 total with add-on active).

Compatibility

• Requires WooCommerce add-on 1.0.2+ for taxonomy endpoint execution.

What's New

• Added once-per-day npm update checks with a persistent local cache.
• Added respira_mcp_update prompt hints when a newer MCP version is available.
• Improved 5xx error handling so WordPress critical errors surface structured diagnostics.

Notes

• Set RESPIRA_MCP_DISABLE_UPDATE_CHECK=1 to disable the automatic update check.

What's New

• Added automatic v2 capability negotiation (/wp-json/respira/v2/status) with v1 fallback.
• Added snapshot toolchain support (list/get/diff/restore) and builder patch support.
• Added include-driven fidelity reads for richer context payloads.

Latest MCP server version

Install: npx @respira/wordpress-mcp-server

npm: @respira/wordpress-mcp-server

What's New

• Custom post meta support - wordpress_update_custom_post accepts meta for arbitrary post meta
• Custom CSS support - wordpress_update_custom_post accepts customCss (builder-aware)
• Compatibility guard - Requires Respira for WordPress plugin v1.9.1+ for these custom post updates

Features

• 11 page builder support (Divi, Elementor, Bricks, Oxygen, Gutenberg, Breakdance, etc.)
• Module-level content updates
• Duplicate-before-edit safety
• SEO and performance analysis with Core Web Vitals
• WPML multilingual support
• Full menu management with hierarchy

CLI Options

npx @respira/wordpress-mcp-server --setup   # Run setup wizard
npx @respira/wordpress-mcp-server --list    # List configured sites
npx @respira/wordpress-mcp-server --test    # Test default site connection
npx @respira/wordpress-mcp-server --help    # Show help

Notes

• Fixed axios interceptor async handling
• Resolved [object Promise] error in plugin installation
• Improved error messaging

Notes

• Updated npm package description
• Added SEO-focused keywords
• Improved documentation

Free version for WordPress.org

A limited free version with Gutenberg support.

Features

• Gutenberg (Block Editor) support
• 30 edits per month
• 3-day audit log
• Read-only menu endpoints
• Read-only taxonomy endpoints
• Security validation (XSS, SQL injection)
• REST API access

What's New in 1.0.2

• Added /usage endpoint for checking edit limits
• Added read-only menu endpoints (GET /menus, GET /menus/{id})
• Added read-only taxonomy endpoints
• Added read-only taxonomy endpoints
• Added 3 API key limit enforcement
• Added automatic audit log cleanup