@loopress/cli 0.22.0 → 0.24.0

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g @loopress/cli
 $ lps COMMAND
 running command...
 $ lps (--version)
-@loopress/cli/0.22.0 linux-x64 node-v24.19.0
+@loopress/cli/0.24.0 linux-x64 node-v24.20.0
 $ lps --help [COMMAND]
 USAGE
   $ lps COMMAND
@@ -47,31 +47,48 @@ report.
 # Commands
 
 <!-- commands -->
+* [`lps acf diff [PATH]`](#lps-acf-diff-path)
 * [`lps acf list`](#lps-acf-list)
 * [`lps acf pull [PATH]`](#lps-acf-pull-path)
 * [`lps acf push [PATH]`](#lps-acf-push-path)
+* [`lps api diff [PATH]`](#lps-api-diff-path)
 * [`lps api list`](#lps-api-list)
 * [`lps api publish [PATH]`](#lps-api-publish-path)
 * [`lps api pull [PATH]`](#lps-api-pull-path)
 * [`lps api push [PATH]`](#lps-api-push-path)
+* [`lps app list`](#lps-app-list)
+* [`lps app pull [PATH]`](#lps-app-pull-path)
+* [`lps app push [NAME]`](#lps-app-push-name)
+* [`lps app remove NAME`](#lps-app-remove-name)
 * [`lps composer init`](#lps-composer-init)
 * [`lps composer pull`](#lps-composer-pull)
 * [`lps composer push`](#lps-composer-push)
 * [`lps dev`](#lps-dev)
+* [`lps diff`](#lps-diff)
 * [`lps doctor`](#lps-doctor)
+* [`lps form diff [PATH]`](#lps-form-diff-path)
 * [`lps form list`](#lps-form-list)
 * [`lps form pull [PATH]`](#lps-form-pull-path)
 * [`lps form push [PATH]`](#lps-form-push-path)
 * [`lps help [COMMAND]`](#lps-help-command)
+* [`lps hook diff [PATH]`](#lps-hook-diff-path)
+* [`lps hook list`](#lps-hook-list)
+* [`lps hook pull [PATH]`](#lps-hook-pull-path)
+* [`lps hook push [PATH]`](#lps-hook-push-path)
 * [`lps init`](#lps-init)
 * [`lps login`](#lps-login)
 * [`lps logout`](#lps-logout)
-* [`lps page list`](#lps-page-list)
-* [`lps page pull [PATH]`](#lps-page-pull-path)
-* [`lps page push [PATH]`](#lps-page-push-path)
+* [`lps option add NAME`](#lps-option-add-name)
+* [`lps option diff [PATH]`](#lps-option-diff-path)
+* [`lps option list`](#lps-option-list)
+* [`lps option pull [PATH]`](#lps-option-pull-path)
+* [`lps option push [PATH]`](#lps-option-push-path)
+* [`lps option remove NAME`](#lps-option-remove-name)
 * [`lps plugin add SLUG`](#lps-plugin-add-slug)
+* [`lps plugin audit`](#lps-plugin-audit)
 * [`lps plugin pull`](#lps-plugin-pull)
 * [`lps plugin push`](#lps-plugin-push)
+* [`lps plugin status`](#lps-plugin-status)
 * [`lps project config`](#lps-project-config)
 * [`lps project list`](#lps-project-list)
 * [`lps project pull`](#lps-project-pull)
@@ -82,9 +99,11 @@ report.
 * [`lps promote FROM TO`](#lps-promote-from-to)
 * [`lps pull`](#lps-pull)
 * [`lps push`](#lps-push)
+* [`lps seo diff [PATH]`](#lps-seo-diff-path)
 * [`lps seo list`](#lps-seo-list)
 * [`lps seo pull [PATH]`](#lps-seo-pull-path)
 * [`lps seo push [PATH]`](#lps-seo-push-path)
+* [`lps snippet diff [PATH]`](#lps-snippet-diff-path)
 * [`lps snippet list`](#lps-snippet-list)
 * [`lps snippet publish [PATH]`](#lps-snippet-publish-path)
 * [`lps snippet pull [PATH]`](#lps-snippet-pull-path)
@@ -92,8 +111,44 @@ report.
 * [`lps status`](#lps-status)
 * [`lps telemetry disable`](#lps-telemetry-disable)
 * [`lps telemetry enable`](#lps-telemetry-enable)
+* [`lps theme add SLUG`](#lps-theme-add-slug)
+* [`lps theme pull`](#lps-theme-pull)
+* [`lps theme push`](#lps-theme-push)
+* [`lps theme status`](#lps-theme-status)
 * [`lps validate`](#lps-validate)
 
+## `lps acf diff [PATH]`
+
+Show what differs in ACF field groups, post types, taxonomies, and options pages between your local files and a WordPress environment, or between two environments
+
+```
+USAGE
+  $ lps acf diff [PATH] [--json] [--env <value>] [--against <value>]
+
+ARGUMENTS
+  [PATH]  Path to ACF directory (overrides project config)
+
+FLAGS
+  --against=<value>  Compare the primary environment against this second environment instead of against local files
+  --env=<value>      Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Show what differs in ACF field groups, post types, taxonomies, and options pages between your local files and a
+  WordPress environment, or between two environments
+
+EXAMPLES
+  $ lps acf diff
+
+  $ lps acf diff --env staging
+
+  $ lps acf diff --env staging --against production
+```
+
+_See code: [src/commands/acf/diff.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/acf/diff.ts)_
+
 ## `lps acf list`
 
 List ACF field groups, post types, taxonomies, and options pages from WordPress
@@ -119,7 +174,7 @@ EXAMPLES
   $ lps acf list --type field-groups
 ```
 
-_See code: [src/commands/acf/list.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/acf/list.ts)_
+_See code: [src/commands/acf/list.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/acf/list.ts)_
 
 ## `lps acf pull [PATH]`
 
@@ -148,7 +203,7 @@ EXAMPLES
   $ lps acf pull --type field-groups
 ```
 
-_See code: [src/commands/acf/pull.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/acf/pull.ts)_
+_See code: [src/commands/acf/pull.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/acf/pull.ts)_
 
 ## `lps acf push [PATH]`
 
@@ -177,7 +232,39 @@ EXAMPLES
   $ lps acf push --type field-groups
 ```
 
-_See code: [src/commands/acf/push.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/acf/push.ts)_
+_See code: [src/commands/acf/push.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/acf/push.ts)_
+
+## `lps api diff [PATH]`
+
+Show what differs in custom API route files between your local files and a WordPress environment, or between two environments
+
+```
+USAGE
+  $ lps api diff [PATH] [--json] [--env <value>] [--against <value>]
+
+ARGUMENTS
+  [PATH]  Path to api directory (overrides project config)
+
+FLAGS
+  --against=<value>  Compare the primary environment against this second environment instead of against local files
+  --env=<value>      Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Show what differs in custom API route files between your local files and a WordPress environment, or between two
+  environments
+
+EXAMPLES
+  $ lps api diff
+
+  $ lps api diff --env staging
+
+  $ lps api diff --env staging --against production
+```
+
+_See code: [src/commands/api/diff.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/api/diff.ts)_
 
 ## `lps api list`
 
@@ -200,7 +287,7 @@ EXAMPLES
   $ lps api list
 ```
 
-_See code: [src/commands/api/list.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/api/list.ts)_
+_See code: [src/commands/api/list.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/api/list.ts)_
 
 ## `lps api publish [PATH]`
 
@@ -223,7 +310,7 @@ EXAMPLES
   $ lps api publish --path ./api
 ```
 
-_See code: [src/commands/api/publish.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/api/publish.ts)_
+_See code: [src/commands/api/publish.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/api/publish.ts)_
 
 ## `lps api pull [PATH]`
 
@@ -253,7 +340,7 @@ EXAMPLES
   $ lps api pull --path ./api
 ```
 
-_See code: [src/commands/api/pull.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/api/pull.ts)_
+_See code: [src/commands/api/pull.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/api/pull.ts)_
 
 ## `lps api push [PATH]`
 
@@ -283,7 +370,118 @@ EXAMPLES
   $ lps api push --path ./api
 ```
 
-_See code: [src/commands/api/push.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/api/push.ts)_
+_See code: [src/commands/api/push.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/api/push.ts)_
+
+## `lps app list`
+
+List single-page apps deployed to WordPress
+
+```
+USAGE
+  $ lps app list [--json] [--env <value>]
+
+FLAGS
+  --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  List single-page apps deployed to WordPress
+
+EXAMPLES
+  $ lps app list
+```
+
+_See code: [src/commands/app/list.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/app/list.ts)_
+
+## `lps app pull [PATH]`
+
+Pull single-page app bundles from WordPress into local files
+
+```
+USAGE
+  $ lps app pull [PATH] [--json] [--env <value>] [-d] [-y]
+
+ARGUMENTS
+  [PATH]  Path to apps directory (overrides project config)
+
+FLAGS
+  -d, --dry-run      Show what would change without making changes
+  -y, --yes          Answer yes to confirmation prompts
+      --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Pull single-page app bundles from WordPress into local files
+
+EXAMPLES
+  $ lps app pull
+```
+
+_See code: [src/commands/app/pull.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/app/pull.ts)_
+
+## `lps app push [NAME]`
+
+Push built single-page app bundles to WordPress. Each app is an `apps/<name>/` directory holding a loopress.app.json and a built dist/ folder. Only files whose content changed are uploaded.
+
+```
+USAGE
+  $ lps app push [NAME] [--json] [--env <value>] [-d] [-y]
+
+ARGUMENTS
+  [NAME]  Push only this app (defaults to every app in the directory)
+
+FLAGS
+  -d, --dry-run      Show what would change without making changes
+  -y, --yes          Answer yes to confirmation prompts
+      --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Push built single-page app bundles to WordPress. Each app is an `apps/<name>/` directory holding a loopress.app.json
+  and a built dist/ folder. Only files whose content changed are uploaded.
+
+EXAMPLES
+  $ lps app push
+
+  $ lps app push search
+```
+
+_See code: [src/commands/app/push.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/app/push.ts)_
+
+## `lps app remove NAME`
+
+Remove a single-page app from WordPress: deletes its bundle from wp-content/loopress/apps/ and unregisters the shortcode. Local files are left untouched.
+
+```
+USAGE
+  $ lps app remove NAME [--json] [--env <value>] [-d] [-y]
+
+ARGUMENTS
+  NAME  App to remove from WordPress
+
+FLAGS
+  -d, --dry-run      Show what would change without making changes
+  -y, --yes          Answer yes to confirmation prompts
+      --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Remove a single-page app from WordPress: deletes its bundle from wp-content/loopress/apps/ and unregisters the
+  shortcode. Local files are left untouched.
+
+EXAMPLES
+  $ lps app remove search
+```
+
+_See code: [src/commands/app/remove.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/app/remove.ts)_
 
 ## `lps composer init`
 
@@ -306,7 +504,7 @@ EXAMPLES
   $ lps composer init --dry-run
 ```
 
-_See code: [src/commands/composer/init.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/composer/init.ts)_
+_See code: [src/commands/composer/init.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/composer/init.ts)_
 
 ## `lps composer pull`
 
@@ -332,26 +530,27 @@ EXAMPLES
   $ lps composer pull --dry-run
 ```
 
-_See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/composer/pull.ts)_
+_See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/composer/pull.ts)_
 
 ## `lps composer push`
 
-Push composer.json and composer.lock to WordPress and run composer install
+Push composer.json (and composer.lock, if present) to WordPress and run Composer
 
 ```
 USAGE
-  $ lps composer push [--json] [--env <value>] [-d] [-y]
+  $ lps composer push [--json] [--env <value>] [-d] [-y] [--force]
 
 FLAGS
   -d, --dry-run      Show what would change without making changes
   -y, --yes          Answer yes to confirmation prompts
       --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+      --force        Allow downgrades and take over plugins/themes installed outside Loopress
 
 GLOBAL FLAGS
   --json  Format output as json.
 
 DESCRIPTION
-  Push composer.json and composer.lock to WordPress and run composer install
+  Push composer.json (and composer.lock, if present) to WordPress and run Composer
 
 EXAMPLES
   $ lps composer push
@@ -359,7 +558,7 @@ EXAMPLES
   $ lps composer push --dry-run
 ```
 
-_See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/composer/push.ts)_
+_See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/composer/push.ts)_
 
 ## `lps dev`
 
@@ -370,8 +569,8 @@ USAGE
   $ lps dev [--only <value>] [--skip <value>]
 
 FLAGS
-  --only=<value>  Only watch these resource types (comma-separated): snippets, pages, api, plugins
-  --skip=<value>  Skip these resource types (comma-separated): snippets, pages, api, plugins
+  --only=<value>  Only watch these resource types (comma-separated): snippets, api, plugins
+  --skip=<value>  Skip these resource types (comma-separated): snippets, api, plugins
 
 DESCRIPTION
   Watch project files and push changes to the local WordPress instance as they happen. Always targets the "local"
@@ -380,12 +579,52 @@ DESCRIPTION
 EXAMPLES
   $ lps dev
 
-  $ lps dev --only=snippets,pages
+  $ lps dev --only=snippets,api
 
   $ lps dev --skip=plugins
 ```
 
-_See code: [src/commands/dev.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/dev.ts)_
+_See code: [src/commands/dev.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/dev.ts)_
+
+## `lps diff`
+
+Show what differs between your local tracked files and a WordPress environment, or between two environments. Covers snippets, forms, ACF, API routes, Hooks, SEO, and Composer. Plugins and themes have their own `lps plugin status` / `lps theme status`. Exit code: 0 in sync, 1 on drift, 2 when a resource could not be compared, so it doubles as a CI drift gate.
+
+```
+USAGE
+  $ lps diff [--json] [--env <value>] [--against <value>] [--only
+    snippet|form|acf|api|hook|seo|option|composer...] [--skip snippet|form|acf|api|hook|seo|option|composer...]
+
+FLAGS
+  --against=<value>   Compare the primary environment against this second environment instead of against local files
+  --env=<value>       Target environment by name, overriding the globally active one (lps project switch)
+  --only=<option>...  Only compare these resources
+                      <options: snippet|form|acf|api|hook|seo|option|composer>
+  --skip=<option>...  Compare every resource except these
+                      <options: snippet|form|acf|api|hook|seo|option|composer>
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Show what differs between your local tracked files and a WordPress environment, or between two environments. Covers
+  snippets, forms, ACF, API routes, Hooks, SEO, and Composer. Plugins and themes have their own `lps plugin status` /
+  `lps theme status`. Exit code: 0 in sync, 1 on drift, 2 when a resource could not be compared, so it doubles as a CI
+  drift gate.
+
+EXAMPLES
+  $ lps diff
+
+  $ lps diff --env staging
+
+  $ lps diff --env staging --against production
+
+  $ lps diff --only snippet --only acf
+
+  $ lps diff --skip composer
+```
+
+_See code: [src/commands/diff.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/diff.ts)_
 
 ## `lps doctor`
 
@@ -407,7 +646,38 @@ EXAMPLES
   $ lps doctor --env production
 ```
 
-_See code: [src/commands/doctor.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/doctor.ts)_
+_See code: [src/commands/doctor.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/doctor.ts)_
+
+## `lps form diff [PATH]`
+
+Show what differs in forms between your local files and a WordPress environment, or between two environments
+
+```
+USAGE
+  $ lps form diff [PATH] [--json] [--env <value>] [--against <value>]
+
+ARGUMENTS
+  [PATH]  Path to forms directory (overrides project config)
+
+FLAGS
+  --against=<value>  Compare the primary environment against this second environment instead of against local files
+  --env=<value>      Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Show what differs in forms between your local files and a WordPress environment, or between two environments
+
+EXAMPLES
+  $ lps form diff
+
+  $ lps form diff --env staging
+
+  $ lps form diff --env staging --against production
+```
+
+_See code: [src/commands/form/diff.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/form/diff.ts)_
 
 ## `lps form list`
 
@@ -430,7 +700,7 @@ EXAMPLES
   $ lps form list
 ```
 
-_See code: [src/commands/form/list.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/form/list.ts)_
+_See code: [src/commands/form/list.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/form/list.ts)_
 
 ## `lps form pull [PATH]`
 
@@ -455,7 +725,7 @@ EXAMPLES
   $ lps form pull
 ```
 
-_See code: [src/commands/form/pull.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/form/pull.ts)_
+_See code: [src/commands/form/pull.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/form/pull.ts)_
 
 ## `lps form push [PATH]`
 
@@ -481,7 +751,7 @@ EXAMPLES
   $ lps form push
 ```
 
-_See code: [src/commands/form/push.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/form/push.ts)_
+_See code: [src/commands/form/push.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/form/push.ts)_
 
 ## `lps help [COMMAND]`
 
@@ -501,7 +771,121 @@ DESCRIPTION
   Display help for lps.
 ```
 
-_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/6.3.0/src/commands/help.ts)_
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/7.0.0/src/commands/help.ts)_
+
+## `lps hook diff [PATH]`
+
+Show what differs in hook files between your local files and a WordPress environment, or between two environments
+
+```
+USAGE
+  $ lps hook diff [PATH] [--json] [--env <value>] [--against <value>]
+
+ARGUMENTS
+  [PATH]  Path to hooks directory (overrides project config)
+
+FLAGS
+  --against=<value>  Compare the primary environment against this second environment instead of against local files
+  --env=<value>      Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Show what differs in hook files between your local files and a WordPress environment, or between two environments
+
+EXAMPLES
+  $ lps hook diff
+
+  $ lps hook diff --env staging
+
+  $ lps hook diff --env staging --against production
+```
+
+_See code: [src/commands/hook/diff.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/hook/diff.ts)_
+
+## `lps hook list`
+
+List hook files (actions, filters, cron) from WordPress
+
+```
+USAGE
+  $ lps hook list [--json] [--env <value>]
+
+FLAGS
+  --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  List hook files (actions, filters, cron) from WordPress
+
+EXAMPLES
+  $ lps hook list
+```
+
+_See code: [src/commands/hook/list.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/hook/list.ts)_
+
+## `lps hook pull [PATH]`
+
+Pull hook files (actions, filters, cron) from WordPress
+
+```
+USAGE
+  $ lps hook pull [PATH] [--json] [--env <value>] [-d] [-y]
+
+ARGUMENTS
+  [PATH]  Path to hooks directory (overrides project config)
+
+FLAGS
+  -d, --dry-run      Show what would change without making changes
+  -y, --yes          Answer yes to confirmation prompts
+      --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Pull hook files (actions, filters, cron) from WordPress
+
+EXAMPLES
+  $ lps hook pull
+
+  $ lps hook pull --path ./hooks
+```
+
+_See code: [src/commands/hook/pull.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/hook/pull.ts)_
+
+## `lps hook push [PATH]`
+
+Push hook files (actions, filters, cron) to WordPress
+
+```
+USAGE
+  $ lps hook push [PATH] [--json] [--env <value>] [-d] [-y]
+
+ARGUMENTS
+  [PATH]  Path to hooks directory (overrides project config)
+
+FLAGS
+  -d, --dry-run      Show what would change without making changes
+  -y, --yes          Answer yes to confirmation prompts
+      --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Push hook files (actions, filters, cron) to WordPress
+
+EXAMPLES
+  $ lps hook push
+
+  $ lps hook push --path ./hooks
+```
+
+_See code: [src/commands/hook/push.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/hook/push.ts)_
 
 ## `lps init`
 
@@ -518,7 +902,7 @@ EXAMPLES
   $ lps init
 ```
 
-_See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/init.ts)_
 
 ## `lps login`
 
@@ -535,7 +919,7 @@ EXAMPLES
   $ lps login
 ```
 
-_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/login.ts)_
 
 ## `lps logout`
 
@@ -552,41 +936,111 @@ EXAMPLES
   $ lps logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/logout.ts)_
+
+## `lps option add NAME`
+
+Fetch a WordPress option by name and start tracking it locally. Run `lps option list` first to find the name: this copies a raw value across environments, verify it does not embed post/user IDs before pushing it elsewhere.
+
+```
+USAGE
+  $ lps option add NAME [--json] [--env <value>] [-d] [--path <value>]
+
+ARGUMENTS
+  NAME  Option name to start tracking (see `lps option list`)
+
+FLAGS
+  -d, --dry-run       Show what would change without making changes
+      --env=<value>   Target environment by name, overriding the globally active one (lps project switch)
+      --path=<value>  Path to options directory (overrides project config)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Fetch a WordPress option by name and start tracking it locally. Run `lps option list` first to find the name: this
+  copies a raw value across environments, verify it does not embed post/user IDs before pushing it elsewhere.
+
+EXAMPLES
+  $ lps option add wpseo_titles
+
+  $ lps option add siteurl
+```
+
+_See code: [src/commands/option/add.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/option/add.ts)_
+
+## `lps option diff [PATH]`
+
+Show what differs, for locally tracked options, between your local files and a WordPress environment, or between two environments
+
+```
+USAGE
+  $ lps option diff [PATH] [--json] [--env <value>] [--against <value>]
+
+ARGUMENTS
+  [PATH]  Path to options directory (overrides project config)
+
+FLAGS
+  --against=<value>  Compare the primary environment against this second environment instead of against local files
+  --env=<value>      Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Show what differs, for locally tracked options, between your local files and a WordPress environment, or between two
+  environments
+
+EXAMPLES
+  $ lps option diff
+
+  $ lps option diff --env staging
+
+  $ lps option diff --env staging --against production
+```
+
+_See code: [src/commands/option/diff.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/option/diff.ts)_
 
-## `lps page list`
+## `lps option list`
 
-List pages from WordPress
+List WordPress option names currently on the site (names and autoload only, never values). CORE flags a WordPress-native default (certain); SOURCE? is a best-effort guessed plugin slug, found by name or by scanning active plugins' own PHP source (uncertain unless confirmed, occasionally wrong or blank, never trust it over CORE); PLUGIN is that slug's own declared display name, a label only, no confidence of its own. Use this to find the name of the option you want, then `lps option add <name>` to track it.
 
 ```
 USAGE
-  $ lps page list [--json] [--env <value>]
+  $ lps option list [--json] [--env <value>] [--no-core]
 
 FLAGS
   --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+  --no-core      Exclude WordPress-native default options and the CORE column from the output, including --json
 
 GLOBAL FLAGS
   --json  Format output as json.
 
 DESCRIPTION
-  List pages from WordPress
+  List WordPress option names currently on the site (names and autoload only, never values). CORE flags a
+  WordPress-native default (certain); SOURCE? is a best-effort guessed plugin slug, found by name or by scanning active
+  plugins' own PHP source (uncertain unless confirmed, occasionally wrong or blank, never trust it over CORE); PLUGIN is
+  that slug's own declared display name, a label only, no confidence of its own. Use this to find the name of the option
+  you want, then `lps option add <name>` to track it.
 
 EXAMPLES
-  $ lps page list
+  $ lps option list
+
+  $ lps option list --no-core
 ```
 
-_See code: [src/commands/page/list.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/page/list.ts)_
+_See code: [src/commands/option/list.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/option/list.ts)_
 
-## `lps page pull [PATH]`
+## `lps option pull [PATH]`
 
-Pull pages from WordPress
+Refresh locally tracked options from WordPress. Options not yet tracked are never pulled, run `lps option add <name>` for those first.
 
 ```
 USAGE
-  $ lps page pull [PATH] [--json] [--env <value>] [-d] [-y]
+  $ lps option pull [PATH] [--json] [--env <value>] [-d] [-y]
 
 ARGUMENTS
-  [PATH]  Path to pages directory (overrides project config)
+  [PATH]  Path to options directory (overrides project config)
 
 FLAGS
   -d, --dry-run      Show what would change without making changes
@@ -597,24 +1051,25 @@ GLOBAL FLAGS
   --json  Format output as json.
 
 DESCRIPTION
-  Pull pages from WordPress
+  Refresh locally tracked options from WordPress. Options not yet tracked are never pulled, run `lps option add <name>`
+  for those first.
 
 EXAMPLES
-  $ lps page pull
+  $ lps option pull
 ```
 
-_See code: [src/commands/page/pull.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/page/pull.ts)_
+_See code: [src/commands/option/pull.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/option/pull.ts)_
 
-## `lps page push [PATH]`
+## `lps option push [PATH]`
 
-Push pages to WordPress. Local files created or updated remotely are renamed on disk to the `<id>-<slug>` convention.
+Push locally tracked, non-readonly options to WordPress (upsert only, never deletes an untracked option). Options marked "readonly": true in their local file are skipped, edit the file to override.
 
 ```
 USAGE
-  $ lps page push [PATH] [--json] [--env <value>] [-d] [-y]
+  $ lps option push [PATH] [--json] [--env <value>] [-d] [-y]
 
 ARGUMENTS
-  [PATH]  Path to pages directory (overrides project config)
+  [PATH]  Path to options directory (overrides project config)
 
 FLAGS
   -d, --dry-run      Show what would change without making changes
@@ -625,13 +1080,47 @@ GLOBAL FLAGS
   --json  Format output as json.
 
 DESCRIPTION
-  Push pages to WordPress. Local files created or updated remotely are renamed on disk to the `<id>-<slug>` convention.
+  Push locally tracked, non-readonly options to WordPress (upsert only, never deletes an untracked option). Options
+  marked "readonly": true in their local file are skipped, edit the file to override.
 
 EXAMPLES
-  $ lps page push
+  $ lps option push
+```
+
+_See code: [src/commands/option/push.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/option/push.ts)_
+
+## `lps option remove NAME`
+
+Stop tracking an option locally and delete it from WordPress. Local untracking always happens (git-reversible); pass --local-only to skip the WordPress delete and only stop tracking.
+
 ```
+USAGE
+  $ lps option remove NAME [--json] [--env <value>] [-d] [-y] [--local-only] [--path <value>]
 
-_See code: [src/commands/page/push.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/page/push.ts)_
+ARGUMENTS
+  NAME  Option name to stop tracking
+
+FLAGS
+  -d, --dry-run       Show what would change without making changes
+  -y, --yes           Answer yes to confirmation prompts
+      --env=<value>   Target environment by name, overriding the globally active one (lps project switch)
+      --local-only    Untrack locally without deleting the option on WordPress
+      --path=<value>  Path to options directory (overrides project config)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Stop tracking an option locally and delete it from WordPress. Local untracking always happens (git-reversible); pass
+  --local-only to skip the WordPress delete and only stop tracking.
+
+EXAMPLES
+  $ lps option remove wpseo_titles
+
+  $ lps option remove wpseo_titles --local-only
+```
+
+_See code: [src/commands/option/remove.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/option/remove.ts)_
 
 ## `lps plugin add SLUG`
 
@@ -639,14 +1128,15 @@ Add a WordPress.org plugin to loopress.json
 
 ```
 USAGE
-  $ lps plugin add SLUG [--env <value>] [-d]
+  $ lps plugin add SLUG [--env <value>] [-d] [--version <value>]
 
 ARGUMENTS
   SLUG  Plugin slug on WordPress.org
 
 FLAGS
-  -d, --dry-run      Show what would change without making changes
-      --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+  -d, --dry-run          Show what would change without making changes
+      --env=<value>      Target environment by name, overriding the globally active one (lps project switch)
+      --version=<value>  Exact version to pin (default: "latest", tracked on every push)
 
 DESCRIPTION
   Add a WordPress.org plugin to loopress.json
@@ -654,14 +1144,39 @@ DESCRIPTION
 EXAMPLES
   $ lps plugin add woocommerce
 
+  $ lps plugin add woocommerce --version 9.4.2
+
   $ lps plugin add contact-form-7 --dry-run
 ```
 
-_See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/plugin/add.ts)_
+_See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/plugin/add.ts)_
+
+## `lps plugin audit`
+
+Check the plugins in loopress.json for known vulnerabilities and health issues
+
+```
+USAGE
+  $ lps plugin audit [--json] [--env <value>]
+
+FLAGS
+  --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Check the plugins in loopress.json for known vulnerabilities and health issues
+
+EXAMPLES
+  $ lps plugin audit
+```
+
+_See code: [src/commands/plugin/audit.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/plugin/audit.ts)_
 
 ## `lps plugin pull`
 
-Pull installed plugins from WordPress into loopress.json
+Pull installed plugins from WordPress into loopress.json, pinned to their live versions
 
 ```
 USAGE
@@ -675,7 +1190,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 
 DESCRIPTION
-  Pull installed plugins from WordPress into loopress.json
+  Pull installed plugins from WordPress into loopress.json, pinned to their live versions
 
 EXAMPLES
   $ lps plugin pull
@@ -683,34 +1198,61 @@ EXAMPLES
   $ lps plugin pull --dry-run
 ```
 
-_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/plugin/pull.ts)_
+_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/plugin/pull.ts)_
 
 ## `lps plugin push`
 
-Push plugins to WordPress to match loopress.json
+Install plugins on WordPress to match loopress.json, pinned via Composer + WPackagist
 
 ```
 USAGE
-  $ lps plugin push [--json] [--env <value>] [-d] [-y]
+  $ lps plugin push [--json] [--env <value>] [-d] [-y] [--force] [--prune]
 
 FLAGS
   -d, --dry-run      Show what would change without making changes
   -y, --yes          Answer yes to confirmation prompts
       --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+      --force        Allow downgrades and let Loopress take over plugins installed outside it (replaces their files)
+      --prune        Deactivate plugins that are active on the site but absent from loopress.json
 
 GLOBAL FLAGS
   --json  Format output as json.
 
 DESCRIPTION
-  Push plugins to WordPress to match loopress.json
+  Install plugins on WordPress to match loopress.json, pinned via Composer + WPackagist
 
 EXAMPLES
   $ lps plugin push
 
   $ lps plugin push --dry-run
+
+  $ lps plugin push --force --prune
+```
+
+_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/plugin/push.ts)_
+
+## `lps plugin status`
+
+Compare the plugins on WordPress against loopress.json and report drift
+
+```
+USAGE
+  $ lps plugin status [--json] [--env <value>]
+
+FLAGS
+  --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Compare the plugins on WordPress against loopress.json and report drift
+
+EXAMPLES
+  $ lps plugin status
 ```
 
-_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/plugin/push.ts)_
+_See code: [src/commands/plugin/status.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/plugin/status.ts)_
 
 ## `lps project config`
 
@@ -728,7 +1270,7 @@ EXAMPLES
   $ lps project config
 ```
 
-_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/project/config.ts)_
+_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/project/config.ts)_
 
 ## `lps project list`
 
@@ -748,7 +1290,7 @@ EXAMPLES
   $ lps project list
 ```
 
-_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/project/list.ts)_
+_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/project/list.ts)_
 
 ## `lps project pull`
 
@@ -765,7 +1307,7 @@ EXAMPLES
   $ lps project pull
 ```
 
-_See code: [src/commands/project/pull.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/project/pull.ts)_
+_See code: [src/commands/project/pull.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/project/pull.ts)_
 
 ## `lps project push`
 
@@ -785,7 +1327,7 @@ EXAMPLES
   $ lps project push
 ```
 
-_See code: [src/commands/project/push.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/project/push.ts)_
+_See code: [src/commands/project/push.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/project/push.ts)_
 
 ## `lps project remove`
 
@@ -802,7 +1344,7 @@ EXAMPLES
   $ lps project remove
 ```
 
-_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/project/remove.ts)_
+_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/project/remove.ts)_
 
 ## `lps project rotate`
 
@@ -824,7 +1366,7 @@ EXAMPLES
   $ lps project rotate --env staging
 ```
 
-_See code: [src/commands/project/rotate.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/project/rotate.ts)_
+_See code: [src/commands/project/rotate.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/project/rotate.ts)_
 
 ## `lps project switch`
 
@@ -841,7 +1383,7 @@ EXAMPLES
   $ lps project switch
 ```
 
-_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/project/switch.ts)_
+_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/project/switch.ts)_
 
 ## `lps promote FROM TO`
 
@@ -869,11 +1411,11 @@ EXAMPLES
   $ lps promote production staging --dry-run
 ```
 
-_See code: [src/commands/promote.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/promote.ts)_
+_See code: [src/commands/promote.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/promote.ts)_
 
 ## `lps pull`
 
-Pull all content, plugins, composer dependencies, ACF, API routes, forms, pages, SEO, and snippets, from WordPress
+Pull all content, plugins, composer dependencies, ACF, API routes, hooks, forms, SEO, options, and snippets, from WordPress
 
 ```
 USAGE
@@ -885,7 +1427,8 @@ FLAGS
       --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
 
 DESCRIPTION
-  Pull all content, plugins, composer dependencies, ACF, API routes, forms, pages, SEO, and snippets, from WordPress
+  Pull all content, plugins, composer dependencies, ACF, API routes, hooks, forms, SEO, options, and snippets, from
+  WordPress
 
 EXAMPLES
   $ lps pull
@@ -895,11 +1438,11 @@ EXAMPLES
   $ lps pull --dry-run
 ```
 
-_See code: [src/commands/pull.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/pull.ts)_
+_See code: [src/commands/pull.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/pull.ts)_
 
 ## `lps push`
 
-Push all local content, plugins, composer dependencies, ACF, API routes, forms, pages, SEO, and snippets, to WordPress
+Push all local content, plugins, composer dependencies, ACF, API routes, hooks, forms, SEO, options, and snippets, to WordPress
 
 ```
 USAGE
@@ -911,7 +1454,8 @@ FLAGS
       --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
 
 DESCRIPTION
-  Push all local content, plugins, composer dependencies, ACF, API routes, forms, pages, SEO, and snippets, to WordPress
+  Push all local content, plugins, composer dependencies, ACF, API routes, hooks, forms, SEO, options, and snippets, to
+  WordPress
 
 EXAMPLES
   $ lps push
@@ -921,7 +1465,39 @@ EXAMPLES
   $ lps push --dry-run
 ```
 
-_See code: [src/commands/push.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/push.ts)_
+_See code: [src/commands/push.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/push.ts)_
+
+## `lps seo diff [PATH]`
+
+Show what differs in SEO settings, post meta, and redirects between your local files and a WordPress environment, or between two environments
+
+```
+USAGE
+  $ lps seo diff [PATH] [--json] [--env <value>] [--against <value>]
+
+ARGUMENTS
+  [PATH]  Path to SEO directory (overrides project config)
+
+FLAGS
+  --against=<value>  Compare the primary environment against this second environment instead of against local files
+  --env=<value>      Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Show what differs in SEO settings, post meta, and redirects between your local files and a WordPress environment, or
+  between two environments
+
+EXAMPLES
+  $ lps seo diff
+
+  $ lps seo diff --env staging
+
+  $ lps seo diff --env staging --against production
+```
+
+_See code: [src/commands/seo/diff.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/seo/diff.ts)_
 
 ## `lps seo list`
 
@@ -947,7 +1523,7 @@ EXAMPLES
   $ lps seo list --post-type post
 ```
 
-_See code: [src/commands/seo/list.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/seo/list.ts)_
+_See code: [src/commands/seo/list.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/seo/list.ts)_
 
 ## `lps seo pull [PATH]`
 
@@ -975,7 +1551,7 @@ EXAMPLES
   $ lps seo pull --post-type post --post-type page
 ```
 
-_See code: [src/commands/seo/pull.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/seo/pull.ts)_
+_See code: [src/commands/seo/pull.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/seo/pull.ts)_
 
 ## `lps seo push [PATH]`
 
@@ -1001,7 +1577,38 @@ EXAMPLES
   $ lps seo push
 ```
 
-_See code: [src/commands/seo/push.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/seo/push.ts)_
+_See code: [src/commands/seo/push.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/seo/push.ts)_
+
+## `lps snippet diff [PATH]`
+
+Show what differs in snippets between your local files and a WordPress environment, or between two environments
+
+```
+USAGE
+  $ lps snippet diff [PATH] [--json] [--env <value>] [--against <value>]
+
+ARGUMENTS
+  [PATH]  Path to snippets directory (overrides project config)
+
+FLAGS
+  --against=<value>  Compare the primary environment against this second environment instead of against local files
+  --env=<value>      Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Show what differs in snippets between your local files and a WordPress environment, or between two environments
+
+EXAMPLES
+  $ lps snippet diff
+
+  $ lps snippet diff --env staging
+
+  $ lps snippet diff --env staging --against production
+```
+
+_See code: [src/commands/snippet/diff.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/snippet/diff.ts)_
 
 ## `lps snippet list`
 
@@ -1024,7 +1631,7 @@ EXAMPLES
   $ lps snippet list
 ```
 
-_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/snippet/list.ts)_
+_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/snippet/list.ts)_
 
 ## `lps snippet publish [PATH]`
 
@@ -1047,7 +1654,7 @@ EXAMPLES
   $ lps snippet publish --path ./snippets
 ```
 
-_See code: [src/commands/snippet/publish.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/snippet/publish.ts)_
+_See code: [src/commands/snippet/publish.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/snippet/publish.ts)_
 
 ## `lps snippet pull [PATH]`
 
@@ -1077,7 +1684,7 @@ EXAMPLES
   $ lps snippet pull --path ./snippets
 ```
 
-_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/snippet/pull.ts)_
+_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/snippet/pull.ts)_
 
 ## `lps snippet push [PATH]`
 
@@ -1108,7 +1715,7 @@ EXAMPLES
   $ lps snippet push --path ./snippets
 ```
 
-_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/snippet/push.ts)_
+_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/snippet/push.ts)_
 
 ## `lps status`
 
@@ -1133,7 +1740,7 @@ EXAMPLES
   $ lps status --env staging
 ```
 
-_See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/status.ts)_
+_See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/status.ts)_
 
 ## `lps telemetry disable`
 
@@ -1150,7 +1757,7 @@ EXAMPLES
   $ lps telemetry disable
 ```
 
-_See code: [src/commands/telemetry/disable.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/telemetry/disable.ts)_
+_See code: [src/commands/telemetry/disable.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/telemetry/disable.ts)_
 
 ## `lps telemetry enable`
 
@@ -1167,7 +1774,109 @@ EXAMPLES
   $ lps telemetry enable
 ```
 
-_See code: [src/commands/telemetry/enable.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/telemetry/enable.ts)_
+_See code: [src/commands/telemetry/enable.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/telemetry/enable.ts)_
+
+## `lps theme add SLUG`
+
+Add a WordPress.org theme to loopress.json
+
+```
+USAGE
+  $ lps theme add SLUG [--env <value>] [-d] [--version <value>]
+
+ARGUMENTS
+  SLUG  Theme slug on WordPress.org
+
+FLAGS
+  -d, --dry-run          Show what would change without making changes
+      --env=<value>      Target environment by name, overriding the globally active one (lps project switch)
+      --version=<value>  Exact version to pin (default: "latest")
+
+DESCRIPTION
+  Add a WordPress.org theme to loopress.json
+
+EXAMPLES
+  $ lps theme add generatepress
+
+  $ lps theme add generatepress --version 3.4.0
+```
+
+_See code: [src/commands/theme/add.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/theme/add.ts)_
+
+## `lps theme pull`
+
+Pull installed themes from WordPress into loopress.json, pinned to their live versions
+
+```
+USAGE
+  $ lps theme pull [--json] [--env <value>] [-d]
+
+FLAGS
+  -d, --dry-run      Show what would change without making changes
+      --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Pull installed themes from WordPress into loopress.json, pinned to their live versions
+
+EXAMPLES
+  $ lps theme pull
+```
+
+_See code: [src/commands/theme/pull.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/theme/pull.ts)_
+
+## `lps theme push`
+
+Install themes on WordPress to match loopress.json (versions only, never switches the active theme)
+
+```
+USAGE
+  $ lps theme push [--json] [--env <value>] [-d] [-y] [--force]
+
+FLAGS
+  -d, --dry-run      Show what would change without making changes
+  -y, --yes          Answer yes to confirmation prompts
+      --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+      --force        Allow downgrades and take over themes installed outside Loopress
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Install themes on WordPress to match loopress.json (versions only, never switches the active theme)
+
+EXAMPLES
+  $ lps theme push
+
+  $ lps theme push --force
+```
+
+_See code: [src/commands/theme/push.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/theme/push.ts)_
+
+## `lps theme status`
+
+Compare the themes on WordPress against loopress.json and report version drift
+
+```
+USAGE
+  $ lps theme status [--json] [--env <value>]
+
+FLAGS
+  --env=<value>  Target environment by name, overriding the globally active one (lps project switch)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Compare the themes on WordPress against loopress.json and report version drift
+
+EXAMPLES
+  $ lps theme status
+```
+
+_See code: [src/commands/theme/status.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/theme/status.ts)_
 
 ## `lps validate`
 
@@ -1187,5 +1896,5 @@ EXAMPLES
   $ lps validate
 ```
 
-_See code: [src/commands/validate.ts](https://github.com/loopress/loopress/blob/v0.22.0/src/commands/validate.ts)_
+_See code: [src/commands/validate.ts](https://github.com/loopress/loopress/blob/v0.24.0/src/commands/validate.ts)_
 <!-- commandsstop -->