WP Agent — Security Model
WP Agent is designed to be safe-by-default for typical WordPress installs.
Core rule
Everything the agent can do is exposed as an ability (Abilities API).
This means:
- Abilities can be enabled/disabled
- Abilities can have permission checks
- Abilities can be filtered/guarded by execution policy
Execution policy tiers
WP Agent supports tiered execution policy. The agent should prefer safer native paths first.
Tiers:
wp-native (default)
- WordPress-native operations only
- Avoids depending on shell access
restricted-shell
- Allows shell tool usage for admins
- Shell commands are allowlisted
extended-shell
- Optional, for advanced environments
trusted
- Power-user mode
Filters
wp-native (default)
- WordPress-native operations only
- Avoids depending on shell access
REST API permissions
restricted-shell
- Allows shell tool usage for admins
- Shell commands are allowlisted
Data storage
extended-shell
- Optional, for advanced environments
trusted
Recommendations
- Power-user mode