WordPress (Beta)

The Frontman WordPress plugin adds an AI agent directly to your WordPress site. Navigate to /frontman, describe what you want to change, and the agent handles the supported workflow inside the site preview — no code editor or terminal required for those supported changes.

Beta: This is experimental software. Start on a staging site, keep backups, and review changes before deploying to production.

Requirements

• WordPress 6.0 or later
• PHP 7.4 or later
• An admin account (manage_options capability)

Installation

Option A: Upload via WordPress Admin

1. Download the latest frontman.zip from the GitHub releases page.
2. In your WordPress admin, go to Plugins → Add New Plugin → Upload Plugin.
3. Choose the ZIP file and click Install Now.
4. Click Activate Plugin.

Option B: Manual Upload

1. Download and unzip frontman.zip.
2. Upload the frontman/ folder to /wp-content/plugins/ via FTP or your host’s file manager.
3. In your WordPress admin, go to Plugins and activate Frontman - Agentic AI Editor.

Configuration

After activation, go to Frontman → Settings in the WordPress admin sidebar.

Setting	Description
Anthropic API key	Your sk-ant-... key from console.anthropic.com. Optional — Frontman provides access by default.
OpenRouter API key	Your sk-or-v1-... key from openrouter.ai. Optional alternative to Anthropic.

API keys are optional. If you leave them blank, the plugin connects to the Frontman API without a custom key.

Using Frontman

1. Make sure you’re logged in to WordPress as an admin.
2. Navigate to /frontman on your site (e.g. https://yoursite.com/frontman).
3. The chat interface opens alongside a live preview of your site.
4. Describe what you want to change and the agent handles it.

You can also open Frontman while browsing any page — just append /frontman to any URL on your site (e.g. https://yoursite.com/about/frontman) and the agent will preview that page.

What the Agent Can Do

• Create, edit, and delete posts and pages
• Insert, update, move, and delete Gutenberg blocks
• Add and update navigation menu items
• Read and change site options (title, tagline, permalinks, etc.)
• Browse and update block templates and template parts
• Manage widgets
• Inspect theme and plugin files with read-only file tools
• Create and activate a Frontman-managed child theme for safe CSS, HTML, and JSON edits on block themes
• Fork supported parent-theme files into that managed child theme before editing them
• Flush the WordPress cache

All file inspection is scoped to your WordPress root directory. Direct writes to unmanaged theme and plugin files are not available. File creation and editing are limited to the Frontman-managed child theme.

The managed child-theme workflow is available when your active theme is a block-theme parent theme. If another child theme is already active, or if the active theme is not a block theme, Frontman will inspect it read-only and you will need to migrate changes manually.

Security

• Only users with the manage_options capability can access Frontman.
• Tool call requests (POST) are validated with WordPress nonces.
• Site options are restricted to a safe allowlist — arbitrary option writes are not permitted.
• Loading /frontman requests UI assets from Frontman’s hosted client. Your site content is not sent to Frontman’s API until you actively submit a message in the chat.

External Services

The plugin connects to two Frontman-hosted services:

• app.frontman.sh — Serves the chat UI (JavaScript and CSS).
• api.frontman.sh — Handles AI agent communication via WebSocket. Site content is sent here when you submit a message.

AI responses are generated by third-party providers (Anthropic, OpenAI, etc.) via the Frontman API. See the Privacy Policy for details.

Troubleshooting

The /frontman URL shows a 404. Flush your WordPress permalinks: go to Settings → Permalinks and click Save Changes without changing anything.

I see a login screen instead of the Frontman UI. You must be logged in to WordPress as an administrator. Log in first, then navigate to /frontman.

Changes aren’t showing on the live site. Use the wp_clear_cache tool in the chat, or flush your caching plugin manually (WP Rocket, W3 Total Cache, etc.).

Something went wrong and I want to undo a change. Many WordPress mutation tools return before/after snapshots in tool history, but Frontman does not guarantee one-click undo for every WordPress change. Keep normal site backups and review changes before relying on them.