PHPackages                             carmelosantana/coqui-awesome-wp - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Admin Panels](/categories/admin)
4. /
5. carmelosantana/coqui-awesome-wp

ActiveLibrary[Admin Panels](/categories/admin)

carmelosantana/coqui-awesome-wp
===============================

Comprehensive WordPress management toolkit for Coqui — multi-site REST API + WP-CLI integration for content, users, plugins, themes, media, menus, settings, health monitoring, custom code scaffolding, and more

v0.1.1(1mo ago)00MITPHPPHP ^8.4

Since Apr 9Pushed 1mo agoCompare

[ Source](https://github.com/carmelosantana/coqui-awesome-wp)[ Packagist](https://packagist.org/packages/carmelosantana/coqui-awesome-wp)[ RSS](/packages/carmelosantana-coqui-awesome-wp/feed)WikiDiscussions main Synced yesterday

READMEChangelogDependencies (4)Versions (3)Used By (0)

Awesome WP — WordPress Management Toolkit for Coqui
===================================================

[](#awesome-wp--wordpress-management-toolkit-for-coqui)

A comprehensive WordPress management toolkit for [Coqui Bot](https://github.com/carmelosantana/coqui) that provides full REST API coverage, multi-site connection management, and plugin/theme scaffolding.

Features
--------

[](#features)

- **15 specialized tools** covering the full WordPress REST API surface
- **Multi-site management** — add, switch between, and manage multiple WordPress sites
- **Plugin &amp; theme scaffolding** — generate boilerplate with proper headers and hooks
- **Raw REST API access** — escape hatch for custom post types, WooCommerce, and third-party plugins
- **Secure credential handling** — application passwords stored in `.env` with hot-reload
- **WP-CLI integration** — optional power-user features via `coqui-toolkit-wp-cli`

Requirements
------------

[](#requirements)

- PHP 8.4+
- Coqui Bot with `carmelosantana/php-agents` ^0.7
- WordPress 5.6+ (for Application Passwords support)

Installation
------------

[](#installation)

Install via Composer in your Coqui workspace:

```
composer require carmelosantana/coqui-awesome-wp
```

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

Authentication
--------------

[](#authentication)

This toolkit uses **WordPress Application Passwords** for authentication:

1. Log into your WordPress admin
2. Go to **Users → Profile**
3. Scroll to **Application Passwords**
4. Enter a name (e.g., "Coqui Bot") and click **Add New Application Password**
5. Copy the generated password

Then add the site to Coqui:

```
awp_sites(action: "add", alias: "mysite", url: "https://example.com", username: "admin", app_password: "xxxx xxxx xxxx xxxx xxxx xxxx")

```

Tools Reference
---------------

[](#tools-reference)

ToolDescriptionKey Actions`awp_sites`Site connection managementadd, list, get, remove, test, set\_default`awp_content`Posts &amp; pages CRUDlist, create, update, delete, revisions`awp_media`Media library managementlist, upload, get, update, delete`awp_users`User managementlist, create, get, update, delete, me`awp_comments`Comment managementlist, create, get, update, delete`awp_taxonomy`Categories, tags, custom taxonomieslist, create, get, update, delete`awp_plugins`Plugin managementlist, get, install, activate, deactivate, delete`awp_themes`Theme managementlist, get, activate`awp_settings`Site settingsget, update`awp_menus`Navigation menuslist\_menus, create\_item, update\_item, delete\_item`awp_blocks`Blocks, widgets, sidebarslist\_block\_types, create\_block, list\_widgets`awp_search`Cross-content searchFull-text search across posts, pages, terms`awp_health`Site health diagnosticsstatus, tests, directory\_sizes`awp_rest`Raw REST API requestsAny HTTP method to any endpoint`awp_scaffold`Plugin/theme scaffoldinggenerate, deployMulti-Site Usage
----------------

[](#multi-site-usage)

Add multiple sites and target any of them:

```
awp_sites(action: "add", alias: "production", url: "https://example.com", ...)
awp_sites(action: "add", alias: "staging", url: "https://staging.example.com", ...)

# Target production
awp_content(action: "list", site: "production")

# Target staging
awp_content(action: "list", site: "staging")

# Change default
awp_sites(action: "set_default", alias: "staging")

```

Scaffolding
-----------

[](#scaffolding)

Generate WordPress plugin or theme boilerplate:

```
awp_scaffold(action: "generate", type: "plugin", name: "My Custom Plugin", description: "Does amazing things")
awp_scaffold(action: "generate", type: "theme", name: "My Custom Theme", author: "Carmelo")

```

Generated files include proper headers, activation hooks, uninstall scripts, and standard directory structure.

Gated Operations
----------------

[](#gated-operations)

The following destructive operations require user confirmation (unless `--auto-approve` is set):

- `awp_plugins`: install, activate, deactivate, delete, update
- `awp_themes`: activate
- `awp_users`: create, delete
- `awp_settings`: update
- `awp_comments`: delete
- `awp_rest`: post, put, patch, delete
- `awp_scaffold`: deploy
- `awp_sites`: remove

Credential Storage
------------------

[](#credential-storage)

Site credentials are managed automatically:

- **Site metadata** (URL, alias, SSH config) stored in `workspace/data/wp-sites.json`
- **Application passwords** stored as `AWP_{ALIAS}_APP_PASSWORD` in workspace `.env`
- Hot-reload via `putenv()` — no restart needed after adding credentials

Optional default credentials in `composer.json`:

- `AWP_DEFAULT_URL` — default site URL
- `AWP_DEFAULT_USERNAME` — default username
- `AWP_DEFAULT_APP_PASSWORD` — default application password

WP-CLI Integration
------------------

[](#wp-cli-integration)

When `coquibot/coqui-toolkit-wp-cli` is installed, additional server-level operations become available:

- Database export/import
- Core updates and checksum verification
- wp-config.php management
- Search-replace across the database
- Cache and cron management
- Scaffold deployment to remote servers

WP-CLI is a `suggest` dependency — the toolkit works fully without it.

License
-------

[](#license)

MIT

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance94

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

2

Last Release

32d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/597820?v=4)[Carmelo Santana](/maintainers/carmelosantana)[@carmelosantana](https://github.com/carmelosantana)

---

Top Contributors

[![carmelosantana](https://avatars.githubusercontent.com/u/597820?v=4)](https://github.com/carmelosantana "carmelosantana (3 commits)")

---

Tags

wordpresstoolkitwp-rest-apiwp-cliphp-agentscoquisite management

###  Code Quality

TestsPest

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/carmelosantana-coqui-awesome-wp/health.svg)

```
[![Health](https://phpackages.com/badges/carmelosantana-coqui-awesome-wp/health.svg)](https://phpackages.com/packages/carmelosantana-coqui-awesome-wp)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
