Localwp cli skill

Skill mmnaderi/localwp-cli-skill

Enables AI agents and developers to run WP-CLI, mysql, and composer in LocalWP site environments on macOS with zero configuration.

Install

npx -y skills add mmnaderi/localwp-cli-skill

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use when WP-CLI, MySQL, Composer, or PHP must run inside the environment of a site managed by LocalWP on macOS. Guides agents to run the zero-config localwp-wpcli.sh helper script to execute commands in the correct site environment automatically.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

1.8 KB, as published. Nobody here has run it

Connect LocalWP CLI

Purpose

LocalWP runs each site in an isolated environment with its own PHP runtime, MySQL socket, and configurations. Sourcing LocalWP's environment manually is complex. This skill provides a zero-config helper script that automatically detects the active LocalWP site, configures the environment (from existing ssh-entry shell scripts or dynamically via sites.json), and executes CLI commands (such as wp, mysql, composer, or php).

Workflow

Confirm the LocalWP site is running.
Locate the WordPress project directory (the folder containing wp-config.php or its parent).
Run the helper script to execute CLI commands:

.agents/skills/connect-localwp-cli/scripts/localwp-cli.sh "$PWD" wp db check

Or omit the path to use the current working directory:

.agents/skills/connect-localwp-cli/scripts/localwp-cli.sh wp db check

Validation

Always run a read-only check first to verify connectivity:

.agents/skills/connect-localwp-cli/scripts/localwp-cli.sh wp option get siteurl
.agents/skills/connect-localwp-cli/scripts/localwp-cli.sh wp db check

Safety

Export the database before performing any destructive or write operations:
```
.agents/skills/connect-localwp-cli/scripts/localwp-cli.sh wp db export
```
Treat wp db *, wp option update, wp post *, and wp eval-file as write-capable.