Give any AI coding agent direct access to your Bricks Builder site. Build pages, migrate content, and orchestrate multi-tool workflows — all from a single prompt.

CLI, Desktop App, and WordPress Plugin for Bricks Builder.

Download the plugin ZIP from the latest release and upload it in WordPress under Plugins > Add New > Upload Plugin. Then go to Settings > Agent to Bricks and generate an API key.

If the sidebar menu item is missing, use the plugin's Settings link on Plugins > Installed Plugins, or open /wp-admin/admin.php?page=agent-bricks-settings directly. Short help URL: agenttobricks.com/menu-missing.

Download the binary for your platform from the latest release:

# macOS (Apple Silicon)
tar xzf agent-to-bricks_*.tar.gz
mv bricks /opt/homebrew/bin/

# Linux
tar xzf agent-to-bricks_*.tar.gz
mv bricks ~/.local/bin/

bricks config init          # interactive setup
bricks site info            # verify connection

bricks site pull 42 -o page.json
# ... let your AI agent edit page.json or generate a patch
bricks site push 42 page.json

Full installation guide | Quick start

All documentation lives at agenttobricks.com:

• Getting Started
• CLI Reference
• Desktop App Guide
• Plugin Reference
• Guides

bricks update              # update CLI + plugin
bricks update --check      # check without installing

The Desktop App checks for updates automatically on launch.

• Added query-aware discovery with bricks site features, bricks site query-elements, and query metadata in bricks search elements.
• Added WooCommerce discovery commands plus GUI @query, @product, @product-category, and @product-tag mentions.
• Extended WordPress Abilities coverage with site/query/Woo discovery abilities and verified the full flow on ts-staging.
• Hardened the staging SSH workflow for first-connect deploys while keeping the full plugin, CLI, template, and GUI release gate intact.

See CHANGELOG.md for the full release summary.

• Machine-Readable CLI — bricks schema outputs a JSON manifest of all commands. Structured error codes, --format json on every command, and stdin pipelines make the CLI fully automatable by AI agents.
• Query & Woo discovery — bricks site features, bricks site query-elements, and bricks woo ... expose query-capable Bricks elements plus WooCommerce products, categories, and tags without scraping wp-admin.
• WordPress Abilities API — Auto-discovers plugin abilities (Yoast, WooCommerce, Gravity Forms, etc.) and includes them in AI prompts. Requires WordPress 6.9+.
• CSS Framework Support — Scans ACSS, Cwicly, and theme CSS files for custom properties. Colors and variables appear in @color and @variable autocomplete.
• Page-Specific and commerce-aware @mentions — @element and @section use a two-step flow, while @query, @product, @product-category, and @product-tag resolve live site and WooCommerce context in the GUI.
• 41 E2E Tests — Automated test suite via tauri-plugin-mcp covering all GUI features against the live staging site.

• ShipTypes-style contract-first design — public CLI, plugin, and GUI behavior should be typed, machine-readable, and discoverable without relying on prose scraping.
• agent-dx-cli-scale discipline — changes should preserve or improve JSON-first I/O, raw payload paths, schema validation, stable errors, safety rails, and context-window discipline.
• No silent structured-content corruption — avoid naive regex or delimiter splitting that can rewrite valid CSS, HTML, JSON, URLs, or other structured payloads in transit.

• WordPress 6.0+ with Bricks Builder 1.9+
• PHP 8.0+
• Optional: Automatic.css 3.x for design token support

make build          # build CLI binary
make test           # run Go tests
make sync-version   # sync VERSION across all components
make check-version  # verify version consistency

Contributing guide

GPL-3.0