@loopress/cli 0.27.0 → 0.29.0

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g @loopress/cli
 $ lps COMMAND
 running command...
 $ lps (--version)
-@loopress/cli/0.27.0 linux-x64 node-v24.21.0
+@loopress/cli/0.29.0 linux-x64 node-v24.21.0
 $ lps --help [COMMAND]
 USAGE
   $ lps COMMAND
@@ -57,6 +57,7 @@ report.
 * [`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 api remove FILENAME`](#lps-api-remove-filename)
 * [`lps api rm FILENAME`](#lps-api-rm-filename)
 * [`lps api rollback [PATH]`](#lps-api-rollback-path)
 * [`lps app list`](#lps-app-list)
@@ -79,6 +80,7 @@ report.
 * [`lps hook list`](#lps-hook-list)
 * [`lps hook pull [PATH]`](#lps-hook-pull-path)
 * [`lps hook push [PATH]`](#lps-hook-push-path)
+* [`lps hook remove FILENAME`](#lps-hook-remove-filename)
 * [`lps hook rm FILENAME`](#lps-hook-rm-filename)
 * [`lps hook rollback [PATH]`](#lps-hook-rollback-path)
 * [`lps init`](#lps-init)
@@ -128,14 +130,19 @@ report.
 * [`lps status`](#lps-status)
 * [`lps telemetry disable`](#lps-telemetry-disable)
 * [`lps telemetry enable`](#lps-telemetry-enable)
-* [`lps theme-styles diff [PATH]`](#lps-theme-styles-diff-path)
-* [`lps theme-styles pull [PATH]`](#lps-theme-styles-pull-path)
-* [`lps theme-styles push [PATH]`](#lps-theme-styles-push-path)
-* [`lps theme-styles rollback [PATH]`](#lps-theme-styles-rollback-path)
 * [`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 theme style diff [PATH]`](#lps-theme-style-diff-path)
+* [`lps theme style pull [PATH]`](#lps-theme-style-pull-path)
+* [`lps theme style push [PATH]`](#lps-theme-style-push-path)
+* [`lps theme style rollback [PATH]`](#lps-theme-style-rollback-path)
+* [`lps theme template diff`](#lps-theme-template-diff)
+* [`lps theme template list`](#lps-theme-template-list)
+* [`lps theme template push`](#lps-theme-template-push)
+* [`lps theme version pull`](#lps-theme-version-pull)
+* [`lps theme version push`](#lps-theme-version-push)
 * [`lps validate`](#lps-validate)
 
 ## `lps acf diff [PATH]`
@@ -168,7 +175,7 @@ EXAMPLES
   $ lps acf diff --env staging --against production
 ```
 
-_See code: [src/commands/acf/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/acf/diff.ts)_
+_See code: [src/commands/acf/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/acf/diff.ts)_
 
 ## `lps acf list`
 
@@ -195,7 +202,7 @@ EXAMPLES
   $ lps acf list --type field-groups
 ```
 
-_See code: [src/commands/acf/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/acf/list.ts)_
+_See code: [src/commands/acf/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/acf/list.ts)_
 
 ## `lps acf pull [PATH]`
 
@@ -203,7 +210,8 @@ Pull ACF field groups, post types, taxonomies, and options pages from WordPress
 
 ```
 USAGE
-  $ lps acf pull [PATH] [--env <value>] [-d] [-y] [--type field-groups|post-types|taxonomies|options-pages...]
+  $ lps acf pull [PATH] [--json] [--env <value>] [-d] [-y] [--type
+    field-groups|post-types|taxonomies|options-pages...]
 
 ARGUMENTS
   [PATH]  Path to ACF directory (overrides project config)
@@ -215,6 +223,9 @@ FLAGS
       --type=<option>...  Limit to specific ACF object types
                           <options: field-groups|post-types|taxonomies|options-pages>
 
+GLOBAL FLAGS
+  --json  Format output as json.
+
 DESCRIPTION
   Pull ACF field groups, post types, taxonomies, and options pages from WordPress
 
@@ -224,7 +235,7 @@ EXAMPLES
   $ lps acf pull --type field-groups
 ```
 
-_See code: [src/commands/acf/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/acf/pull.ts)_
+_See code: [src/commands/acf/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/acf/pull.ts)_
 
 ## `lps acf push [PATH]`
 
@@ -232,7 +243,8 @@ Push ACF field groups, post types, taxonomies, and options pages to WordPress
 
 ```
 USAGE
-  $ lps acf push [PATH] [--env <value>] [-d] [-y] [--type field-groups|post-types|taxonomies|options-pages...]
+  $ lps acf push [PATH] [--json] [--env <value>] [-d] [-y] [--type
+    field-groups|post-types|taxonomies|options-pages...]
 
 ARGUMENTS
   [PATH]  Path to ACF directory (overrides project config)
@@ -244,6 +256,9 @@ FLAGS
       --type=<option>...  Limit to specific ACF object types
                           <options: field-groups|post-types|taxonomies|options-pages>
 
+GLOBAL FLAGS
+  --json  Format output as json.
+
 DESCRIPTION
   Push ACF field groups, post types, taxonomies, and options pages to WordPress
 
@@ -253,7 +268,7 @@ EXAMPLES
   $ lps acf push --type field-groups
 ```
 
-_See code: [src/commands/acf/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/acf/push.ts)_
+_See code: [src/commands/acf/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/acf/push.ts)_
 
 ## `lps acf rollback [PATH]`
 
@@ -290,7 +305,7 @@ EXAMPLES
   $ lps acf rollback --dry-run
 ```
 
-_See code: [src/commands/acf/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/acf/rollback.ts)_
+_See code: [src/commands/acf/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/acf/rollback.ts)_
 
 ## `lps api diff [PATH]`
 
@@ -322,7 +337,7 @@ EXAMPLES
   $ lps api diff --env staging --against production
 ```
 
-_See code: [src/commands/api/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/api/diff.ts)_
+_See code: [src/commands/api/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/api/diff.ts)_
 
 ## `lps api list`
 
@@ -345,7 +360,7 @@ EXAMPLES
   $ lps api list
 ```
 
-_See code: [src/commands/api/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/api/list.ts)_
+_See code: [src/commands/api/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/api/list.ts)_
 
 ## `lps api publish [PATH]`
 
@@ -365,10 +380,10 @@ DESCRIPTION
 EXAMPLES
   $ lps api publish
 
-  $ lps api publish --path ./api
+  $ lps api publish ./api
 ```
 
-_See code: [src/commands/api/publish.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/api/publish.ts)_
+_See code: [src/commands/api/publish.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/api/publish.ts)_
 
 ## `lps api pull [PATH]`
 
@@ -398,7 +413,7 @@ EXAMPLES
   $ lps api pull --path ./api
 ```
 
-_See code: [src/commands/api/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/api/pull.ts)_
+_See code: [src/commands/api/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/api/pull.ts)_
 
 ## `lps api push [PATH]`
 
@@ -431,7 +446,38 @@ EXAMPLES
   $ lps api push --prune
 ```
 
-_See code: [src/commands/api/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/api/push.ts)_
+_See code: [src/commands/api/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/api/push.ts)_
+
+## `lps api remove FILENAME`
+
+Remove a custom API route file from WordPress
+
+```
+USAGE
+  $ lps api remove FILENAME [--json] [--env <value>] [-d] [-y]
+
+ARGUMENTS
+  FILENAME  The route file to remove, its slug without the .php extension (e.g. "hello" or "invoice-pdf/[order_id]")
+
+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 custom API route file from WordPress
+
+ALIASES
+  $ lps api remove
+
+EXAMPLES
+  $ lps api rm hello
+
+  $ lps api remove hello --yes
+```
 
 ## `lps api rm FILENAME`
 
@@ -455,13 +501,16 @@ GLOBAL FLAGS
 DESCRIPTION
   Remove a custom API route file from WordPress
 
+ALIASES
+  $ lps api remove
+
 EXAMPLES
   $ lps api rm hello
 
-  $ lps api rm hello --yes
+  $ lps api remove hello --yes
 ```
 
-_See code: [src/commands/api/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/api/rm.ts)_
+_See code: [src/commands/api/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/api/rm.ts)_
 
 ## `lps api rollback [PATH]`
 
@@ -497,7 +546,7 @@ EXAMPLES
   $ lps api rollback --dry-run
 ```
 
-_See code: [src/commands/api/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/api/rollback.ts)_
+_See code: [src/commands/api/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/api/rollback.ts)_
 
 ## `lps app list`
 
@@ -520,7 +569,7 @@ EXAMPLES
   $ lps app list
 ```
 
-_See code: [src/commands/app/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/app/list.ts)_
+_See code: [src/commands/app/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/app/list.ts)_
 
 ## `lps app pull [PATH]`
 
@@ -548,15 +597,15 @@ EXAMPLES
   $ lps app pull
 ```
 
-_See code: [src/commands/app/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/app/pull.ts)_
+_See code: [src/commands/app/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/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.
+Build and push single-page app bundles to WordPress. Each app is an `apps/<name>/` directory holding a loopress.app.json and a dist/ folder. When the app has a package.json with a `build` script, it runs first (use --no-build to skip it). Only files whose content changed are uploaded.
 
 ```
 USAGE
-  $ lps app push [NAME] [--json] [--env <value>] [-d] [-y]
+  $ lps app push [NAME] [--json] [--env <value>] [--build] [-d] [-y]
 
 ARGUMENTS
   [NAME]  Push only this app (defaults to every app in the directory)
@@ -564,22 +613,26 @@ ARGUMENTS
 FLAGS
   -d, --dry-run      Show what would change without making changes
   -y, --yes          Answer yes to confirmation prompts
+      --[no-]build   Run the app's package.json build script before pushing
       --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.
+  Build and push single-page app bundles to WordPress. Each app is an `apps/<name>/` directory holding a
+  loopress.app.json and a dist/ folder. When the app has a package.json with a `build` script, it runs first (use
+  --no-build to skip it). Only files whose content changed are uploaded.
 
 EXAMPLES
   $ lps app push
 
   $ lps app push search
+
+  $ lps app push --no-build
 ```
 
-_See code: [src/commands/app/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/app/push.ts)_
+_See code: [src/commands/app/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/app/push.ts)_
 
 ## `lps app remove NAME`
 
@@ -608,7 +661,7 @@ EXAMPLES
   $ lps app remove search
 ```
 
-_See code: [src/commands/app/remove.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/app/remove.ts)_
+_See code: [src/commands/app/remove.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/app/remove.ts)_
 
 ## `lps composer init`
 
@@ -631,7 +684,7 @@ EXAMPLES
   $ lps composer init --dry-run
 ```
 
-_See code: [src/commands/composer/init.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/composer/init.ts)_
+_See code: [src/commands/composer/init.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/composer/init.ts)_
 
 ## `lps composer pull`
 
@@ -657,7 +710,7 @@ EXAMPLES
   $ lps composer pull --dry-run
 ```
 
-_See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/composer/pull.ts)_
+_See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/composer/pull.ts)_
 
 ## `lps composer push`
 
@@ -685,7 +738,7 @@ EXAMPLES
   $ lps composer push --dry-run
 ```
 
-_See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/composer/push.ts)_
+_See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/composer/push.ts)_
 
 ## `lps dev`
 
@@ -696,8 +749,9 @@ USAGE
   $ lps dev [--only <value>] [--skip <value>]
 
 FLAGS
-  --only=<value>  Only watch these resource types (comma-separated): snippets, pages, api, hooks, plugins
-  --skip=<value>  Skip these resource types (comma-separated): snippets, pages, api, hooks, plugins
+  --only=<value>  Only watch these resource types (comma-separated): snippets, templates, parts, pages, api, hooks,
+                  plugins
+  --skip=<value>  Skip these resource types (comma-separated): snippets, templates, parts, pages, api, hooks, plugins
 
 DESCRIPTION
   Watch project files and push changes to the local WordPress instance as they happen. Always targets the "local"
@@ -711,34 +765,34 @@ EXAMPLES
   $ lps dev --skip=plugins
 ```
 
-_See code: [src/commands/dev.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/dev.ts)_
+_See code: [src/commands/dev.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/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, pages, SEO, Options, Menus, Theme styles, 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.
+Show what differs between your local tracked files and a WordPress environment, or between two environments. Covers snippets, forms, ACF, API routes, Hooks, templates, template parts, pages, SEO, Options, Menus, Theme styles, 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|page|seo|menu|option|theme-styles|composer...] [--skip
-    snippet|form|acf|api|hook|page|seo|menu|option|theme-styles|composer...]
+    snippet|form|acf|api|hook|template|part|page|seo|menu|option|theme-styles|composer...] [--skip
+    snippet|form|acf|api|hook|template|part|page|seo|menu|option|theme-styles|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|page|seo|menu|option|theme-styles|composer>
+                      <options: snippet|form|acf|api|hook|template|part|page|seo|menu|option|theme-styles|composer>
   --skip=<option>...  Compare every resource except these
-                      <options: snippet|form|acf|api|hook|page|seo|menu|option|theme-styles|composer>
+                      <options: snippet|form|acf|api|hook|template|part|page|seo|menu|option|theme-styles|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, pages, SEO, Options, Menus, Theme styles, 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.
+  snippets, forms, ACF, API routes, Hooks, templates, template parts, pages, SEO, Options, Menus, Theme styles, 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
@@ -752,7 +806,7 @@ EXAMPLES
   $ lps diff --skip composer
 ```
 
-_See code: [src/commands/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/diff.ts)_
+_See code: [src/commands/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/diff.ts)_
 
 ## `lps doctor`
 
@@ -777,7 +831,7 @@ EXAMPLES
   $ lps doctor --env production
 ```
 
-_See code: [src/commands/doctor.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/doctor.ts)_
+_See code: [src/commands/doctor.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/doctor.ts)_
 
 ## `lps form diff [PATH]`
 
@@ -808,7 +862,7 @@ EXAMPLES
   $ lps form diff --env staging --against production
 ```
 
-_See code: [src/commands/form/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/form/diff.ts)_
+_See code: [src/commands/form/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/form/diff.ts)_
 
 ## `lps form list`
 
@@ -831,7 +885,7 @@ EXAMPLES
   $ lps form list
 ```
 
-_See code: [src/commands/form/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/form/list.ts)_
+_See code: [src/commands/form/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/form/list.ts)_
 
 ## `lps form pull [PATH]`
 
@@ -839,7 +893,7 @@ Pull forms from WordPress
 
 ```
 USAGE
-  $ lps form pull [PATH] [--env <value>] [-d] [-y]
+  $ lps form pull [PATH] [--json] [--env <value>] [-d] [-y]
 
 ARGUMENTS
   [PATH]  Path to forms directory (overrides project config)
@@ -849,6 +903,9 @@ FLAGS
   -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 forms from WordPress
 
@@ -856,7 +913,7 @@ EXAMPLES
   $ lps form pull
 ```
 
-_See code: [src/commands/form/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/form/pull.ts)_
+_See code: [src/commands/form/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/form/pull.ts)_
 
 ## `lps form push [PATH]`
 
@@ -864,7 +921,7 @@ Push forms to WordPress. Local files created or updated remotely are renamed on
 
 ```
 USAGE
-  $ lps form push [PATH] [--env <value>] [-d] [-y] [--allow-notifications]
+  $ lps form push [PATH] [--json] [--env <value>] [-d] [-y] [--allow-notifications]
 
 ARGUMENTS
   [PATH]  Path to forms directory (overrides project config)
@@ -877,6 +934,9 @@ FLAGS
                              submissions.
       --env=<value>          Target environment by name, overriding the globally active one (lps project switch)
 
+GLOBAL FLAGS
+  --json  Format output as json.
+
 DESCRIPTION
   Push forms to WordPress. Local files created or updated remotely are renamed on disk to the `<id>-<slug>.json`
   convention.
@@ -887,7 +947,7 @@ EXAMPLES
   $ lps form push --allow-notifications
 ```
 
-_See code: [src/commands/form/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/form/push.ts)_
+_See code: [src/commands/form/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/form/push.ts)_
 
 ## `lps form rollback [PATH]`
 
@@ -923,7 +983,7 @@ EXAMPLES
   $ lps form rollback --dry-run
 ```
 
-_See code: [src/commands/form/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/form/rollback.ts)_
+_See code: [src/commands/form/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/form/rollback.ts)_
 
 ## `lps help [COMMAND]`
 
@@ -943,7 +1003,7 @@ DESCRIPTION
   Display help for lps.
 ```
 
-_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/7.0.0/src/commands/help.ts)_
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/7.0.2/src/commands/help.ts)_
 
 ## `lps hook diff [PATH]`
 
@@ -974,7 +1034,7 @@ EXAMPLES
   $ lps hook diff --env staging --against production
 ```
 
-_See code: [src/commands/hook/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/hook/diff.ts)_
+_See code: [src/commands/hook/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/hook/diff.ts)_
 
 ## `lps hook list`
 
@@ -997,7 +1057,7 @@ EXAMPLES
   $ lps hook list
 ```
 
-_See code: [src/commands/hook/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/hook/list.ts)_
+_See code: [src/commands/hook/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/hook/list.ts)_
 
 ## `lps hook pull [PATH]`
 
@@ -1027,7 +1087,7 @@ EXAMPLES
   $ lps hook pull --path ./hooks
 ```
 
-_See code: [src/commands/hook/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/hook/pull.ts)_
+_See code: [src/commands/hook/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/hook/pull.ts)_
 
 ## `lps hook push [PATH]`
 
@@ -1060,7 +1120,38 @@ EXAMPLES
   $ lps hook push --prune
 ```
 
-_See code: [src/commands/hook/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/hook/push.ts)_
+_See code: [src/commands/hook/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/hook/push.ts)_
+
+## `lps hook remove FILENAME`
+
+Remove a hook file (action, filter, cron) from WordPress
+
+```
+USAGE
+  $ lps hook remove FILENAME [--json] [--env <value>] [-d] [-y]
+
+ARGUMENTS
+  FILENAME  The hook file to remove, its slug without the .php extension (e.g. "hello" or "invoice-pdf/[order_id]")
+
+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 hook file (action, filter, cron) from WordPress
+
+ALIASES
+  $ lps hook remove
+
+EXAMPLES
+  $ lps hook rm hello
+
+  $ lps hook remove hello --yes
+```
 
 ## `lps hook rm FILENAME`
 
@@ -1084,13 +1175,16 @@ GLOBAL FLAGS
 DESCRIPTION
   Remove a hook file (action, filter, cron) from WordPress
 
+ALIASES
+  $ lps hook remove
+
 EXAMPLES
   $ lps hook rm hello
 
-  $ lps hook rm hello --yes
+  $ lps hook remove hello --yes
 ```
 
-_See code: [src/commands/hook/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/hook/rm.ts)_
+_See code: [src/commands/hook/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/hook/rm.ts)_
 
 ## `lps hook rollback [PATH]`
 
@@ -1126,7 +1220,7 @@ EXAMPLES
   $ lps hook rollback --dry-run
 ```
 
-_See code: [src/commands/hook/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/hook/rollback.ts)_
+_See code: [src/commands/hook/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/hook/rollback.ts)_
 
 ## `lps init`
 
@@ -1143,7 +1237,7 @@ EXAMPLES
   $ lps init
 ```
 
-_See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/init.ts)_
 
 ## `lps login`
 
@@ -1160,7 +1254,7 @@ EXAMPLES
   $ lps login
 ```
 
-_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/login.ts)_
 
 ## `lps logout`
 
@@ -1177,7 +1271,7 @@ EXAMPLES
   $ lps logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/logout.ts)_
 
 ## `lps menu diff [PATH]`
 
@@ -1209,7 +1303,7 @@ EXAMPLES
   $ lps menu diff --env staging --against production
 ```
 
-_See code: [src/commands/menu/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/menu/diff.ts)_
+_See code: [src/commands/menu/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/menu/diff.ts)_
 
 ## `lps menu list`
 
@@ -1232,7 +1326,7 @@ EXAMPLES
   $ lps menu list
 ```
 
-_See code: [src/commands/menu/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/menu/list.ts)_
+_See code: [src/commands/menu/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/menu/list.ts)_
 
 ## `lps menu pull [PATH]`
 
@@ -1240,7 +1334,7 @@ Pull nav menus and the active theme menu locations from WordPress
 
 ```
 USAGE
-  $ lps menu pull [PATH] [--env <value>] [-d] [-y]
+  $ lps menu pull [PATH] [--json] [--env <value>] [-d] [-y]
 
 ARGUMENTS
   [PATH]  Path to menus directory (overrides project config)
@@ -1250,6 +1344,9 @@ FLAGS
   -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 nav menus and the active theme menu locations from WordPress
 
@@ -1257,7 +1354,7 @@ EXAMPLES
   $ lps menu pull
 ```
 
-_See code: [src/commands/menu/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/menu/pull.ts)_
+_See code: [src/commands/menu/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/menu/pull.ts)_
 
 ## `lps menu push [PATH]`
 
@@ -1265,7 +1362,7 @@ Push local nav menus and the active theme menu locations to WordPress. Each menu
 
 ```
 USAGE
-  $ lps menu push [PATH] [--env <value>] [-d] [-y]
+  $ lps menu push [PATH] [--json] [--env <value>] [-d] [-y]
 
 ARGUMENTS
   [PATH]  Path to menus directory (overrides project config)
@@ -1275,6 +1372,9 @@ FLAGS
   -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 local nav menus and the active theme menu locations to WordPress. Each menu's post_type/taxonomy items are
   resolved by slug on the target environment, never by a raw id; an item whose target does not exist there fails the
@@ -1284,7 +1384,7 @@ EXAMPLES
   $ lps menu push
 ```
 
-_See code: [src/commands/menu/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/menu/push.ts)_
+_See code: [src/commands/menu/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/menu/push.ts)_
 
 ## `lps menu rollback [PATH]`
 
@@ -1320,7 +1420,7 @@ EXAMPLES
   $ lps menu rollback --dry-run
 ```
 
-_See code: [src/commands/menu/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/menu/rollback.ts)_
+_See code: [src/commands/menu/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/menu/rollback.ts)_
 
 ## `lps option add NAME`
 
@@ -1351,7 +1451,7 @@ EXAMPLES
   $ lps option add siteurl
 ```
 
-_See code: [src/commands/option/add.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/option/add.ts)_
+_See code: [src/commands/option/add.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/option/add.ts)_
 
 ## `lps option diff [PATH]`
 
@@ -1383,7 +1483,7 @@ EXAMPLES
   $ lps option diff --env staging --against production
 ```
 
-_See code: [src/commands/option/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/option/diff.ts)_
+_See code: [src/commands/option/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/option/diff.ts)_
 
 ## `lps option list`
 
@@ -1413,7 +1513,7 @@ EXAMPLES
   $ lps option list --no-core
 ```
 
-_See code: [src/commands/option/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/option/list.ts)_
+_See code: [src/commands/option/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/option/list.ts)_
 
 ## `lps option pull [PATH]`
 
@@ -1442,7 +1542,7 @@ EXAMPLES
   $ lps option pull
 ```
 
-_See code: [src/commands/option/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/option/pull.ts)_
+_See code: [src/commands/option/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/option/pull.ts)_
 
 ## `lps option push [PATH]`
 
@@ -1471,7 +1571,7 @@ EXAMPLES
   $ lps option push
 ```
 
-_See code: [src/commands/option/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/option/push.ts)_
+_See code: [src/commands/option/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/option/push.ts)_
 
 ## `lps option remove NAME`
 
@@ -1504,7 +1604,7 @@ EXAMPLES
   $ lps option remove wpseo_titles --local-only
 ```
 
-_See code: [src/commands/option/remove.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/option/remove.ts)_
+_See code: [src/commands/option/remove.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/option/remove.ts)_
 
 ## `lps option rollback [PATH]`
 
@@ -1540,7 +1640,7 @@ EXAMPLES
   $ lps option rollback --dry-run
 ```
 
-_See code: [src/commands/option/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/option/rollback.ts)_
+_See code: [src/commands/option/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/option/rollback.ts)_
 
 ## `lps page diff [PATH]`
 
@@ -1571,7 +1671,7 @@ EXAMPLES
   $ lps page diff --env staging --against production
 ```
 
-_See code: [src/commands/page/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/page/diff.ts)_
+_See code: [src/commands/page/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/page/diff.ts)_
 
 ## `lps page list`
 
@@ -1594,7 +1694,7 @@ EXAMPLES
   $ lps page list
 ```
 
-_See code: [src/commands/page/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/page/list.ts)_
+_See code: [src/commands/page/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/page/list.ts)_
 
 ## `lps page push [SLUG]`
 
@@ -1627,7 +1727,7 @@ EXAMPLES
   $ lps page push --dry-run
 ```
 
-_See code: [src/commands/page/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/page/push.ts)_
+_See code: [src/commands/page/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/page/push.ts)_
 
 ## `lps plugin add SLUG`
 
@@ -1659,7 +1759,7 @@ EXAMPLES
   $ lps plugin add contact-form-7 --dry-run
 ```
 
-_See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/plugin/add.ts)_
+_See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/plugin/add.ts)_
 
 ## `lps plugin audit`
 
@@ -1682,54 +1782,60 @@ EXAMPLES
   $ lps plugin audit
 ```
 
-_See code: [src/commands/plugin/audit.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/plugin/audit.ts)_
+_See code: [src/commands/plugin/audit.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/plugin/audit.ts)_
 
 ## `lps plugin pull`
 
-Pull installed plugins from WordPress into loopress.json, pinned to their live versions
+Pull installed plugins from WordPress into loopress.json (or composer.json), pinned to their live versions. Plugins already tracked are refreshed; new ones are offered as a list to tick, so plugins that only belong on this environment (cache, security, backups) stay out of the project.
 
 ```
 USAGE
-  $ lps plugin pull [--json] [--env <value>] [-d]
+  $ lps plugin pull [--json] [--env <value>] [-d] [-y] [--plugin <value>...]
 
 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
+  -y, --yes                Answer yes to confirmation prompts
+      --env=<value>        Target environment by name, overriding the globally active one (lps project switch)
+      --plugin=<value>...  Start tracking this installed plugin too, without asking (repeatable)
 
 GLOBAL FLAGS
   --json  Format output as json.
 
 DESCRIPTION
-  Pull installed plugins from WordPress into loopress.json, pinned to their live versions
+  Pull installed plugins from WordPress into loopress.json (or composer.json), pinned to their live versions. Plugins
+  already tracked are refreshed; new ones are offered as a list to tick, so plugins that only belong on this environment
+  (cache, security, backups) stay out of the project.
 
 EXAMPLES
   $ lps plugin pull
 
-  $ lps plugin pull --dry-run
+  $ lps plugin pull --env production --plugin query-monitor
 ```
 
-_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/plugin/pull.ts)_
+_See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/plugin/pull.ts)_
 
 ## `lps plugin push`
 
-Install plugins on WordPress to match loopress.json, pinned via Composer + WPackagist
+Install plugins on WordPress to match loopress.json (or composer.json), via Composer + WPackagist
 
 ```
 USAGE
-  $ lps plugin push [--json] [--env <value>] [-d] [-y] [--force] [--prune]
+  $ lps plugin push [--json] [--env <value>] [-d] [-y] [--activate] [--force] [--prune]
 
 FLAGS
   -d, --dry-run      Show what would change without making changes
   -y, --yes          Answer yes to confirmation prompts
+      --activate     composer.json projects only: activate every plugin it declares. Without it, plugins keep their
+                     current state and new ones stay inactive
       --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
+      --prune        Deactivate plugins that are active on the site but absent from loopress.json (or composer.json)
 
 GLOBAL FLAGS
   --json  Format output as json.
 
 DESCRIPTION
-  Install plugins on WordPress to match loopress.json, pinned via Composer + WPackagist
+  Install plugins on WordPress to match loopress.json (or composer.json), via Composer + WPackagist
 
 EXAMPLES
   $ lps plugin push
@@ -1739,7 +1845,7 @@ EXAMPLES
   $ lps plugin push --force --prune
 ```
 
-_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/plugin/push.ts)_
+_See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/plugin/push.ts)_
 
 ## `lps plugin status`
 
@@ -1762,7 +1868,7 @@ EXAMPLES
   $ lps plugin status
 ```
 
-_See code: [src/commands/plugin/status.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/plugin/status.ts)_
+_See code: [src/commands/plugin/status.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/plugin/status.ts)_
 
 ## `lps project config`
 
@@ -1780,7 +1886,7 @@ EXAMPLES
   $ lps project config
 ```
 
-_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/project/config.ts)_
+_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/project/config.ts)_
 
 ## `lps project list`
 
@@ -1800,7 +1906,7 @@ EXAMPLES
   $ lps project list
 ```
 
-_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/project/list.ts)_
+_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/project/list.ts)_
 
 ## `lps project pull`
 
@@ -1817,7 +1923,7 @@ EXAMPLES
   $ lps project pull
 ```
 
-_See code: [src/commands/project/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/project/pull.ts)_
+_See code: [src/commands/project/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/project/pull.ts)_
 
 ## `lps project push`
 
@@ -1837,7 +1943,7 @@ EXAMPLES
   $ lps project push
 ```
 
-_See code: [src/commands/project/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/project/push.ts)_
+_See code: [src/commands/project/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/project/push.ts)_
 
 ## `lps project remove`
 
@@ -1854,7 +1960,7 @@ EXAMPLES
   $ lps project remove
 ```
 
-_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/project/remove.ts)_
+_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/project/remove.ts)_
 
 ## `lps project rotate`
 
@@ -1876,7 +1982,7 @@ EXAMPLES
   $ lps project rotate --env staging
 ```
 
-_See code: [src/commands/project/rotate.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/project/rotate.ts)_
+_See code: [src/commands/project/rotate.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/project/rotate.ts)_
 
 ## `lps project switch`
 
@@ -1893,11 +1999,11 @@ EXAMPLES
   $ lps project switch
 ```
 
-_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/project/switch.ts)_
+_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/project/switch.ts)_
 
 ## `lps promote FROM TO`
 
-Copy every tracked resource from one environment to another by pulling from <from> then pushing to <to>. Local tracked files are overwritten with <from> in the process.
+Copy every tracked resource from one environment to another by pulling from <from> then pushing to <to>. Local tracked files are overwritten with <from> in the process. With --dry-run, <from> is pulled into a throwaway copy of the project instead, and the push is only previewed.
 
 ```
 USAGE
@@ -1916,7 +2022,8 @@ GLOBAL FLAGS
 
 DESCRIPTION
   Copy every tracked resource from one environment to another by pulling from <from> then pushing to <to>. Local tracked
-  files are overwritten with <from> in the process.
+  files are overwritten with <from> in the process. With --dry-run, <from> is pulled into a throwaway copy of the
+  project instead, and the push is only previewed.
 
 EXAMPLES
   $ lps promote staging production
@@ -1924,7 +2031,7 @@ EXAMPLES
   $ lps promote production staging --dry-run
 ```
 
-_See code: [src/commands/promote.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/promote.ts)_
+_See code: [src/commands/promote.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/promote.ts)_
 
 ## `lps pull`
 
@@ -1954,11 +2061,11 @@ EXAMPLES
   $ lps pull --dry-run
 ```
 
-_See code: [src/commands/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/pull.ts)_
+_See code: [src/commands/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/pull.ts)_
 
 ## `lps push`
 
-Push all local content, plugins, composer dependencies, ACF, API routes, hooks, forms, pages, SEO, menus, options, and snippets, to WordPress
+Push all local content, plugins, composer dependencies, ACF, API routes, hooks, forms, templates, pages, SEO, menus, options, and snippets, to WordPress
 
 ```
 USAGE
@@ -1973,8 +2080,8 @@ GLOBAL FLAGS
   --json  Format output as json.
 
 DESCRIPTION
-  Push all local content, plugins, composer dependencies, ACF, API routes, hooks, forms, pages, SEO, menus, options, and
-  snippets, to WordPress
+  Push all local content, plugins, composer dependencies, ACF, API routes, hooks, forms, templates, pages, SEO, menus,
+  options, and snippets, to WordPress
 
 EXAMPLES
   $ lps push
@@ -1984,7 +2091,7 @@ EXAMPLES
   $ lps push --dry-run
 ```
 
-_See code: [src/commands/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/push.ts)_
+_See code: [src/commands/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/push.ts)_
 
 ## `lps seo diff [PATH]`
 
@@ -2016,7 +2123,7 @@ EXAMPLES
   $ lps seo diff --env staging --against production
 ```
 
-_See code: [src/commands/seo/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/seo/diff.ts)_
+_See code: [src/commands/seo/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/seo/diff.ts)_
 
 ## `lps seo list`
 
@@ -2042,7 +2149,7 @@ EXAMPLES
   $ lps seo list --post-type post
 ```
 
-_See code: [src/commands/seo/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/seo/list.ts)_
+_See code: [src/commands/seo/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/seo/list.ts)_
 
 ## `lps seo pull [PATH]`
 
@@ -2050,7 +2157,7 @@ Pull SEO settings, post meta, and (if supported) redirects from WordPress
 
 ```
 USAGE
-  $ lps seo pull [PATH] [--env <value>] [-d] [-y] [--post-type <value>...]
+  $ lps seo pull [PATH] [--json] [--env <value>] [-d] [-y] [--post-type <value>...]
 
 ARGUMENTS
   [PATH]  Path to SEO directory (overrides project config)
@@ -2061,6 +2168,9 @@ FLAGS
       --env=<value>           Target environment by name, overriding the globally active one (lps project switch)
       --post-type=<value>...  Limit post meta to specific post types
 
+GLOBAL FLAGS
+  --json  Format output as json.
+
 DESCRIPTION
   Pull SEO settings, post meta, and (if supported) redirects from WordPress
 
@@ -2070,7 +2180,7 @@ EXAMPLES
   $ lps seo pull --post-type post --post-type page
 ```
 
-_See code: [src/commands/seo/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/seo/pull.ts)_
+_See code: [src/commands/seo/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/seo/pull.ts)_
 
 ## `lps seo push [PATH]`
 
@@ -2078,7 +2188,7 @@ Push SEO settings, post meta, and redirects to WordPress. Local redirect files c
 
 ```
 USAGE
-  $ lps seo push [PATH] [--env <value>] [-d] [-y] [--allow-external-redirects]
+  $ lps seo push [PATH] [--json] [--env <value>] [-d] [-y] [--allow-external-redirects]
 
 ARGUMENTS
   [PATH]  Path to SEO directory (overrides project config)
@@ -2090,6 +2200,9 @@ FLAGS
                                   rejects an off-site `urlTo` so a stray push can't 301 traffic away.
       --env=<value>               Target environment by name, overriding the globally active one (lps project switch)
 
+GLOBAL FLAGS
+  --json  Format output as json.
+
 DESCRIPTION
   Push SEO settings, post meta, and redirects to WordPress. Local redirect files created remotely are renamed on disk to
   the `<id>-<slug>` convention. Fails clearly per file if the active SEO plugin does not support redirects.
@@ -2100,7 +2213,7 @@ EXAMPLES
   $ lps seo push --allow-external-redirects
 ```
 
-_See code: [src/commands/seo/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/seo/push.ts)_
+_See code: [src/commands/seo/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/seo/push.ts)_
 
 ## `lps seo rollback [PATH]`
 
@@ -2136,7 +2249,7 @@ EXAMPLES
   $ lps seo rollback --dry-run
 ```
 
-_See code: [src/commands/seo/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/seo/rollback.ts)_
+_See code: [src/commands/seo/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/seo/rollback.ts)_
 
 ## `lps snippet diff [PATH]`
 
@@ -2167,7 +2280,7 @@ EXAMPLES
   $ lps snippet diff --env staging --against production
 ```
 
-_See code: [src/commands/snippet/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/snippet/diff.ts)_
+_See code: [src/commands/snippet/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/snippet/diff.ts)_
 
 ## `lps snippet list`
 
@@ -2190,7 +2303,7 @@ EXAMPLES
   $ lps snippet list
 ```
 
-_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/snippet/list.ts)_
+_See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/snippet/list.ts)_
 
 ## `lps snippet publish [PATH]`
 
@@ -2210,10 +2323,10 @@ DESCRIPTION
 EXAMPLES
   $ lps snippet publish
 
-  $ lps snippet publish --path ./snippets
+  $ lps snippet publish ./snippets
 ```
 
-_See code: [src/commands/snippet/publish.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/snippet/publish.ts)_
+_See code: [src/commands/snippet/publish.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/snippet/publish.ts)_
 
 ## `lps snippet pull [PATH]`
 
@@ -2240,10 +2353,10 @@ DESCRIPTION
 EXAMPLES
   $ lps snippet pull
 
-  $ lps snippet pull --path ./snippets
+  $ lps snippet pull ./snippets
 ```
 
-_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/snippet/pull.ts)_
+_See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/snippet/pull.ts)_
 
 ## `lps snippet push [PATH]`
 
@@ -2271,10 +2384,10 @@ DESCRIPTION
 EXAMPLES
   $ lps snippet push
 
-  $ lps snippet push --path ./snippets
+  $ lps snippet push ./snippets
 ```
 
-_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/snippet/push.ts)_
+_See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/snippet/push.ts)_
 
 ## `lps snippet rollback [PATH]`
 
@@ -2310,7 +2423,7 @@ EXAMPLES
   $ lps snippet rollback --dry-run
 ```
 
-_See code: [src/commands/snippet/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/snippet/rollback.ts)_
+_See code: [src/commands/snippet/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/snippet/rollback.ts)_
 
 ## `lps status`
 
@@ -2335,7 +2448,7 @@ EXAMPLES
   $ lps status --env staging
 ```
 
-_See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/status.ts)_
+_See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/status.ts)_
 
 ## `lps telemetry disable`
 
@@ -2352,7 +2465,7 @@ EXAMPLES
   $ lps telemetry disable
 ```
 
-_See code: [src/commands/telemetry/disable.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/telemetry/disable.ts)_
+_See code: [src/commands/telemetry/disable.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/telemetry/disable.ts)_
 
 ## `lps telemetry enable`
 
@@ -2369,15 +2482,126 @@ EXAMPLES
   $ lps telemetry enable
 ```
 
-_See code: [src/commands/telemetry/enable.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/telemetry/enable.ts)_
+_See code: [src/commands/telemetry/enable.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/telemetry/enable.ts)_
+
+## `lps theme add SLUG`
+
+Add a WordPress.org theme to loopress.json
+
+```
+USAGE
+  $ lps theme add SLUG [--json] [--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")
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+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/%40loopress%2Fcli%400.29.0/cli/src/commands/theme/add.ts)_
+
+## `lps theme pull`
+
+Pull everything theme related from WordPress: theme versions and Global Styles
+
+```
+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 everything theme related from WordPress: theme versions and Global Styles
+
+EXAMPLES
+  $ lps theme pull
+
+  $ lps theme pull --env staging
+
+  $ lps theme pull --dry-run
+```
+
+_See code: [src/commands/theme/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/theme/pull.ts)_
+
+## `lps theme push`
+
+Push everything theme related to WordPress: theme versions, templates and parts, then Global Styles
+
+```
+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        Passed to `lps theme version push`
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Push everything theme related to WordPress: theme versions, templates and parts, then Global Styles
+
+EXAMPLES
+  $ lps theme push
+
+  $ lps theme push --env staging
+
+  $ lps theme push --dry-run
+```
+
+_See code: [src/commands/theme/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/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)
 
-## `lps theme-styles diff [PATH]`
+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/%40loopress%2Fcli%400.29.0/cli/src/commands/theme/status.ts)_
+
+## `lps theme style diff [PATH]`
 
 Show what differs in the active block theme's Global Styles (Site Editor > Styles) between your local file and a WordPress environment, or between two environments
 
 ```
 USAGE
-  $ lps theme-styles diff [PATH] [--json] [--env <value>] [--against <value>]
+  $ lps theme style diff [PATH] [--json] [--env <value>] [--against <value>]
 
 ARGUMENTS
   [PATH]  Path to theme styles directory (overrides project config)
@@ -2394,22 +2618,22 @@ DESCRIPTION
   WordPress environment, or between two environments
 
 EXAMPLES
-  $ lps theme-styles diff
+  $ lps theme style diff
 
-  $ lps theme-styles diff --env staging
+  $ lps theme style diff --env staging
 
-  $ lps theme-styles diff --env staging --against production
+  $ lps theme style diff --env staging --against production
 ```
 
-_See code: [src/commands/theme-styles/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/theme-styles/diff.ts)_
+_See code: [src/commands/theme/style/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/theme/style/diff.ts)_
 
-## `lps theme-styles pull [PATH]`
+## `lps theme style pull [PATH]`
 
 Pull the active block theme's Global Styles customizations (Site Editor > Styles) from WordPress into a local file
 
 ```
 USAGE
-  $ lps theme-styles pull [PATH] [--env <value>] [-d]
+  $ lps theme style pull [PATH] [--json] [--env <value>] [-d]
 
 ARGUMENTS
   [PATH]  Path to theme styles directory (overrides project config)
@@ -2418,46 +2642,53 @@ 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 the active block theme's Global Styles customizations (Site Editor > Styles) from WordPress into a local file
 
 EXAMPLES
-  $ lps theme-styles pull
+  $ lps theme style pull
 ```
 
-_See code: [src/commands/theme-styles/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/theme-styles/pull.ts)_
+_See code: [src/commands/theme/style/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/theme/style/pull.ts)_
 
-## `lps theme-styles push [PATH]`
+## `lps theme style push [PATH]`
 
 Push the local Global Styles file to the active block theme's Site Editor > Styles on WordPress
 
 ```
 USAGE
-  $ lps theme-styles push [PATH] [--env <value>] [-d]
+  $ lps theme style push [PATH] [--json] [--env <value>] [-d] [-y]
 
 ARGUMENTS
   [PATH]  Path to theme styles 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 the local Global Styles file to the active block theme's Site Editor > Styles on WordPress
 
 EXAMPLES
-  $ lps theme-styles push
+  $ lps theme style push
 ```
 
-_See code: [src/commands/theme-styles/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/theme-styles/push.ts)_
+_See code: [src/commands/theme/style/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/theme/style/push.ts)_
 
-## `lps theme-styles rollback [PATH]`
+## `lps theme style rollback [PATH]`
 
-Restore the active theme’s Global Styles to a snapshot taken automatically before an earlier `lps theme-styles push`
+Restore the active theme's Global Styles to a snapshot taken automatically before an earlier `lps theme style push`
 
 ```
 USAGE
-  $ lps theme-styles rollback [PATH] [--json] [--env <value>] [-d] [-y] [--list] [--to <value>]
+  $ lps theme style rollback [PATH] [--json] [--env <value>] [-d] [-y] [--list] [--to <value>]
 
 ARGUMENTS
   [PATH]  Path to theme styles directory (overrides project config)
@@ -2473,124 +2704,152 @@ GLOBAL FLAGS
   --json  Format output as json.
 
 DESCRIPTION
-  Restore the active theme’s Global Styles to a snapshot taken automatically before an earlier `lps theme-styles push`
+  Restore the active theme's Global Styles to a snapshot taken automatically before an earlier `lps theme style push`
 
 EXAMPLES
-  $ lps theme-styles rollback
+  $ lps theme style rollback
 
-  $ lps theme-styles rollback --list
+  $ lps theme style rollback --list
 
-  $ lps theme-styles rollback --to 1732000000000
+  $ lps theme style rollback --to 1732000000000
 
-  $ lps theme-styles rollback --dry-run
+  $ lps theme style rollback --dry-run
 ```
 
-_See code: [src/commands/theme-styles/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/theme-styles/rollback.ts)_
+_See code: [src/commands/theme/style/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/theme/style/rollback.ts)_
 
-## `lps theme add SLUG`
+## `lps theme template diff`
 
-Add a WordPress.org theme to loopress.json
+Show what differs in block templates and parts between your local files and a WordPress environment, or between two environments. Templates and parts edited in the Site Editor show up too.
 
 ```
 USAGE
-  $ lps theme add SLUG [--json] [--env <value>] [-d] [--version <value>]
-
-ARGUMENTS
-  SLUG  Theme slug on WordPress.org
+  $ lps theme template diff [--json] [--env <value>] [--against <value>]
 
 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")
+  --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
-  Add a WordPress.org theme to loopress.json
+  Show what differs in block templates and parts between your local files and a WordPress environment, or between two
+  environments. Templates and parts edited in the Site Editor show up too.
 
 EXAMPLES
-  $ lps theme add generatepress
+  $ lps theme template diff
 
-  $ lps theme add generatepress --version 3.4.0
+  $ lps theme template diff --env staging
+
+  $ lps theme template diff --env staging --against production
 ```
 
-_See code: [src/commands/theme/add.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/theme/add.ts)_
+_See code: [src/commands/theme/template/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/theme/template/diff.ts)_
 
-## `lps theme pull`
+## `lps theme template list`
 
-Pull installed themes from WordPress into loopress.json, pinned to their live versions
+Show the Loopress child theme of the active block theme: its templates, parts, and those edited in the Site Editor
 
 ```
 USAGE
-  $ lps theme pull [--json] [--env <value>] [-d]
+  $ lps theme template list [--json] [--env <value>]
 
 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)
+  --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
+  Show the Loopress child theme of the active block theme: its templates, parts, and those edited in the Site Editor
 
 EXAMPLES
-  $ lps theme pull
+  $ lps theme template list
 ```
 
-_See code: [src/commands/theme/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/theme/pull.ts)_
+_See code: [src/commands/theme/template/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/theme/template/list.ts)_
 
-## `lps theme push`
+## `lps theme template push`
 
-Install themes on WordPress to match loopress.json (versions only, never switches the active theme)
+Push block templates (templates/<slug>.html) and template parts (parts/<slug>.html) as the files of a child theme of the active block theme, <parent>-loopress. The child mirrors the project: files removed locally are removed from it. It is never activated for you.
 
 ```
 USAGE
-  $ lps theme push [--json] [--env <value>] [-d] [-y] [--force]
+  $ lps theme template push [--json] [--env <value>] [-d] [-y]
 
 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)
+  Push block templates (templates/<slug>.html) and template parts (parts/<slug>.html) as the files of a child theme of
+  the active block theme, <parent>-loopress. The child mirrors the project: files removed locally are removed from it.
+  It is never activated for you.
 
 EXAMPLES
-  $ lps theme push
+  $ lps theme template push
 
-  $ lps theme push --force
+  $ lps theme template push --dry-run
 ```
 
-_See code: [src/commands/theme/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/theme/push.ts)_
+_See code: [src/commands/theme/template/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/theme/template/push.ts)_
 
-## `lps theme status`
+## `lps theme version pull`
 
-Compare the themes on WordPress against loopress.json and report version drift
+Pull installed themes from WordPress into loopress.json, pinned to their live versions
 
 ```
 USAGE
-  $ lps theme status [--json] [--env <value>]
+  $ lps theme version pull [--json] [--env <value>] [-d]
 
 FLAGS
-  --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)
 
 GLOBAL FLAGS
   --json  Format output as json.
 
 DESCRIPTION
-  Compare the themes on WordPress against loopress.json and report version drift
+  Pull installed themes from WordPress into loopress.json, pinned to their live versions
 
 EXAMPLES
-  $ lps theme status
+  $ lps theme version pull
+```
+
+_See code: [src/commands/theme/version/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/theme/version/pull.ts)_
+
+## `lps theme version push`
+
+Install themes on WordPress to match loopress.json (versions only, never switches the active theme)
+
+```
+USAGE
+  $ lps theme version 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 version push
+
+  $ lps theme version push --force
 ```
 
-_See code: [src/commands/theme/status.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/theme/status.ts)_
+_See code: [src/commands/theme/version/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/theme/version/push.ts)_
 
 ## `lps validate`
 
@@ -2610,5 +2869,5 @@ EXAMPLES
   $ lps validate
 ```
 
-_See code: [src/commands/validate.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/validate.ts)_
+_See code: [src/commands/validate.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/validate.ts)_
 <!-- commandsstop -->