Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/eltfd/ai-agent-governance/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Control, approve, and audit AI agent actions on your WordPress site.
Description
AI Agent Governance sits between AI agents (ChatGPT, Claude, WPVibe, etc.) and your WordPress Abilities API. It provides:
- Kill Switch — instantly block all AI agent actions
- Policy Rules — wildcard pattern matching to allow, deny, or hold abilities
- Approval Queue — destructive actions require admin approval before execution
- Audit Log — complete trail of every AI agent attempt
- Blocked List — explicit blocklist for specific ability names or patterns
Looking for more? The Pro version adds Undo/Rollback, Email alerts, and Telegram notifications for pending approvals.
Installation
- Upload
ai-agent-governancefolder to/wp-content/plugins/ - Activate through Plugins menu
- Navigate to AI Governance in admin sidebar
- Configure policies and blocked abilities
Usage Guide
Quick Setup
- Activate Plugin: Go to Plugins > Installed Plugins and activate AI Agent Governance.
- Access Governance Dashboard: Click AI Governance in the main WP admin menu.
Core Features & Operations
-
Emergency Control (Kill Switch)
- Toggle the Emergency Kill Switch at top of page to
ONto instantly block ALL AI agent actions across site. - Turn
OFFto restore normal governance routing.
- Toggle the Emergency Kill Switch at top of page to
-
Managing Policies & Rules
- Click Add Rule under Policy Management.
- Set Pattern (e.g.
posts/*,users/delete,*for global default). - Select Action:
Allow(pass through),Deny(block), orHold(require admin review). - Rules evaluate top-down in display order.
-
Approval Queue (Held Actions)
- Actions marked
Holdor flagged asdestructiveland in Pending Approvals. - Review action metadata and click Approve to execute or Reject to block.
- Actions marked
-
Blocked List
- Add specific ability identifiers (e.g.,
core/update-settings) to Blocked Abilities for permanent block without rule evaluation.
- Add specific ability identifiers (e.g.,
-
Audit Trail
- Go to Audit Log tab to view timestamped history of all agent action attempts, parameters, decisions, and execution outcomes.
Changelog
0.1.0
- Initial release