README

Manage WordPress sites through natural language commands. This toolkit wraps WP-CLI to provide 13 tools covering plugins, themes, users, posts, options, database, multisite, core, cache, rewrites, search-replace, cron, and media.

Requirements

• PHP 8.4+
• WP-CLI installed and accessible via PATH (or configured via WP_CLI_PATH)
• Coqui Bot with carmelosantana/php-agents ^0.7

Installation

composer require coquibot/coqui-toolkit-wp-cli

The toolkit is auto-discovered by Coqui — no manual registration needed.

Configuration

The toolkit uses three environment variables for default WordPress targeting:

All three are optional. Set them via Coqui's credential system:

Set my WP CLI path to /var/www/html

Every tool also accepts path, ssh, and url parameters for per-call overriding.

Tools

Usage Examples

Plugin Management

Install the hello-dolly plugin and activate it

List all active plugins

Search for SEO plugins

Multisite Discovery

Find which site on my multisite network has a title of "Example Site" and then install the hello-dolly plugin on that site

The bot will:

1. Use wp_site(action: "list", search: "Example Site") to find the site
2. Use wp_plugin(action: "install", plugin: "hello-dolly", activate: true, url: "...") targeting that site

Database Backup & Restore

Backup my database

Restore my database from backup.sql

Domain Migration

Replace all occurrences of http://old-domain.com with https://new-domain.com in the database

The bot will first do a dry run, then ask for confirmation before applying.

Core Management

What version of WordPress is installed?
Check if there are any WordPress updates available
Verify the integrity of WordPress core files

User Management

Create a new editor user with email john@example.com
List all administrator users

SSH Support

Target remote WordPress installations:

List plugins on my remote server user@myserver.com:/var/www/html

Or set a default SSH target:

Set my WP CLI SSH to user@myserver.com:/var/www/html

Development

# Install dependencies
composer install

# Run tests
composer test

# Static analysis
composer analyse

License

MIT