WordPress CLI
for cmdhub.

Credential: WordPress Application Password (`wordpress_application_password`).
Create or revoke it in wp-admin: https://dev-cmdhub.pantheonsite.io/wp-admin/profile.php#application-passwords

Authenticated as kestrelphilip@gmail.com
Profile: kestrelphilip@gmail.com

Next steps:
- Run: wordpress auth whoami

Canonical identity command for WordPress. Call the REST API as the current profile and show the authenticated user; use this instead of user me, account me, or wordpress me.

Usage:
  wordpress auth whoami [flags]

Examples:
wordpress auth status
wordpress auth whoami
wordpress auth whoami --help
wordpress auth whoami --json

Flags:
  -h, --help   help for whoami

Global Flags:
      --config string    Config path override
      --cursor string    Continuation cursor
      --debug            Enable debug diagnostics
      --json             Emit one JSON wrapper/debug payload
      --jsonl            Emit pipeable pc.cli.v1 JSONL item/meta records
      --limit int        Maximum items to emit (default 50)
      --no-paginate      Fetch only one page
  -o, --output string    Compatibility output mode: json|jsonl. Prefer --json for wrapper/debug or --jsonl for pipes
      --page-size int    Requested upstream page size (default 50)
      --profile string   Config/auth profile (default "default")
  -q, --quiet            Suppress non-essential diagnostics
  -v, --version          Print version information
      --view string      View mode: summary|full (default "summary")

Credential: WordPress Application Password (`wordpress_application_password`).
Create or revoke it in wp-admin: https://dev-cmdhub.pantheonsite.io/wp-admin/profile.php#application-passwords

wordpress doctor: WARN
Checks: credential_backend ok, credential_security warn, profiles ok, auth ok, permissions ok, connectivity ok, scope ok
CHECK                STATUS  DETAIL
credential_backend   OK      using file
credential_security  WARN    credential backend stores local plaintext secrets
profiles             OK      active profile "kestrelphilip@gmail.com"
auth                 OK      stored Application Password is valid
permissions          OK      current WordPress user is readable through /wp/v2/users/me
connectivity         OK      WordPress REST index is reachable
scope                OK      core wp/v2 namespace is available

Next steps:
- Status:       wordpress auth status
- Capabilities: wordpress capabilities

Capabilities is the operations inventory: resources, actions, safety, output modes, and command paths.
Use `wordpress capabilities --json` for the full command contract; use `wordpress schema` for input/output schemas.
Output: `--json` is one wrapper/debug payload; `--jsonl` is the pipeable `pc.cli.v1` item/meta stream.

wordpress capabilities
Resources: application-password, auth, autosave, block, block-type, capabilities, category, comment, config, content, doctor, mcp, media, menu, menu-item, navigation, page, plugin, post, profile, resolve, revision, route, schema, search, setting, site, site-health, status, tag, taxonomy, template, template-part, theme, type, user, version
Machine output: --json, --jsonl

Next steps:
- Schema:   wordpress schema
- Contract: wordpress capabilities --json
- Help:     wordpress --help
- Status:   wordpress auth status

Schema is the machine contract: command-level input/output schemas by `resource.action`.
Use `wordpress schema post.list --in --json` or `wordpress schema post.list --out --json`; use `wordpress capabilities` for operations.

wordpress schemas
COMMAND                      DIR
application-password.get     input
application-password.get     output
application-password.revoke  input
application-password.revoke  output
auth.login                   input
auth.login                   output
auth.logout                  output
auth.refresh                 output
auth.status                  output
auth.whoami                  output
autosave.apply               input
autosave.apply               output
autosave.create              input
autosave.create              output
autosave.get                 input
autosave.get                 output
autosave.list                input
autosave.list                output
block.create                 input
block.create                 output
block.delete                 input
block.delete                 output
block.get                    input
block.get                    output
block.list                   input
block.list                   output
block.restore                input
block.restore                output
block.search                 input
block.search                 output
block.trash                  input
block.trash                  output
block.update                 input
block.update                 output
block-type.get               input
block-type.get               output
block-type.list              input
block-type.list              output
block-type.search            input
block-type.search            output
capabilities.describe        output
category.create              input
category.create              output
category.delete              input
category.delete              output
category.get                 input
category.get                 output
category.list                input
category.list                output
category.search              input
category.search              output
category.update              input
category.update              output
comment.approve              input
comment.approve              output
comment.create               input
comment.create               output
comment.delete               input
comment.delete               output
comment.get                  input
comment.get                  output
comment.hold                 input
comment.hold                 output
comment.list                 input
comment.list                 output
comment.reply                input
comment.reply                output
comment.restore              input
comment.restore              output
comment.search               input
comment.search               output
comment.spam                 input
comment.spam                 output
comment.trash                input
comment.trash                output
comment.unspam               input
comment.unspam               output
comment.update               input
comment.update               output
config.explain               output
content.create               input
content.create               output
content.delete               input
content.delete               output
content.get                  input
content.get                  output
content.list                 input
content.list                 output
content.restore              input
content.restore              output
content.search               input
content.search               output
content.trash                input
content.trash                output
content.update               input
content.update               output
doctor.run                   output
media.attach                 input
media.attach                 output
media.delete                 input
media.delete                 output
media.detach                 input
media.detach                 output
media.download               input
media.download               output
media.get                    input
media.get                    output
media.list                   input
media.list                   output
media.search                 input
media.search                 output
media.update                 input
media.update                 output
media.upload                 input
media.upload                 output
menu.create                  input
menu.create                  output
menu.delete                  input
menu.delete                  output
menu.get                     input
menu.get                     output
menu.list                    input
menu.list                    output
menu.search                  input
menu.search                  output
menu.update                  input
menu.update                  output
menu-item.create             input
menu-item.create             output
menu-item.delete             input
menu-item.delete             output
menu-item.get                input
menu-item.get                output
menu-item.list               input
menu-item.list               output
menu-item.search             input
menu-item.search             output
menu-item.update             input
menu-item.update             output
navigation.create            input
navigation.create            output
navigation.delete            input
navigation.delete            output
navigation.get               input
navigation.get               output
navigation.list              input
navigation.list              output
navigation.restore           input
navigation.restore           output
navigation.search            input
navigation.search            output
navigation.trash             input
navigation.trash             output
navigation.update            input
navigation.update            output
page.clone                   input
page.clone                   output
page.create                  input
page.create                  output
page.delete                  input
page.delete                  output
page.get                     input
page.get                     output
page.list                    input
page.list                    output
page.publish                 input
page.publish                 output
page.restore                 input
page.restore                 output
page.schedule                input
page.schedule                output
page.search                  input
page.search                  output
page.trash                   input
page.trash                   output
page.update                  input
page.update                  output
plugin.get                   input
plugin.get                   output
plugin.list                  input
plugin.list                  output
post.clone                   input
post.clone                   output
post.create                  input
post.create                  output
post.delete                  input
post.delete                  output
post.get                     input
post.get                     output
post.list                    input
post.list                    output
post.publish                 input
post.publish                 output
post.restore                 input
post.restore                 output
post.schedule                input
post.schedule                output
post.search                  input
post.search                  output
post.trash                   input
post.trash                   output
post.update                  input
post.update                  output
profile.create               input
profile.create               output
profile.delete               input
profile.delete               output
profile.list                 output
profile.rename               input
profile.rename               output
profile.use                  input
profile.use                  output
resolve.get                  output
revision.delete              input
revision.delete              output
revision.get                 input
revision.get                 output
revision.list                input
revision.list                output
revision.restore             input
revision.restore             output
route.get                    input
route.get                    output
route.list                   input
route.list                   output
schema.describe              output
search.query                 input
search.query                 output
setting.get                  input
setting.get                  output
setting.list                 input
setting.list                 output
setting.update               input
setting.update               output
site.configure               input
site.configure               output
site.get                     input
site.get                     output
site-health.get              input
site-health.get              output
site-health.list             input
site-health.list             output
status.get                   input
status.get                   output
status.list                  input
status.list                  output
tag.create                   input
tag.create                   output
tag.delete                   input
tag.delete                   output
tag.get                      input
tag.get                      output
tag.list                     input
tag.list                     output
tag.search                   input
tag.search                   output
tag.update                   input
tag.update                   output
taxonomy.get                 input
taxonomy.get                 output
taxonomy.list                input
taxonomy.list                output
template.get                 input
template.get                 output
template.list                input
template.list                output
template-part.get            input
template-part.get            output
template-part.list           input
template-part.list           output
theme.get                    input
theme.get                    output
theme.list                   input
theme.list                   output
type.get                     input
type.get                     output
type.list                    input
type.list                    output
user.get                     input
user.get                     output
user.list                    input
user.list                    output
user.search                  input
user.search                  output
version.get                  output

Next steps:
- Status: wordpress auth status
- Login:  wordpress auth login
- Site:   wordpress site get
- Schema: wordpress schema

Create post

Next steps:
- List:   wordpress post list
- Status: wordpress auth status
- Login:  wordpress auth login
- Site:   wordpress site get

Upload media

Next steps:
- List:   wordpress media list
- Status: wordpress auth status
- Login:  wordpress auth login
- Site:   wordpress site get

Create a WordPress page

Usage:
  wordpress page create [flags]

Examples:
wordpress page create --help
wordpress page create --title "cmdhub-wordpress draft" --content-file ./post.md --content-format markdown --status draft
wordpress page create --title "cmdhub-wordpress draft" --content-file ./post.md --status draft

Flags:
      --category stringArray    Category ref or ID; repeatable
      --content string          Content body
      --content-file string     Read content from file or - for stdin
      --content-format string   Content format: html, markdown, or plain (default "html")
      --date string             Publish date
      --dry-run                 Preview without changing WordPress state
      --excerpt string          Excerpt
      --excerpt-file string     Read excerpt from file or - for stdin
      --featured-media string   Featured media ref or ID
  -h, --help                    help for create
      --menu-order int          Page menu order
      --parent string           Parent ref or ID
      --site string             WordPress site URL for this command
      --slug string             Slug
      --status string           WordPress status (default "draft")
      --tag stringArray         Tag ref or ID; repeatable
      --timezone string         Date timezone
      --title string            Title
      --title-file string       Read title from file or - for stdin
      --yes                     Confirm create-time publish or schedule

Global Flags:
      --config string    Config path override
      --cursor string    Continuation cursor
      --debug            Enable debug diagnostics
      --json             Emit one JSON wrapper/debug payload
      --jsonl            Emit pipeable pc.cli.v1 JSONL item/meta records
      --limit int        Maximum items to emit (default 50)
      --no-paginate      Fetch only one page
  -o, --output string    Compatibility output mode: json|jsonl. Prefer --json for wrapper/debug or --jsonl for pipes
      --page-size int    Requested upstream page size (default 50)
      --profile string   Config/auth profile (default "default")
  -q, --quiet            Suppress non-essential diagnostics
  -v, --version          Print version information
      --view string      View mode: summary|full (default "summary")

Refs: `pg1` is a session-scoped local ref created by `wordpress page list`; it is not a WordPress ID. Use `wordpress resolve pg1` to inspect exact IDs and URLs.

Pages (2 total)
REF  TITLE           STATUS   WHEN                 URL
pg1  Privacy Policy  draft    2026-05-23T14:21:28  [u6]
pg2  Sample Page     publish  2026-05-23T14:21:28  [u7]

URLs:
- [u6] https://dev-cmdhub.pantheonsite.io
- [u7] https://dev-cmdhub.pantheonsite.io

Next steps:
- Open:   wordpress page get pg1
- Search: wordpress page search --query <text>
- Status: wordpress auth status
- Login:  wordpress auth login