npm - @sonisoft/now-sdk-ext-cli - Versions diffs - 5.0.1 → 5.1.0 - Mend

@sonisoft/now-sdk-ext-cli 5.0.1 → 5.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

package/LICENSE +21 -0
package/README.md +479 -196
package/dist/common/authenticated-command.d.ts +9 -0
package/dist/common/authenticated-command.d.ts.map +1 -1
package/dist/common/authenticated-command.js +50 -4
package/dist/common/authenticated-command.js.map +1 -1
package/dist/util/log-factory.d.ts +7 -1
package/dist/util/log-factory.d.ts.map +1 -1
package/dist/util/log-factory.js +8 -3
package/dist/util/log-factory.js.map +1 -1
package/oclif.manifest.json +1794 -655
package/package.json +2 -2

package/README.md CHANGED Viewed

@@ -689,7 +689,7 @@ $ npm install -g @sonisoft/now-sdk-ext-cli
 $ nex COMMAND
 running command...
 $ nex (--version)
-@sonisoft/now-sdk-ext-cli/5.0.1 linux-x64 node-v26.5.0
+@sonisoft/now-sdk-ext-cli/5.1.0 linux-x64 node-v26.5.0
 $ nex --help [COMMAND]
 USAGE
   $ nex COMMAND
@@ -789,8 +789,8 @@ Count records in a ServiceNow table.
 ```
 USAGE
-  $ nex aggregate count -t <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-q
-    <value>]
+  $ nex aggregate count -t <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [-q <value>]
 FLAGS
   -a, --auth=<value>   Auth alias to use.
@@ -801,6 +801,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -828,7 +832,7 @@ EXAMPLES
     $ nex aggregate count --table incident --query "active=true" --json --auth dev
 ```
-_See code: [src/commands/aggregate/count.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/aggregate/count.ts)_
+_See code: [src/commands/aggregate/count.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/aggregate/count.ts)_
 ## `nex aggregate group`
@@ -836,9 +840,9 @@ Run a grouped aggregate query on a ServiceNow table.
 ```
 USAGE
-  $ nex aggregate group -t <value> -g <value>... [-j] [-a <value>] [--cred-store] [--log-level
-    debug|warn|error|info|trace] [-q <value>] [-c] [--avg <value>...] [--min <value>...] [--max <value>...] [--sum
-    <value>...] [--having <value>] [-d]
+  $ nex aggregate group -t <value> -g <value>... [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
+    [--log-level debug|warn|error|info|trace] [-q <value>] [-c] [--avg <value>...] [--min <value>...] [--max <value>...]
+    [--sum <value>...] [--having <value>] [-d]
 FLAGS
   -a, --auth=<value>         Auth alias to use.
@@ -857,6 +861,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -888,7 +896,7 @@ EXAMPLES
     $ nex aggregate group --table incident --group-by priority --count --having "count>10" --auth dev
 ```
-_See code: [src/commands/aggregate/group.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/aggregate/group.ts)_
+_See code: [src/commands/aggregate/group.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/aggregate/group.ts)_
 ## `nex aggregate query`
@@ -896,8 +904,9 @@ Run aggregate statistics on a ServiceNow table.
 ```
 USAGE
-  $ nex aggregate query -t <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-q
-    <value>] [-c] [--avg <value>...] [--min <value>...] [--max <value>...] [--sum <value>...]
+  $ nex aggregate query -t <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [-q <value>] [-c] [--avg <value>...] [--min <value>...] [--max <value>...] [--sum
+    <value>...]
 FLAGS
   -a, --auth=<value>    Auth alias to use.
@@ -913,6 +922,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -942,7 +955,7 @@ EXAMPLES
     $ nex aggregate query --table incident --sum reassignment_count --json --auth dev
 ```
-_See code: [src/commands/aggregate/query.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/aggregate/query.ts)_
+_See code: [src/commands/aggregate/query.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/aggregate/query.ts)_
 ## `nex app`
@@ -950,8 +963,8 @@ Manage ServiceNow applications: uninstall applications from your instance.
 ```
 USAGE
-  $ nex app [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-u] [-i
-    <value>] [-s <value>]
+  $ nex app [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [-u] [-i <value>] [-s <value>]
 FLAGS
   -a, --auth=<value>           Auth alias to use.
@@ -963,6 +976,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -997,7 +1014,7 @@ EXAMPLES
     $ nex app -u -i a1b2c3d4e5f6 -s x_my_custom_app -a dev-instance
 ```
-_See code: [src/commands/app/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/app/index.ts)_
+_See code: [src/commands/app/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/app/index.ts)_
 ## `nex app install`
@@ -1005,8 +1022,8 @@ Install or upgrade multiple ServiceNow applications from a batch definition file
 ```
 USAGE
-  $ nex app install [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-b] [-d
-    <value>]
+  $ nex app install [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [-b] [-d <value>]
 FLAGS
   -a, --auth=<value>            Auth alias to use.
@@ -1017,6 +1034,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -1057,7 +1078,7 @@ EXAMPLES
     $ nex app install -b -d ./apps.json -a dev-instance --log-level debug
 ```
-_See code: [src/commands/app/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/app/install.ts)_
+_See code: [src/commands/app/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/app/install.ts)_
 ## `nex app repo-install`
@@ -1065,8 +1086,8 @@ Install an application from your ServiceNow company repository.
 ```
 USAGE
-  $ nex app repo-install -s <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
-    [-w] [--poll-interval <value>] [-t <value>] [-v <value>]
+  $ nex app repo-install -s <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [-w] [--poll-interval <value>] [-t <value>] [-v <value>]
 FLAGS
   -a, --auth=<value>           Auth alias to use.
@@ -1080,6 +1101,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -1133,7 +1158,7 @@ EXAMPLES
     $ nex app repo-install -s x_my_app -a dev-instance --log-level debug
 ```
-_See code: [src/commands/app/repo-install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/app/repo-install.ts)_
+_See code: [src/commands/app/repo-install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/app/repo-install.ts)_
 ## `nex app repo-list`
@@ -1141,7 +1166,8 @@ List applications available in your ServiceNow company repository.
 ```
 USAGE
-  $ nex app repo-list [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-n] [-i]
+  $ nex app repo-list [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [-n] [-i]
 FLAGS
   -a, --auth=<value>  Auth alias to use.
@@ -1152,6 +1178,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -1199,7 +1229,7 @@ EXAMPLES
     $ nex app repo-list -a dev-instance
 ```
-_See code: [src/commands/app/repo-list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/app/repo-list.ts)_
+_See code: [src/commands/app/repo-list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/app/repo-list.ts)_
 ## `nex app uninstall`
@@ -1207,8 +1237,8 @@ Uninstall a ServiceNow application from your instance.
 ```
 USAGE
-  $ nex app uninstall -i <value> -s <value> [--json] [-a <value>] [--cred-store] [--log-level
-    debug|warn|error|info|trace]
+  $ nex app uninstall -i <value> -s <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
+    [--log-level debug|warn|error|info|trace]
 FLAGS
   -a, --auth=<value>           Auth alias to use.
@@ -1219,6 +1249,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -1253,7 +1287,7 @@ EXAMPLES
     $ nex app uninstall -i a1b2c3d4e5f6 -s x_my_custom_app -a dev-instance
 ```
-_See code: [src/commands/app/uninstall.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/app/uninstall.ts)_
+_See code: [src/commands/app/uninstall.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/app/uninstall.ts)_
 ## `nex atf`
@@ -1261,9 +1295,9 @@ Execute ATF (Automated Test Framework) tests or test suites on a ServiceNow inst
 ```
 USAGE
-  $ nex atf [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-t <value> | -s
-    <value> | -n <value>] [-w] [-p <value>] [-b <value>] [--browser-version <value>] [--os-name <value>] [--os-version
-    <value>] [--performance] [--cloud]
+  $ nex atf [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [-t <value> | -s <value> | -n <value>] [-w] [-p <value>] [-b <value>]
+    [--browser-version <value>] [--os-name <value>] [--os-version <value>] [--performance] [--cloud]
 FLAGS
   -a, --auth=<value>             Auth alias to use.
@@ -1283,6 +1317,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -1327,7 +1365,7 @@ EXAMPLES
     $ nex atf --suite-id e077e00b83103210621e78c6feaad383 --poll-interval 10000 --auth dev-instance
 ```
-_See code: [src/commands/atf/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/atf/index.ts)_
+_See code: [src/commands/atf/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/atf/index.ts)_
 ## `nex attachment get`
@@ -1335,7 +1373,8 @@ Get metadata for a specific attachment.
 ```
 USAGE
-  $ nex attachment get -s <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
+  $ nex attachment get -s <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace]
 FLAGS
   -a, --auth=<value>    Auth alias to use.
@@ -1345,6 +1384,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -1361,7 +1404,7 @@ EXAMPLES
     $ nex attachment get -s att123 --json --auth dev
 ```
-_See code: [src/commands/attachment/get.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/attachment/get.ts)_
+_See code: [src/commands/attachment/get.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/attachment/get.ts)_
 ## `nex attachment list`
@@ -1369,8 +1412,8 @@ List attachments on a ServiceNow record.
 ```
 USAGE
-  $ nex attachment list -r <value> -t <value> [--json] [-a <value>] [--cred-store] [--log-level
-    debug|warn|error|info|trace] [--limit <value>]
+  $ nex attachment list -r <value> -t <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
+    [--log-level debug|warn|error|info|trace] [--limit <value>]
 FLAGS
   -a, --auth=<value>       Auth alias to use.
@@ -1382,6 +1425,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -1398,7 +1445,7 @@ EXAMPLES
     $ nex attachment list -t incident -r abc123 --limit 50 --json --auth dev
 ```
-_See code: [src/commands/attachment/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/attachment/list.ts)_
+_See code: [src/commands/attachment/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/attachment/list.ts)_
 ## `nex attachment upload`
@@ -1406,8 +1453,8 @@ Upload a file as an attachment to a ServiceNow record.
 ```
 USAGE
-  $ nex attachment upload -f <value> -r <value> -t <value> [--json] [-a <value>] [--cred-store] [--log-level
-    debug|warn|error|info|trace] [--content-type <value>]
+  $ nex attachment upload -f <value> -r <value> -t <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>]
+    [--log-file] [--log-level debug|warn|error|info|trace] [--content-type <value>]
 FLAGS
   -a, --auth=<value>          Auth alias to use.
@@ -1420,6 +1467,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -1436,7 +1487,7 @@ EXAMPLES
     $ nex attachment upload -t incident -r abc123 -f ./data.csv --content-type text/csv --auth dev
 ```
-_See code: [src/commands/attachment/upload.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/attachment/upload.ts)_
+_See code: [src/commands/attachment/upload.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/attachment/upload.ts)_
 ## `nex auth delete [ALIAS]`
@@ -1471,7 +1522,7 @@ EXAMPLES
     $ nex auth delete --all
 ```
-_See code: [src/commands/auth/delete.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/auth/delete.ts)_
+_See code: [src/commands/auth/delete.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/auth/delete.ts)_
 ## `nex auth doctor`
@@ -1499,7 +1550,7 @@ EXAMPLES
     $ nex auth doctor --json
 ```
-_See code: [src/commands/auth/doctor.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/auth/doctor.ts)_
+_See code: [src/commands/auth/doctor.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/auth/doctor.ts)_
 ## `nex auth list`
@@ -1532,7 +1583,7 @@ EXAMPLES
     $ nex auth list --json
 ```
-_See code: [src/commands/auth/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/auth/list.ts)_
+_See code: [src/commands/auth/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/auth/list.ts)_
 ## `nex auth use ALIAS`
@@ -1560,7 +1611,7 @@ EXAMPLES
     $ nex auth use dev206299
 ```
-_See code: [src/commands/auth/use.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/auth/use.ts)_
+_See code: [src/commands/auth/use.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/auth/use.ts)_
 ## `nex autocomplete [SHELL]`
@@ -1599,8 +1650,8 @@ Batch create records on a ServiceNow instance from a JSON file.
 ```
 USAGE
-  $ nex batch create -f <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
-    [--transaction]
+  $ nex batch create -f <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [--transaction]
 FLAGS
   -a, --auth=<value>  Auth alias to use.
@@ -1611,6 +1662,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -1627,7 +1682,7 @@ EXAMPLES
     $ nex batch create --file ./records.json --no-transaction --auth dev
 ```
-_See code: [src/commands/batch/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/batch/create.ts)_
+_See code: [src/commands/batch/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/batch/create.ts)_
 ## `nex batch update`
@@ -1635,8 +1690,8 @@ Batch update records on a ServiceNow instance from a JSON file.
 ```
 USAGE
-  $ nex batch update -f <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
-    [--stop-on-error]
+  $ nex batch update -f <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [--stop-on-error]
 FLAGS
   -a, --auth=<value>   Auth alias to use.
@@ -1647,6 +1702,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -1663,7 +1722,7 @@ EXAMPLES
     $ nex batch update --file ./updates.json --stop-on-error --auth dev
 ```
-_See code: [src/commands/batch/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/batch/update.ts)_
+_See code: [src/commands/batch/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/batch/update.ts)_
 ## `nex bulk delete`
@@ -1671,8 +1730,8 @@ Bulk delete records matching an encoded query.
 ```
 USAGE
-  $ nex bulk delete -t <value> -q <value> [-j] [-a <value>] [--cred-store] [--log-level
-    debug|warn|error|info|trace] [--confirm] [-l <value>]
+  $ nex bulk delete -t <value> -q <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
+    [--log-level debug|warn|error|info|trace] [--confirm] [-l <value>]
 FLAGS
   -a, --auth=<value>   Auth alias to use.
@@ -1685,6 +1744,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -1719,7 +1782,7 @@ EXAMPLES
     $ nex bulk delete --table u_staging --query "processed=true" --confirm --json --auth dev
 ```
-_See code: [src/commands/bulk/delete.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/bulk/delete.ts)_
+_See code: [src/commands/bulk/delete.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/bulk/delete.ts)_
 ## `nex bulk update`
@@ -1727,8 +1790,8 @@ Bulk update records matching an encoded query.
 ```
 USAGE
-  $ nex bulk update -t <value> -q <value> -d <value> [-j] [-a <value>] [--cred-store] [--log-level
-    debug|warn|error|info|trace] [--confirm] [-l <value>]
+  $ nex bulk update -t <value> -q <value> -d <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>]
+    [--log-file] [--log-level debug|warn|error|info|trace] [--confirm] [-l <value>]
 FLAGS
   -a, --auth=<value>   Auth alias to use.
@@ -1742,6 +1805,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -1779,7 +1846,7 @@ EXAMPLES
     $ nex bulk update --table incident --query "active=true" --data '{"state":"6"}' --confirm --json --auth dev
 ```
-_See code: [src/commands/bulk/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/bulk/update.ts)_
+_See code: [src/commands/bulk/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/bulk/update.ts)_
 ## `nex exec SCOPE [FILE]`
@@ -1787,8 +1854,8 @@ Execute JavaScript on a ServiceNow instance remotely using Scripts - Background.
 ```
 USAGE
-  $ nex exec SCOPE [FILE] [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
-    [-p <value>]
+  $ nex exec SCOPE [FILE] [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
+    [--log-level debug|warn|error|info|trace] [-p <value>]
 ARGUMENTS
   SCOPE   Scope to execute script in. Use "global" for global scope.
@@ -1802,6 +1869,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -1901,7 +1972,7 @@ EXAMPLES
     $ nex exec global ./script.js --auth dev-instance --params '{"token":"abc123","env":"dev"}'
 ```
-_See code: [src/commands/exec/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/exec/index.ts)_
+_See code: [src/commands/exec/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/exec/index.ts)_
 ## `nex flow action`
@@ -1909,8 +1980,8 @@ Execute a Flow Designer action by scoped name.
 ```
 USAGE
-  $ nex flow action -n <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-i
-    <value>] [-m foreground|background] [--scope <value>] [--quick]
+  $ nex flow action -n <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [-i <value>] [-m foreground|background] [--scope <value>] [--quick]
 FLAGS
   -a, --auth=<value>    Auth alias to use.
@@ -1925,6 +1996,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -1946,7 +2021,7 @@ EXAMPLES
       '{"table":"incident","values":{"short_description":"Test"}}' --auth dev
 ```
-_See code: [src/commands/flow/action.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/flow/action.ts)_
+_See code: [src/commands/flow/action.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/flow/action.ts)_
 ## `nex flow cancel`
@@ -1954,8 +2029,8 @@ Cancel a running or paused flow execution.
 ```
 USAGE
-  $ nex flow cancel -c <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-r
-    <value>] [--scope <value>]
+  $ nex flow cancel -c <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [-r <value>] [--scope <value>]
 FLAGS
   -a, --auth=<value>        Auth alias to use.
@@ -1967,6 +2042,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -1985,7 +2064,7 @@ EXAMPLES
     $ nex flow cancel --context-id abc123def456 --reason "No longer needed" --auth dev
 ```
-_See code: [src/commands/flow/cancel.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/flow/cancel.ts)_
+_See code: [src/commands/flow/cancel.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/flow/cancel.ts)_
 ## `nex flow copy`
@@ -1993,8 +2072,8 @@ Copy an existing flow into a target scoped application.
 ```
 USAGE
-  $ nex flow copy -s <value> -n <value> -t <value> [-j] [-a <value>] [--cred-store] [--log-level
-    debug|warn|error|info|trace]
+  $ nex flow copy -s <value> -n <value> -t <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>]
+    [--log-file] [--log-level debug|warn|error|info|trace]
 FLAGS
   -a, --auth=<value>            Auth alias to use.
@@ -2007,6 +2086,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -2042,7 +2125,7 @@ EXAMPLES
       dev
 ```
-_See code: [src/commands/flow/copy.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/flow/copy.ts)_
+_See code: [src/commands/flow/copy.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/flow/copy.ts)_
 ## `nex flow details`
@@ -2050,8 +2133,8 @@ Get rich execution details for a flow context.
 ```
 USAGE
-  $ nex flow details -c <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
-    [--scope <value>] [-d]
+  $ nex flow details -c <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [--scope <value>] [-d]
 FLAGS
   -a, --auth=<value>        Auth alias to use.
@@ -2063,6 +2146,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -2095,7 +2182,7 @@ EXAMPLES
     $ nex flow details -c d4e5f6789012345678abcdef01234567 --json --auth dev
 ```
-_See code: [src/commands/flow/details.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/flow/details.ts)_
+_See code: [src/commands/flow/details.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/flow/details.ts)_
 ## `nex flow error`
@@ -2103,8 +2190,8 @@ Retrieve error details from a failed flow execution.
 ```
 USAGE
-  $ nex flow error -c <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
-    [--scope <value>]
+  $ nex flow error -c <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [--scope <value>]
 FLAGS
   -a, --auth=<value>        Auth alias to use.
@@ -2115,6 +2202,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -2129,7 +2220,7 @@ EXAMPLES
     $ nex flow error --context-id abc123def456 --auth dev
 ```
-_See code: [src/commands/flow/error.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/flow/error.ts)_
+_See code: [src/commands/flow/error.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/flow/error.ts)_
 ## `nex flow logs`
@@ -2137,8 +2228,8 @@ Retrieve flow execution log entries for a given context.
 ```
 USAGE
-  $ nex flow logs -c <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-l
-    <value>] [-o asc|desc]
+  $ nex flow logs -c <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [-l <value>] [-o asc|desc]
 FLAGS
   -a, --auth=<value>        Auth alias to use.
@@ -2151,6 +2242,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -2179,7 +2274,7 @@ EXAMPLES
     $ nex flow logs -c d4e5f6789012345678abcdef01234567 --json --auth dev
 ```
-_See code: [src/commands/flow/logs.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/flow/logs.ts)_
+_See code: [src/commands/flow/logs.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/flow/logs.ts)_
 ## `nex flow message`
@@ -2187,8 +2282,8 @@ Send a message to a paused flow execution.
 ```
 USAGE
-  $ nex flow message -c <value> -m <value> [-j] [-a <value>] [--cred-store] [--log-level
-    debug|warn|error|info|trace] [-p <value>] [--scope <value>]
+  $ nex flow message -c <value> -m <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
+    [--log-level debug|warn|error|info|trace] [-p <value>] [--scope <value>]
 FLAGS
   -a, --auth=<value>        Auth alias to use.
@@ -2201,6 +2296,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -2220,7 +2319,7 @@ EXAMPLES
     $ nex flow message --context-id abc123def456 --message "data_ready" --payload '{"status":"ok"}' --auth dev
 ```
-_See code: [src/commands/flow/message.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/flow/message.ts)_
+_See code: [src/commands/flow/message.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/flow/message.ts)_
 ## `nex flow outputs`
@@ -2228,8 +2327,8 @@ Retrieve outputs from a completed flow execution.
 ```
 USAGE
-  $ nex flow outputs -c <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
-    [--scope <value>]
+  $ nex flow outputs -c <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [--scope <value>]
 FLAGS
   -a, --auth=<value>        Auth alias to use.
@@ -2240,6 +2339,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -2258,7 +2361,7 @@ EXAMPLES
     $ nex flow outputs --context-id abc123def456 --json --auth dev
 ```
-_See code: [src/commands/flow/outputs.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/flow/outputs.ts)_
+_See code: [src/commands/flow/outputs.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/flow/outputs.ts)_
 ## `nex flow run`
@@ -2266,8 +2369,8 @@ Execute a published Flow Designer flow by scoped name.
 ```
 USAGE
-  $ nex flow run -n <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-i
-    <value>] [-m foreground|background] [--scope <value>] [--quick]
+  $ nex flow run -n <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [-i <value>] [-m foreground|background] [--scope <value>] [--quick]
 FLAGS
   -a, --auth=<value>    Auth alias to use.
@@ -2282,6 +2385,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -2315,7 +2422,7 @@ EXAMPLES
     $ nex flow run --name global.my_flow --mode background --auth dev
 ```
-_See code: [src/commands/flow/run.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/flow/run.ts)_
+_See code: [src/commands/flow/run.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/flow/run.ts)_
 ## `nex flow status`
@@ -2323,8 +2430,8 @@ Get the status of a flow execution context.
 ```
 USAGE
-  $ nex flow status -c <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
-    [--scope <value>]
+  $ nex flow status -c <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [--scope <value>]
 FLAGS
   -a, --auth=<value>        Auth alias to use.
@@ -2335,6 +2442,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -2351,7 +2462,7 @@ EXAMPLES
     $ nex flow status --context-id abc123def456 --auth dev
 ```
-_See code: [src/commands/flow/status.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/flow/status.ts)_
+_See code: [src/commands/flow/status.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/flow/status.ts)_
 ## `nex flow subflow`
@@ -2359,8 +2470,8 @@ Execute a published Flow Designer subflow by scoped name.
 ```
 USAGE
-  $ nex flow subflow -n <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-i
-    <value>] [-m foreground|background] [--scope <value>] [--quick]
+  $ nex flow subflow -n <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [-i <value>] [-m foreground|background] [--scope <value>] [--quick]
 FLAGS
   -a, --auth=<value>    Auth alias to use.
@@ -2375,6 +2486,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -2402,7 +2517,7 @@ EXAMPLES
     $ nex flow subflow --name x_myapp.process_record --inputs '{"table":"incident","sys_id":"abc123"}' --auth dev
 ```
-_See code: [src/commands/flow/subflow.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/flow/subflow.ts)_
+_See code: [src/commands/flow/subflow.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/flow/subflow.ts)_
 ## `nex flow test`
@@ -2410,8 +2525,8 @@ Test a Flow Designer flow without requiring it to be published.
 ```
 USAGE
-  $ nex flow test -f <value> -o <value> [-j] [-a <value>] [--cred-store] [--log-level
-    debug|warn|error|info|trace] [--scope <value>] [--synchronous]
+  $ nex flow test -f <value> -o <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
+    [--log-level debug|warn|error|info|trace] [--scope <value>] [--synchronous]
 FLAGS
   -a, --auth=<value>        Auth alias to use.
@@ -2425,6 +2540,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -2456,7 +2575,7 @@ EXAMPLES
     $ nex flow test -f 887dda5583237210fdb8f7b6feaad32c -o '{"current":"abc123"}' --json --auth dev
 ```
-_See code: [src/commands/flow/test.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/flow/test.ts)_
+_See code: [src/commands/flow/test.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/flow/test.ts)_
 ## `nex health check`
@@ -2464,9 +2583,9 @@ Run a consolidated health check on a ServiceNow instance.
 ```
 USAGE
-  $ nex health check [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
-    [--include-version] [--include-cluster] [--include-stuck-jobs] [--include-semaphores] [--include-operational-counts]
-    [--stuck-job-threshold <value>]
+  $ nex health check [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [--include-version] [--include-cluster] [--include-stuck-jobs] [--include-semaphores]
+    [--include-operational-counts] [--stuck-job-threshold <value>]
 FLAGS
   -a, --auth=<value>                     Auth alias to use.
@@ -2481,6 +2600,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -2518,7 +2641,7 @@ EXAMPLES
     $ nex health check --json --auth dev
 ```
-_See code: [src/commands/health/check.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/health/check.ts)_
+_See code: [src/commands/health/check.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/health/check.ts)_
 ## `nex help [COMMAND]`
@@ -2546,8 +2669,8 @@ Tail and monitor ServiceNow system logs in real-time with beautiful formatting.
 ```
 USAGE
-  $ nex log [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-o <value>]
-    [-i <value>] [--no-color] [-f <value>...]
+  $ nex log [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [-o <value>] [-i <value>] [--no-color] [-f <value>...]
 FLAGS
   -a, --auth=<value>       Auth alias to use.
@@ -2563,6 +2686,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -2645,7 +2772,7 @@ EXAMPLES
     $ nex log --no-color --auth dev-instance
 ```
-_See code: [src/commands/log/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/log/index.ts)_
+_See code: [src/commands/log/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/log/index.ts)_
 ## `nex plugins`
@@ -2943,8 +3070,8 @@ Query any ServiceNow table using the Table API.
 ```
 USAGE
-  $ nex query -t <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-q
-    <value>] [-f <value>] [-d] [-l <value>]
+  $ nex query -t <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [-q <value>] [-f <value>] [-d] [-l <value>]
 FLAGS
   -a, --auth=<value>    Auth alias to use.
@@ -2958,6 +3085,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -2989,7 +3120,7 @@ EXAMPLES
     $ nex query --table sys_user --query "active=true" --limit 5 --json --auth dev
 ```
-_See code: [src/commands/query/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/query/index.ts)_
+_See code: [src/commands/query/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/query/index.ts)_
 ## `nex query app`
@@ -2997,8 +3128,8 @@ Search for applications by name across scoped apps and plugins.
 ```
 USAGE
-  $ nex query app -s <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-a]
-    [-l <value>]
+  $ nex query app -s <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [-a] [-l <value>]
 FLAGS
   -a, --active          Only show active applications
@@ -3010,6 +3141,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -3034,7 +3169,7 @@ EXAMPLES
     $ nex query app --search "HR" --active --auth dev
 ```
-_See code: [src/commands/query/app.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/query/app.ts)_
+_See code: [src/commands/query/app.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/query/app.ts)_
 ## `nex query columns`
@@ -3042,8 +3177,8 @@ List and search columns (fields) on a ServiceNow table.
 ```
 USAGE
-  $ nex query columns -t <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-s
-    <value>]
+  $ nex query columns -t <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [-s <value>]
 FLAGS
   -a, --auth=<value>    Auth alias to use.
@@ -3054,6 +3189,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -3081,7 +3220,7 @@ EXAMPLES
     $ nex query columns --table incident --json --auth dev
 ```
-_See code: [src/commands/query/columns.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/query/columns.ts)_
+_See code: [src/commands/query/columns.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/query/columns.ts)_
 ## `nex query syslog`
@@ -3089,8 +3228,8 @@ Query ServiceNow system logs (one-shot, non-tailing).
 ```
 USAGE
-  $ nex query syslog [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-q <value>] [-l
-    <value>]
+  $ nex query syslog [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [-q <value>] [-l <value>]
 FLAGS
   -a, --auth=<value>   Auth alias to use.
@@ -3101,6 +3240,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -3130,7 +3273,7 @@ EXAMPLES
     $ nex query syslog --query "sourceLIKEincident" --json --auth dev
 ```
-_See code: [src/commands/query/syslog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/query/syslog.ts)_
+_See code: [src/commands/query/syslog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/query/syslog.ts)_
 ## `nex schema`
@@ -3138,8 +3281,9 @@ Discover and inspect a ServiceNow table schema including fields, types, and rela
 ```
 USAGE
-  $ nex schema -t <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
-    [--include-choices] [--include-relationships] [--include-ui-policies] [--include-business-rules]
+  $ nex schema -t <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [--include-choices] [--include-relationships] [--include-ui-policies]
+    [--include-business-rules]
 FLAGS
   -a, --auth=<value>            Auth alias to use.
@@ -3153,6 +3297,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -3180,7 +3328,7 @@ EXAMPLES
     $ nex schema --table incident --include-choices --include-relationships --auth dev
 ```
-_See code: [src/commands/schema/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/schema/index.ts)_
+_See code: [src/commands/schema/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/schema/index.ts)_
 ## `nex schema field`
@@ -3188,8 +3336,8 @@ Get detailed information about a specific field on a ServiceNow table.
 ```
 USAGE
-  $ nex schema field -t <value> -f <value> [-j] [-a <value>] [--cred-store] [--log-level
-    debug|warn|error|info|trace]
+  $ nex schema field -t <value> -f <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
+    [--log-level debug|warn|error|info|trace]
 FLAGS
   -a, --auth=<value>   Auth alias to use.
@@ -3200,6 +3348,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -3219,7 +3371,7 @@ EXAMPLES
     $ nex schema field --table incident --field priority --json --auth dev
 ```
-_See code: [src/commands/schema/field.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/schema/field.ts)_
+_See code: [src/commands/schema/field.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/schema/field.ts)_
 ## `nex schema validate-catalog`
@@ -3227,7 +3379,8 @@ Validate a ServiceNow catalog item configuration for common issues.
 ```
 USAGE
-  $ nex schema validate-catalog -s <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
+  $ nex schema validate-catalog -s <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace]
 FLAGS
   -a, --auth=<value>    Auth alias to use.
@@ -3237,6 +3390,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -3256,7 +3413,7 @@ EXAMPLES
     $ nex schema validate-catalog --sys-id a1b2c3d4e5f6 --json --auth dev
 ```
-_See code: [src/commands/schema/validate-catalog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/schema/validate-catalog.ts)_
+_See code: [src/commands/schema/validate-catalog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/schema/validate-catalog.ts)_
 ## `nex scope`
@@ -3264,7 +3421,8 @@ Get the current application scope or list available applications.
 ```
 USAGE
-  $ nex scope [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-l]
+  $ nex scope [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [-l]
 FLAGS
   -a, --auth=<value>  Auth alias to use.
@@ -3274,6 +3432,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -3294,7 +3456,7 @@ EXAMPLES
     $ nex scope -l --json --auth dev
 ```
-_See code: [src/commands/scope/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/scope/index.ts)_
+_See code: [src/commands/scope/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/scope/index.ts)_
 ## `nex scope set`
@@ -3302,7 +3464,8 @@ Set the current application scope on a ServiceNow instance.
 ```
 USAGE
-  $ nex scope set -a <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
+  $ nex scope set -a <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace]
 FLAGS
   -a, --app-id=<value>  (required) 32-char sys_id of application
@@ -3312,6 +3475,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -3328,7 +3495,7 @@ EXAMPLES
     $ nex scope set -a abc123def456ghi789jkl012mno345pq --json --auth dev
 ```
-_See code: [src/commands/scope/set.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/scope/set.ts)_
+_See code: [src/commands/scope/set.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/scope/set.ts)_
 ## `nex script-sync pull`
@@ -3337,7 +3504,8 @@ Pull a script from a ServiceNow instance to a local file.
 ```
 USAGE
   $ nex script-sync pull -n <value> -t sys_script_include|sys_script|sys_ui_script|sys_ui_action|sys_script_client
-    [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-o <value>]
+    [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [-o
+    <value>]
 FLAGS
   -a, --auth=<value>    Auth alias to use.
@@ -3350,6 +3518,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -3379,7 +3551,7 @@ EXAMPLES
     $ nex script-sync pull -n MyClientScript -t sys_script_client --json --auth dev-instance
 ```
-_See code: [src/commands/script-sync/pull.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/script-sync/pull.ts)_
+_See code: [src/commands/script-sync/pull.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/script-sync/pull.ts)_
 ## `nex script-sync push`
@@ -3388,7 +3560,8 @@ Push a local script file to a ServiceNow instance.
 ```
 USAGE
   $ nex script-sync push -n <value> -t sys_script_include|sys_script|sys_ui_script|sys_ui_action|sys_script_client -f
-    <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
+    <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace]
 FLAGS
   -a, --auth=<value>   Auth alias to use.
@@ -3401,6 +3574,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -3431,7 +3608,7 @@ EXAMPLES
     $ nex script-sync push -n MyUIScript -t sys_ui_script -f ./scripts/ui-script.js --json --auth dev-instance
 ```
-_See code: [src/commands/script-sync/push.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/script-sync/push.ts)_
+_See code: [src/commands/script-sync/push.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/script-sync/push.ts)_
 ## `nex script-sync sync`
@@ -3439,8 +3616,8 @@ Synchronize all scripts in a directory with a ServiceNow instance.
 ```
 USAGE
-  $ nex script-sync sync -d <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-t
-    sys_script_include|sys_script|sys_ui_script|sys_ui_action|sys_script_client...]
+  $ nex script-sync sync -d <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [-t sys_script_include|sys_script|sys_ui_script|sys_ui_action|sys_script_client...]
 FLAGS
   -a, --auth=<value>       Auth alias to use.
@@ -3452,6 +3629,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -3481,7 +3662,7 @@ EXAMPLES
     $ nex script-sync sync -d ./scripts --json --auth dev-instance
 ```
-_See code: [src/commands/script-sync/sync.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/script-sync/sync.ts)_
+_See code: [src/commands/script-sync/sync.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/script-sync/sync.ts)_
 ## `nex search`
@@ -3489,8 +3670,8 @@ Search platform code across a ServiceNow instance.
 ```
 USAGE
-  $ nex search -t <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-l
-    <value>] [-s <value>] [-g <value>] [--table <value>]
+  $ nex search -t <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [-l <value>] [-s <value>] [-g <value>] [--table <value>]
 FLAGS
   -a, --auth=<value>          Auth alias to use.
@@ -3504,6 +3685,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -3539,7 +3724,7 @@ EXAMPLES
     $ nex search --term "GlideRecord" --limit 10 --json --auth dev-instance
 ```
-_See code: [src/commands/search/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/search/index.ts)_
+_See code: [src/commands/search/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/search/index.ts)_
 ## `nex search add-table`
@@ -3547,8 +3732,8 @@ Add a table to a code search group on a ServiceNow instance.
 ```
 USAGE
-  $ nex search add-table -f <value> -g <value> -t <value> [--json] [-a <value>] [--cred-store] [--log-level
-    debug|warn|error|info|trace]
+  $ nex search add-table -f <value> -g <value> -t <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>]
+    [--log-file] [--log-level debug|warn|error|info|trace]
 FLAGS
   -a, --auth=<value>           Auth alias to use.
@@ -3560,6 +3745,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -3591,7 +3780,7 @@ EXAMPLES
       dev-instance
 ```
-_See code: [src/commands/search/add-table.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/search/add-table.ts)_
+_See code: [src/commands/search/add-table.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/search/add-table.ts)_
 ## `nex search groups`
@@ -3599,7 +3788,8 @@ List all available code search groups on a ServiceNow instance.
 ```
 USAGE
-  $ nex search groups [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
+  $ nex search groups [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace]
 FLAGS
   -a, --auth=<value>  Auth alias to use.
@@ -3608,6 +3798,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -3631,7 +3825,7 @@ EXAMPLES
     $ nex search groups --json --auth dev-instance
 ```
-_See code: [src/commands/search/groups.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/search/groups.ts)_
+_See code: [src/commands/search/groups.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/search/groups.ts)_
 ## `nex search tables`
@@ -3639,7 +3833,8 @@ List tables configured for a specific code search group.
 ```
 USAGE
-  $ nex search tables -g <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
+  $ nex search tables -g <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace]
 FLAGS
   -a, --auth=<value>          Auth alias to use.
@@ -3649,6 +3844,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -3673,7 +3872,7 @@ EXAMPLES
     $ nex search tables --search-group "Business Rules" --json --auth dev-instance
 ```
-_See code: [src/commands/search/tables.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/search/tables.ts)_
+_See code: [src/commands/search/tables.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/search/tables.ts)_
 ## `nex store install`
@@ -3681,8 +3880,8 @@ Install an application from the ServiceNow Store.
 ```
 USAGE
-  $ nex store install -a <value> -v <value> [--json] [-a <value>] [--cred-store] [--log-level
-    debug|warn|error|info|trace] [--demo-data] [--no-wait] [--poll-interval <value>] [--timeout <value>]
+  $ nex store install -a <value> -v <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
+    [--log-level debug|warn|error|info|trace] [--demo-data] [--no-wait] [--poll-interval <value>] [--timeout <value>]
 FLAGS
   -a, --app-id=<value>         (required) Store application sys_id
@@ -3697,6 +3896,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -3717,7 +3920,7 @@ EXAMPLES
     $ nex store install -a abc123 -v 1.0.0 --demo-data --auth dev
 ```
-_See code: [src/commands/store/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/store/install.ts)_
+_See code: [src/commands/store/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/store/install.ts)_
 ## `nex store search`
@@ -3725,8 +3928,8 @@ Search for applications in the ServiceNow Store.
 ```
 USAGE
-  $ nex store search [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [--limit
-    <value>] [--tab available_for_you|installed|updates] [-t <value>]
+  $ nex store search [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [--limit <value>] [--tab available_for_you|installed|updates] [-t <value>]
 FLAGS
   -a, --auth=<value>   Auth alias to use.
@@ -3739,6 +3942,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -3759,7 +3966,7 @@ EXAMPLES
     $ nex store search --tab updates --limit 10 --auth dev
 ```
-_See code: [src/commands/store/search.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/store/search.ts)_
+_See code: [src/commands/store/search.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/store/search.ts)_
 ## `nex store update`
@@ -3767,8 +3974,8 @@ Update a ServiceNow Store application to a new version.
 ```
 USAGE
-  $ nex store update -a <value> -v <value> [--json] [-a <value>] [--cred-store] [--log-level
-    debug|warn|error|info|trace] [--no-wait] [--poll-interval <value>] [--timeout <value>]
+  $ nex store update -a <value> -v <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
+    [--log-level debug|warn|error|info|trace] [--no-wait] [--poll-interval <value>] [--timeout <value>]
 FLAGS
   -a, --app-id=<value>         (required) Store application sys_id
@@ -3782,6 +3989,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -3802,7 +4013,7 @@ EXAMPLES
     $ nex store update -a abc123 -v 2.0.0 --timeout 3600000 --auth dev
 ```
-_See code: [src/commands/store/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/store/update.ts)_
+_See code: [src/commands/store/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/store/update.ts)_
 ## `nex store validate`
@@ -3810,7 +4021,8 @@ Validate a batch installation definition file.
 ```
 USAGE
-  $ nex store validate -f <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
+  $ nex store validate -f <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace]
 FLAGS
   -a, --auth=<value>  Auth alias to use.
@@ -3820,6 +4032,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -3832,7 +4048,7 @@ EXAMPLES
     $ nex store validate --file ./batch-definition.json --auth dev
 ```
-_See code: [src/commands/store/validate.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/store/validate.ts)_
+_See code: [src/commands/store/validate.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/store/validate.ts)_
 ## `nex task approve`
@@ -3840,8 +4056,8 @@ Approve a ServiceNow change request.
 ```
 USAGE
-  $ nex task approve -n <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-c
-    <value>]
+  $ nex task approve -n <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [-c <value>]
 FLAGS
   -a, --auth=<value>      Auth alias to use.
@@ -3852,6 +4068,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -3875,7 +4095,7 @@ EXAMPLES
     $ nex task approve -n CHG0010001 -c "Looks good, approved" --auth dev
 ```
-_See code: [src/commands/task/approve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/task/approve.ts)_
+_See code: [src/commands/task/approve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/task/approve.ts)_
 ## `nex task assign`
@@ -3883,8 +4103,8 @@ Assign a ServiceNow task to a user or group.
 ```
 USAGE
-  $ nex task assign -n <value> -u <value> [--json] [-a <value>] [--cred-store] [--log-level
-    debug|warn|error|info|trace] [-g <value>] [--table <value>]
+  $ nex task assign -n <value> -u <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
+    [--log-level debug|warn|error|info|trace] [-g <value>] [--table <value>]
 FLAGS
   -a, --auth=<value>    Auth alias to use.
@@ -3897,6 +4117,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -3927,7 +4151,7 @@ EXAMPLES
     $ nex task assign --number CHG0010001 --table change_request --user admin --auth dev
 ```
-_See code: [src/commands/task/assign.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/task/assign.ts)_
+_See code: [src/commands/task/assign.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/task/assign.ts)_
 ## `nex task close`
@@ -3935,8 +4159,8 @@ Close a ServiceNow incident.
 ```
 USAGE
-  $ nex task close --notes <value> -n <value> [--json] [-a <value>] [--cred-store] [--log-level
-    debug|warn|error|info|trace] [--close-code <value>]
+  $ nex task close --notes <value> -n <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>]
+    [--log-file] [--log-level debug|warn|error|info|trace] [--close-code <value>]
 FLAGS
   -a, --auth=<value>        Auth alias to use.
@@ -3948,6 +4172,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -3972,7 +4200,7 @@ EXAMPLES
     $ nex task close -n INC0010001 --notes "Closed" --close-code "Solved (Permanently)" --auth dev
 ```
-_See code: [src/commands/task/close.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/task/close.ts)_
+_See code: [src/commands/task/close.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/task/close.ts)_
 ## `nex task comment`
@@ -3980,8 +4208,8 @@ Add a comment or work note to a ServiceNow task.
 ```
 USAGE
-  $ nex task comment -c <value> -n <value> [--json] [-a <value>] [--cred-store] [--log-level
-    debug|warn|error|info|trace] [--table <value>] [--work-note]
+  $ nex task comment -c <value> -n <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
+    [--log-level debug|warn|error|info|trace] [--table <value>] [--work-note]
 FLAGS
   -a, --auth=<value>     Auth alias to use.
@@ -3994,6 +4222,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -4023,7 +4255,7 @@ EXAMPLES
     $ nex task comment --number CHG0010001 --table change_request --comment "Approved" --auth dev
 ```
-_See code: [src/commands/task/comment.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/task/comment.ts)_
+_See code: [src/commands/task/comment.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/task/comment.ts)_
 ## `nex task find`
@@ -4031,8 +4263,8 @@ Find a ServiceNow task by its number.
 ```
 USAGE
-  $ nex task find -n <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
-    [--table <value>]
+  $ nex task find -n <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [--table <value>]
 FLAGS
   -a, --auth=<value>    Auth alias to use.
@@ -4043,6 +4275,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -4071,7 +4307,7 @@ EXAMPLES
     $ nex task find -n INC0010001 --json --auth dev
 ```
-_See code: [src/commands/task/find.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/task/find.ts)_
+_See code: [src/commands/task/find.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/task/find.ts)_
 ## `nex task resolve`
@@ -4079,8 +4315,8 @@ Resolve a ServiceNow incident with resolution notes.
 ```
 USAGE
-  $ nex task resolve --notes <value> -n <value> [--json] [-a <value>] [--cred-store] [--log-level
-    debug|warn|error|info|trace] [--close-code <value>]
+  $ nex task resolve --notes <value> -n <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>]
+    [--log-file] [--log-level debug|warn|error|info|trace] [--close-code <value>]
 FLAGS
   -a, --auth=<value>        Auth alias to use.
@@ -4092,6 +4328,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -4116,7 +4356,7 @@ EXAMPLES
     $ nex task resolve -n INC0010001 --notes "Fixed" --close-code "Solved (Permanently)" --auth dev
 ```
-_See code: [src/commands/task/resolve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/task/resolve.ts)_
+_See code: [src/commands/task/resolve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/task/resolve.ts)_
 ## `nex update-set`
@@ -4124,8 +4364,8 @@ List update sets on a ServiceNow instance.
 ```
 USAGE
-  $ nex update-set [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [--limit
-    <value>] [-q <value>]
+  $ nex update-set [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [--limit <value>] [-q <value>]
 FLAGS
   -a, --auth=<value>   Auth alias to use.
@@ -4136,6 +4376,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -4156,7 +4400,7 @@ EXAMPLES
     $ nex update-set --json --auth dev-instance
 ```
-_See code: [src/commands/update-set/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/update-set/index.ts)_
+_See code: [src/commands/update-set/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/update-set/index.ts)_
 ## `nex update-set clone`
@@ -4164,8 +4408,8 @@ Clone an update set and its records.
 ```
 USAGE
-  $ nex update-set clone -n <value> -s <value> [--json] [-a <value>] [--cred-store] [--log-level
-    debug|warn|error|info|trace]
+  $ nex update-set clone -n <value> -s <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
+    [--log-level debug|warn|error|info|trace]
 FLAGS
   -a, --auth=<value>    Auth alias to use.
@@ -4176,6 +4420,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -4192,7 +4440,7 @@ EXAMPLES
     $ nex update-set clone --source us-001 --name "Cloned Set" --json --auth dev-instance
 ```
-_See code: [src/commands/update-set/clone.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/update-set/clone.ts)_
+_See code: [src/commands/update-set/clone.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/update-set/clone.ts)_
 ## `nex update-set create`
@@ -4200,8 +4448,8 @@ Create a new update set.
 ```
 USAGE
-  $ nex update-set create -n <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
-    [--application <value>] [-d <value>]
+  $ nex update-set create -n <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [--application <value>] [-d <value>]
 FLAGS
   -a, --auth=<value>         Auth alias to use.
@@ -4213,6 +4461,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -4233,7 +4485,7 @@ EXAMPLES
     $ nex update-set create --name "My Feature Set" --application x_my_app --auth dev-instance
 ```
-_See code: [src/commands/update-set/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/update-set/create.ts)_
+_See code: [src/commands/update-set/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/update-set/create.ts)_
 ## `nex update-set current`
@@ -4241,7 +4493,8 @@ Get or set the current update set.
 ```
 USAGE
-  $ nex update-set current [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-s <value>]
+  $ nex update-set current [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace] [-s <value>]
 FLAGS
   -a, --auth=<value>  Auth alias to use.
@@ -4251,6 +4504,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -4271,7 +4528,7 @@ EXAMPLES
     $ nex update-set current --json --auth dev-instance
 ```
-_See code: [src/commands/update-set/current.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/update-set/current.ts)_
+_See code: [src/commands/update-set/current.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/update-set/current.ts)_
 ## `nex update-set inspect`
@@ -4279,7 +4536,8 @@ Inspect the components of an update set.
 ```
 USAGE
-  $ nex update-set inspect -s <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
+  $ nex update-set inspect -s <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace]
 FLAGS
   -a, --auth=<value>    Auth alias to use.
@@ -4289,6 +4547,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -4305,7 +4567,7 @@ EXAMPLES
     $ nex update-set inspect --sys-id us-001 --json --auth dev-instance
 ```
-_See code: [src/commands/update-set/inspect.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/update-set/inspect.ts)_
+_See code: [src/commands/update-set/inspect.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/update-set/inspect.ts)_
 ## `nex update-set move`
@@ -4313,8 +4575,8 @@ Move records between update sets.
 ```
 USAGE
-  $ nex update-set move --target <value> [--json] [-a <value>] [--cred-store] [--log-level
-    debug|warn|error|info|trace] [--records <value>] [--source <value>]
+  $ nex update-set move --target <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
+    [--log-level debug|warn|error|info|trace] [--records <value>] [--source <value>]
 FLAGS
   -a, --auth=<value>     Auth alias to use.
@@ -4326,6 +4588,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -4346,7 +4612,7 @@ EXAMPLES
     $ nex update-set move --target us-002 --source us-001 --json --auth dev-instance
 ```
-_See code: [src/commands/update-set/move.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/update-set/move.ts)_
+_See code: [src/commands/update-set/move.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/update-set/move.ts)_
 ## `nex workflow create`
@@ -4354,7 +4620,8 @@ Create a complete workflow from a JSON specification file.
 ```
 USAGE
-  $ nex workflow create -s <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
+  $ nex workflow create -s <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
+    debug|warn|error|info|trace]
 FLAGS
   -a, --auth=<value>  Auth alias to use.
@@ -4364,6 +4631,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -4380,7 +4651,7 @@ EXAMPLES
     $ nex workflow create -s ./workflow.json --json --auth dev
 ```
-_See code: [src/commands/workflow/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/workflow/create.ts)_
+_See code: [src/commands/workflow/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/workflow/create.ts)_
 ## `nex workflow publish`
@@ -4388,8 +4659,8 @@ Publish a workflow version.
 ```
 USAGE
-  $ nex workflow publish -s <value> -v <value> [--json] [-a <value>] [--cred-store] [--log-level
-    debug|warn|error|info|trace]
+  $ nex workflow publish -s <value> -v <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
+    [--log-level debug|warn|error|info|trace]
 FLAGS
   -a, --auth=<value>            Auth alias to use.
@@ -4400,6 +4671,10 @@ GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
   --json                Format output as json.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -4416,7 +4691,7 @@ EXAMPLES
     $ nex workflow publish -v wfv-001 -s act-001 --json --auth dev
 ```
-_See code: [src/commands/workflow/publish.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/workflow/publish.ts)_
+_See code: [src/commands/workflow/publish.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/workflow/publish.ts)_
 ## `nex xml export`
@@ -4424,8 +4699,8 @@ Export a single ServiceNow record as XML.
 ```
 USAGE
-  $ nex xml export -t <value> -s <value> [-j] [-a <value>] [--cred-store] [--log-level
-    debug|warn|error|info|trace] [-o <value>]
+  $ nex xml export -t <value> -s <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
+    [--log-level debug|warn|error|info|trace] [-o <value>]
 FLAGS
   -a, --auth=<value>    Auth alias to use.
@@ -4437,6 +4712,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -4466,7 +4745,7 @@ EXAMPLES
     $ nex xml export --table sys_script --sys-id abc123 --json --auth dev
 ```
-_See code: [src/commands/xml/export.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/xml/export.ts)_
+_See code: [src/commands/xml/export.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/xml/export.ts)_
 ## `nex xml import`
@@ -4474,8 +4753,8 @@ Import XML records into a ServiceNow instance.
 ```
 USAGE
-  $ nex xml import -f <value> -t <value> [-j] [-a <value>] [--cred-store] [--log-level
-    debug|warn|error|info|trace]
+  $ nex xml import -f <value> -t <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
+    [--log-level debug|warn|error|info|trace]
 FLAGS
   -a, --auth=<value>   Auth alias to use.
@@ -4486,6 +4765,10 @@ FLAGS
 GLOBAL FLAGS
   --cred-store          Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
                         sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
+  --log-dir=<value>     Directory to write log files to. Implies --log-file.
+  --log-file            Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
+                        (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
+                        stderr only.
   --log-level=<option>  [default: info] Specify level for logging.
                         <options: debug|warn|error|info|trace>
@@ -4510,7 +4793,7 @@ EXAMPLES
     $ nex xml import --file ./records.xml --table incident --json --auth dev
 ```
-_See code: [src/commands/xml/import.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/xml/import.ts)_
+_See code: [src/commands/xml/import.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/xml/import.ts)_
 <!-- commandsstop -->
 ---