AgentMod is an
AI Agent Platform built natively for WordPress. Unlike standard AI chatbot plugins, AgentMod acts as an orchestration layer on top of the
Connectors,
WP AI Client, and
Abilities API infrastructure introduced in WordPress 7.0.
Instead of writing custom integration code (glue-code) for external services, AgentMod creates an
Ability Economy: it reads abilities exposed by plugins like WooCommerce (
create_order), FluentCRM (
create_contact), or Amelia (
book_appointment) directly from the WordPress Core Registry and makes them available to AI agents — turning your site into an autonomous operating platform.
Key Features (Free Version)
AI Orchestration Engine
A stateless, model-agnostic agent engine built on the native WordPress AI Client. Supports sequential and parallel multiple ability calls via
WP_AI_Client_Ability_Function_Resolver.
Admin Chat Widget
A React-based chat panel triggered from the WordPress Admin Bar. Built with
@wordpress/components Modal architecture. Includes a "New Topic" button to reset the session and conversation history at any time.
Context Scope Selector
A toggle control inside the chat composer that lets the user decide whether the AI agent can read site data or should operate on general knowledge only.
Search & Content Tools
- Search queries return a maximum of 20 post titles/excerpts per call.
- Full content processing is limited to a maximum of 5 post bodies at once. Requests like "Analyze all 500 posts" are gracefully declined.
- A maximum of 10 ability calls are allowed per message cycle.
Write Action Confirmation Modal
When an agent triggers a database-modifying ability such as
create_post or send_email, an approval modal is shown to the user with a summary of the action. The operation is not executed until the user explicitly confirms.
Smart Response Rendering
- Plain text responses are rendered as Markdown with "Copy Text" and "Create Draft" action buttons.
-
Code block responses (HTML, CSS, PHP, etc.) are displayed in a syntax-highlighted
<pre> container with a "Copy Code" button.
Site Management Abilities
A group of abilities that let the agent administer the WordPress installation itself, covering the same ground as the wp plugin, wp theme, wp option, wp user, wp core and wp cron command families — without needing shell access or WP-CLI:
-
Plugins and themes: list, look up, search the WordPress.org directory, install from a slug or a .zip, activate, deactivate, update and delete.
- Settings: browse WordPress' registered settings with their declared types, and update them with schema validation. Individual options can be read and written too.
- System: report the WordPress, PHP and MySQL versions, pending updates and whether the site permits file modifications; list scheduled cron events; flush the object cache and rewrite rules.
- Users: list accounts, create users, edit profiles, change roles, send password resets and delete accounts with content reassignment.
Every destructive or state-changing ability in this group goes through the approval modal, and guards refuse the operations that would break the site: writing
siteurl, deactivating AgentMod itself, deleting the active theme, removing the last administrator or the account you are signed in as. Passwords are never generated into a response — WordPress sends its standard emails instead.
Ability Registry Browser
A dedicated sub-menu page under AgentMod lists all abilities currently registered on WordPress Core Registry, with detailed information for each.
Secure System Directives
The
PromptBuilder enforces strict system-level directives that prevent agents from performing destructive actions and require them to ask clarifying questions in ambiguous situations.
Developer Hook System
A comprehensive set of PHP and JavaScript hooks for extending AgentMod:
- Filters for prompt modification (before/after)
- Actions for ability execution lifecycle (before/after)
- ChatPanel UI customization hooks (add/remove tools, sections)
Get Pro to Unlock More Features
Unlock advanced features and take your AI Agents to the next level.
- Full-Screen Workspace : Manage all AI features in full screen panel. No distraction!
- Multi Agent System : Create and manage multiple AI agents.
- Conversation History : Save and manage conversation history.
- AI Skills : Add custom AI skills to your agents.
- Frontend Widgets : Add AI widgets to your website. For example for contact forms or FAQ floating chat panels.
- Code Snippets : Save and manage code snippets with your AI agents.
- Import / Export Tools : Export and import settings and custom fields and plugin settings.
Provider Agnostic
AgentMod does not lock you into any specific AI provider. It works with any provider supported by the WordPress AI Client, including OpenAI, Anthropic, and others configured via provider plugins.
Requirements
- WordPress 7.0 or higher (requires native WP AI Client & Abilities API)
- PHP 7.4 or higher
- An active AI provider plugin compatible with WordPress AI Client
1.1.5
- New: In-loop history compaction to reduce token usage by eliding old tool results and removing old binary attachments.
- New: AI provider HTTP timeout manager to prevent "cURL error 28" on long generations.
- Enhancement: Tool result digests added to conversation history, preventing the AI from repeating identical tool calls.
- Enhancement: Improved Block Template and Template Part creation logic (assigns theme taxonomies and resolves area for template parts).
1.1.4
- Fixed: Global Styles Ability-> Schema validation error for color presets.
- Updated: Increased max attachment count from 5 to 15.
- Added: 'text/html' mime type to supported image formats.
1.1.3
- Fixed: Errors and warnings Plugin Check found (2 errors, 1 warning).
1.1.2
- Improved: Agent personality traits.
1.1.1
- Added: Post type parameter into get and list post or pages abilities.
- Added: Default agent model selection in AgentMod settings page.
1.1.0
- Added: Site Management abilities (new "AgentMod — Site Management" category, 24 abilities) covering plugins, themes, settings/options, system status, cron and users — the native equivalent of the WP-CLI management commands, with no shell access required.
- Added: Guards for site management operations — protected options, self-protection for AgentMod's own plugins, active/parent/default theme protection, last-administrator protection and privilege-escalation checks on user roles.
- Fixed: An approved write action is now matched by ability name and arguments before it is exempted from confirmation. Previously the model could return different arguments on the confirmation turn and have them executed without a second prompt.
- Fixed: Chat processing issues.
- Improved: Connector repair system reliability and accuracy.
1.0.9
Added: Web search capability. Agent can search the web for information and use it in responses.
Added: Stop Chat button into composer.
1.0.8
- Updated: Pro version url.
1.0.7
- Added: Pro version announcement into dashboard.
- Fixed: Page loading issue while fetching provider model lists.
- Added: Default preset prompts into plugin settings.
1.0.6
- Added: Agent tray selector with avatars in the chat toolbar (always visible; shows the settings-driven Default Agent, extensions can add more agents)
- Added:
agent_mod_agent_config_data PHP filter — lets extensions resolve an agent's full configuration server-side before the AgentConfig DTO is built
- Added:
agent_mod.agents JS filter — lets extensions adjust the agent tray list client-side
- Changed: Chat requests now send only request-level agent fields (id, mode, provider/model, emphasized abilities); agent configuration is always resolved server-side
1.0.5
- Feature: Added new settings
- Feature: Add selected abilities to settings page
- Fixed: Confirmation Modal error
- Redesigned: Constants and AgentConfig structure
1.0.4
- Update NCF (native-custom-fields) to 1.2.8
1.0.3
- Update NCF (native-custom-fields) to 1.2.7
- Add: Singleton pattern into DI Container
1.0.2
- Fixed: Ability List page render error
- Added: Filter hooks for services and controllers
- Added: Useful Url's into the Dashboard sidebar
1.0.1
- Fixed: Admin menu label bug
- Removed: Provider logo url contained constant WP_CONTENT_DIR
1.0.0