Skip to content

Commit 9134f44

Browse files
sionsmithclaude
andcommitted
docs: add WP-CLI inspiration and motivation
Explain that wpx was inspired by WP-CLI but built for AI agents that shouldn't need PHP installed to manage WordPress sites. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 913c388 commit 9134f44

2 files changed

Lines changed: 6 additions & 2 deletions

File tree

CLAUDE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
## Project Overview
44

5-
wpx is a Rust-native WordPress CLI designed for both AI agents and humans. It manages WordPress sites remotely via the REST API, producing structured machine-readable output (JSON) when piped and human-readable tables when run interactively. The tool is organized as a Cargo workspace of six crates, supports multi-site fleet management, and authentication via WordPress application passwords and OAuth 2.1 with PKCE.
5+
wpx is a Rust-native WordPress CLI designed for both AI agents and humans. Inspired by [WP-CLI](https://github.com/wp-cli/wp-cli), but built from the ground up because AI agents shouldn't need PHP to manage WordPress -- wpx communicates purely via the WordPress REST API as a single static binary with zero runtime dependencies. It produces structured machine-readable output (JSON) when piped and human-readable tables when run interactively. The tool is organized as a Cargo workspace of six crates, supports multi-site fleet management, and authentication via WordPress application passwords and OAuth 2.1 with PKCE.
66

77
## Build & Test
88

README.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,11 @@
44
[![License: MIT/Apache-2.0](https://img.shields.io/badge/license-MIT%2FApache--2.0-blue.svg)](LICENSE)
55
[![Rust](https://img.shields.io/badge/rust-2021-orange.svg)](https://www.rust-lang.org/)
66

7-
Rust-native CLI for managing WordPress sites remotely via the REST API. Designed agent-first: structured JSON output, schema introspection, and semantic exit codes let AI agents operate WordPress programmatically. Designed human-friendly: auto-detecting table output, colored terminals, and shell completions make it pleasant for interactive use. Zero runtime dependencies -- single static binary, no PHP or SSH required.
7+
Rust-native CLI for managing WordPress sites remotely via the REST API. Inspired by [WP-CLI](https://github.com/wp-cli/wp-cli), but built from the ground up for AI agents -- because agents shouldn't need PHP installed to manage a WordPress site.
8+
9+
WP-CLI requires a local PHP runtime, a bootstrapped WordPress installation, and SSH access to run. That's fine for humans on a server, but it's a non-starter for AI coding agents like Claude, Cursor, or Codex that operate remotely over HTTPS. **wpx** solves this by communicating purely via the WordPress REST API as a single static binary with zero runtime dependencies.
10+
11+
Designed agent-first: structured JSON output, schema introspection, and semantic exit codes let AI agents operate WordPress programmatically. Designed human-friendly: auto-detecting table output, colored terminals, and shell completions make it pleasant for interactive use.
812

913
## Features
1014

0 commit comments

Comments
 (0)