manage_options capability (administrator role). WP-CLI write commands require additional opt-in constants in wp-config.php.
All development abilities
maxi/run-wp-cli
Execute a WP-CLI command directly from your AI agent. Shell metacharacters are rejected before execution — this ability accepts WP-CLI command text only, not shell commands.Read-only commands (always permitted)
Read-only commands require no configuration. You can call them immediately.user list, wc tool list, wc log read, and similar non-mutating commands.
Write commands (opt-in via wp-config.php)
Write commands are blocked by default. To enable a group, add the corresponding constant to yourwp-config.php. Only enable the groups your agent legitimately needs.
1
Choose the groups you need
2
Add constants to wp-config.php
Add only the constants for the groups you need. For example, to allow cache writes and SELECT-only database queries:
3
Verify on the configuration page
See the full configuration reference and the complete read-only command allowlist at WP-CLI configuration.
maxi/manage-db-query-blocklist
WhenMAXI_AI_WP_CLI_ALLOW_DB_READS is enabled, db query SELECT commands pass through a two-layer blocklist check: once against the SQL text (pre-execution) and once against the query output (post-execution). If a blocked term appears in either, the command is rejected and the event is audit-logged.
List the current blocklist terms:
Both rejection types (
db_query_blocklist_sql and db_query_blocklist_output) are recorded in the audit log. Query them with maxi/get-audit-events using { "category": "wp_cli" }.