AgentMod

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 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), Core (get_site_infor), or Native Custom Fields (create_post_type) 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.

• AgentMod Hub: Browse and import ready-to-use agents, skills, and more from a public hub, no manual setup required.
• Multi-Agent System: Create and manage multiple specialized AI agents, each with its own role and personality.
• Agent Tray: Switch between your AI agents right from the chat interface.
• Conversation History: Automatically save, search, and restore past conversations.
• Additional Abilities: Unlock 40+ extra abilities for your agents to work with.
• AI Skills: Attach reusable, custom skills to your agents.
• Full-Screen Workspace: A dedicated, distraction-free environment to manage every AI feature in one place.
• Scheduled Tasks: Build multi-step scheduled agent runs and make your website act autonomously.
• Frontend Widgets: Add AI-powered widgets to your site, such as contact forms or FAQ floating chat panels.
• Code Snippets: Save, manage, and run code snippets alongside your AI agents.
• Import / Export Tools: Export and import settings, custom fields, and plugin configuration.

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

Credits

Built using official WordPress packages:

• @wordpress/scripts
• @wordpress/components
• @wordpress/elements
• @wordpress/icons
• @wordpress/data

Assets:

• All images located in the Admin/assets/img folder are self created and are licensed under CC0 1.0 Universal (CC0 1.0) Public Domain Dedication.

Composer Packages:

• PHP DI – Copyright (c) Matthieu Napoli

Libraries:

• Native Custom Fields – Copyright (c) Arkenon (https://wordpress.org/plugins/native-custom-fields/)

Source Code

It is available on GitHub:
* GitHub: https://github.com/Arkenon/agent-mod

Developers

If you want to contribute to the plugin:
1) Download the source code and run npm install to install the development dependencies.
2) To install composer dependencies, run composer install.
3) Run npm start to start the development server.
4) To build the plugin, run npm run build.