@dxos/cli 0.1.54 → 0.1.55-main.0d3b09d

package/README.md

@@ -80,7 +80,7 @@ $ npm install -g @dxos/cli
 $ dx COMMAND
 running command...
 $ dx (--version)
-@dxos/cli/0.1.54 linux-x64 node-v18.17.0
+@dxos/cli/0.1.55-main.0d3b09d linux-x64 node-v18.17.0
 $ dx --help [COMMAND]
 USAGE
   $ dx COMMAND
@@ -100,7 +100,8 @@ USAGE
 * [`dx app open URL`](#dx-app-open-url)
 * [`dx app publish`](#dx-app-publish)
 * [`dx config`](#dx-config)
-* [`dx debug stats`](#dx-debug-stats)
+* [`dx debug diagnostics`](#dx-debug-diagnostics)
+* [`dx debug generate [KEY]`](#dx-debug-generate-key)
 * [`dx device`](#dx-device)
 * [`dx device list`](#dx-device-list)
 * [`dx function dev`](#dx-function-dev)
@@ -108,10 +109,10 @@ USAGE
 * [`dx function exec NAME`](#dx-function-exec-name)
 * [`dx function list`](#dx-function-list)
 * [`dx function logs NAME`](#dx-function-logs-name)
-* [`dx halo`](#dx-halo)
 * [`dx halo create DISPLAYNAME`](#dx-halo-create-displayname)
 * [`dx halo credential add [CREDENTIAL]`](#dx-halo-credential-add-credential)
 * [`dx halo credential list`](#dx-halo-credential-list)
+* [`dx halo info`](#dx-halo-info)
 * [`dx halo join`](#dx-halo-join)
 * [`dx halo share`](#dx-halo-share)
 * [`dx help [COMMANDS]`](#dx-help-commands)
@@ -128,13 +129,13 @@ USAGE
 * [`dx plugins update`](#dx-plugins-update)
 * [`dx reset`](#dx-reset)
 * [`dx shell`](#dx-shell)
-* [`dx space`](#dx-space)
 * [`dx space create [NAME]`](#dx-space-create-name)
 * [`dx space epoch [KEY]`](#dx-space-epoch-key)
-* [`dx space invite KEY`](#dx-space-invite-key)
 * [`dx space join`](#dx-space-join)
 * [`dx space list`](#dx-space-list)
 * [`dx space members [KEY]`](#dx-space-members-key)
+* [`dx space query [KEY]`](#dx-space-query-key)
+* [`dx space share [KEY]`](#dx-space-share-key)
 * [`dx tunnel list`](#dx-tunnel-list)
 * [`dx tunnel set`](#dx-tunnel-set)
 
@@ -150,7 +151,7 @@ FLAGS
   -v, --verbose      Verbose output
   --config=path      [default: /home/runner/.config/dx/profile/default.yml] Config file.
   --dry-run          Dry run.
-  --no-agent         Auto-start agent.
+  --no-agent         Run command without agent.
   --profile=<value>  [default: default] User profile.
   --timeout=<value>  [default: 30] Timeout in seconds.
 
@@ -176,7 +177,7 @@ FLAGS
   --dry-run          Dry run.
   --force            Force restart.
   --json             Output as JSON.
-  --no-agent         Auto-start agent.
+  --no-agent         Run command without agent.
   --profile=<value>  [default: default] User profile.
   --timeout=<value>  [default: 30] Timeout in seconds.
 
@@ -201,7 +202,7 @@ FLAGS
   --echo=port        Expose ECHO REST API.
   --json             Output as JSON.
   --monitor          Run epoch monitoring.
-  --no-agent         Auto-start agent.
+  --no-agent         Run command without agent.
   --profile=<value>  [default: default] User profile.
   --timeout=<value>  [default: 30] Timeout in seconds.
   --web-socket=port  Expose web socket port.
@@ -226,7 +227,7 @@ FLAGS
   --dry-run          Dry run.
   --force            Force stop.
   --json             Output as JSON.
-  --no-agent         Auto-start agent.
+  --no-agent         Run command without agent.
   --profile=<value>  [default: default] User profile.
   --timeout=<value>  [default: 30] Timeout in seconds.
 
@@ -254,7 +255,7 @@ FLAGS
   --config=path            [default: /home/runner/.config/dx/profile/default.yml] Config file.
   --dry-run                Dry run.
   --json                   Output as JSON.
-  --no-agent               Auto-start agent.
+  --no-agent               Run command without agent.
   --profile=<value>        [default: default] User profile.
   --tag=<value>            Git tag or branch of the DXOS repo to checkout.
   --timeout=<value>        [default: 30] Timeout in seconds.
@@ -275,7 +276,7 @@ FLAGS
   -v, --verbose      Verbose output
   --config=path      [default: /home/runner/.config/dx/profile/default.yml] Config file.
   --dry-run          Dry run.
-  --no-agent         Auto-start agent.
+  --no-agent         Run command without agent.
   --profile=<value>  [default: default] User profile.
   --timeout=<value>  [default: 30] Timeout in seconds.
 
@@ -304,7 +305,7 @@ FLAGS
   --dry-run            Dry run.
   --instances=<value>  [default: 1] Amount of test instances.
   --invite             If `true` proceed device invitation for all instances.
-  --no-agent           Auto-start agent.
+  --no-agent           Run command without agent.
   --profile=<value>    [default: default] User profile.
   --timeout=<value>    [default: 30] Timeout in seconds.
 
@@ -331,7 +332,7 @@ FLAGS
   --configPath=<value>   Path to dx.yml
   --dry-run              Dry run.
   --json                 Output as JSON.
-  --no-agent             Auto-start agent.
+  --no-agent             Run command without agent.
   --profile=<value>      [default: default] User profile.
   --skipExisting         Do not update content on KUBE if version already exists.
   --timeout=<value>      [default: 30] Timeout in seconds.
@@ -353,7 +354,7 @@ FLAGS
   -v, --verbose      Verbose output
   --config=path      [default: /home/runner/.config/dx/profile/default.yml] Config file.
   --dry-run          Dry run.
-  --no-agent         Auto-start agent.
+  --no-agent         Run command without agent.
   --profile=<value>  [default: default] User profile.
   --timeout=<value>  [default: 30] Timeout in seconds.
 
@@ -364,13 +365,13 @@ DESCRIPTION
   Show config file.
 ```
 
-## `dx debug stats`
+## `dx debug diagnostics`
 
-Output debug stats.
+Output debug diagnostics.
 
 ```
 USAGE
-  $ dx debug stats [--json] [--dry-run] [--verbose] [--config <value> --profile <value>] [--no-agent] [--timeout
+  $ dx debug diagnostics [--json] [--dry-run] [--verbose] [--config <value> --profile <value>] [--no-agent] [--timeout
     <value>] [--humanize] [--truncate]
 
 FLAGS
@@ -378,14 +379,42 @@ FLAGS
   --dry-run          Dry run.
   --humanize         Humanized keys.
   --json             Output as JSON.
-  --no-agent         Auto-start agent.
+  --no-agent         Run command without agent.
   --profile=<value>  [default: default] User profile.
   --timeout=<value>  [default: 30] Timeout in seconds.
   --truncate         Truncate keys.
   --verbose          Verbose output.
 
 DESCRIPTION
-  Output debug stats.
+  Output debug diagnostics.
+```
+
+## `dx debug generate [KEY]`
+
+Generate test data.
+
+```
+USAGE
+  $ dx debug generate [KEY] [--json] [--dry-run] [-v] [--config <value> --profile <value>] [--no-agent] [--timeout
+    <value>] [--objects <value>] [--mutations <value>] [--mutationsPerEpoch <value>]
+
+ARGUMENTS
+  KEY  Space key head in hex.
+
+FLAGS
+  -v, --verbose                Verbose output
+  --config=path                [default: /home/runner/.config/dx/profile/default.yml] Config file.
+  --dry-run                    Dry run.
+  --json                       Output as JSON.
+  --mutations=<value>          Number of mutations.
+  --mutationsPerEpoch=<value>  Number of mutations per epoch.
+  --no-agent                   Run command without agent.
+  --objects=<value>            Number of objects.
+  --profile=<value>            [default: default] User profile.
+  --timeout=<value>            [default: 30] Timeout in seconds.
+
+DESCRIPTION
+  Generate test data.
 ```
 
 ## `dx device`
@@ -400,7 +429,7 @@ FLAGS
   -v, --verbose      Verbose output
   --config=path      [default: /home/runner/.config/dx/profile/default.yml] Config file.
   --dry-run          Dry run.
-  --no-agent         Auto-start agent.
+  --no-agent         Run command without agent.
   --profile=<value>  [default: default] User profile.
   --timeout=<value>  [default: 30] Timeout in seconds.
 
@@ -417,19 +446,28 @@ Show device info.
 
 ```
 USAGE
-  $ dx device list [--json] [--dry-run] [-v] [--config <value> --profile <value>] [--no-agent] [--timeout <value>]
+  $ dx device list [--json] [--dry-run] [-v] [--config <value> --profile <value>] [--no-agent] [--timeout
+    <value>] [--columns <value> | -x] [--sort <value>] [--filter <value>] [--output csv|json|yaml |  | [--csv |
+    --no-truncate]] [--no-header | ]
 
 FLAGS
   -v, --verbose      Verbose output
+  -x, --extended     show extra columns
+  --columns=<value>  only show provided columns (comma-separated)
   --config=path      [default: /home/runner/.config/dx/profile/default.yml] Config file.
+  --csv              output is csv format [alias: --output=csv]
   --dry-run          Dry run.
-  --no-agent         Auto-start agent.
+  --filter=<value>   filter property by partial string matching, ex: name=foo
+  --json             Output as JSON.
+  --no-agent         Run command without agent.
+  --no-header        hide table header from output
+  --no-truncate      do not truncate output to fit screen
+  --output=<option>  output in a more machine friendly format
+                     <options: csv|json|yaml>
   --profile=<value>  [default: default] User profile.
+  --sort=<value>     property to sort by (prepend '-' for descending)
   --timeout=<value>  [default: 30] Timeout in seconds.
 
-GLOBAL FLAGS
-  --json  Format output as json.
-
 DESCRIPTION
   Show device info.
 ```
@@ -449,7 +487,7 @@ FLAGS
   --dry-run             Dry run.
   --json                Output as JSON.
   --manifest=<value>    [default: functions.yml]
-  --no-agent            Auto-start agent.
+  --no-agent            Run command without agent.
   --profile=<value>     [default: default] User profile.
   --require=<value>...  [default: ts-node/register]
   --timeout=<value>     [default: 30] Timeout in seconds.
@@ -481,7 +519,7 @@ FLAGS
   --dry-run             Dry run.
   --json                Output as JSON.
   --manifest=<value>    [default: functions.yml]
-  --no-agent            Auto-start agent.
+  --no-agent            Run command without agent.
   --profile=<value>     [default: default] User profile.
   --require=<value>...  [default: ts-node/register]
   --timeout=<value>     [default: 30] Timeout in seconds.
@@ -514,7 +552,7 @@ FLAGS
   -v, --verbose      Verbose output
   --config=path      [default: /home/runner/.config/dx/profile/default.yml] Config file.
   --dry-run          Dry run.
-  --no-agent         Auto-start agent.
+  --no-agent         Run command without agent.
   --profile=<value>  [default: default] User profile.
   --timeout=<value>  [default: 30] Timeout in seconds.
 
@@ -537,7 +575,7 @@ FLAGS
   -v, --verbose      Verbose output
   --config=path      [default: /home/runner/.config/dx/profile/default.yml] Config file.
   --dry-run          Dry run.
-  --no-agent         Auto-start agent.
+  --no-agent         Run command without agent.
   --profile=<value>  [default: default] User profile.
   --timeout=<value>  [default: 30] Timeout in seconds.
 
@@ -564,7 +602,7 @@ FLAGS
   -v, --verbose      Verbose output
   --config=path      [default: /home/runner/.config/dx/profile/default.yml] Config file.
   --dry-run          Dry run.
-  --no-agent         Auto-start agent.
+  --no-agent         Run command without agent.
   --profile=<value>  [default: default] User profile.
   --timeout=<value>  [default: 30] Timeout in seconds.
 
@@ -575,29 +613,6 @@ DESCRIPTION
   Get function logs.
 ```
 
-## `dx halo`
-
-Show HALO profile.
-
-```
-USAGE
-  $ dx halo [--json] [--dry-run] [-v] [--config <value> --profile <value>] [--no-agent] [--timeout <value>]
-
-FLAGS
-  -v, --verbose      Verbose output
-  --config=path      [default: /home/runner/.config/dx/profile/default.yml] Config file.
-  --dry-run          Dry run.
-  --no-agent         Auto-start agent.
-  --profile=<value>  [default: default] User profile.
-  --timeout=<value>  [default: 30] Timeout in seconds.
-
-GLOBAL FLAGS
-  --json  Format output as json.
-
-DESCRIPTION
-  Show HALO profile.
-```
-
 ## `dx halo create DISPLAYNAME`
 
 Create HALO.
@@ -614,7 +629,7 @@ FLAGS
   -v, --verbose      Verbose output
   --config=path      [default: /home/runner/.config/dx/profile/default.yml] Config file.
   --dry-run          Dry run.
-  --no-agent         Auto-start agent.
+  --no-agent         Run command without agent.
   --profile=<value>  [default: default] User profile.
   --timeout=<value>  [default: 30] Timeout in seconds.
 
@@ -642,7 +657,7 @@ FLAGS
   --config=path      [default: /home/runner/.config/dx/profile/default.yml] Config file.
   --dry-run          Dry run.
   --json             Output as JSON.
-  --no-agent         Auto-start agent.
+  --no-agent         Run command without agent.
   --profile=<value>  [default: default] User profile.
   --timeout=<value>  [default: 30] Timeout in seconds.
 
@@ -657,15 +672,25 @@ List HALO credentials.
 ```
 USAGE
   $ dx halo credential list [--json] [--dry-run] [-v] [--config <value> --profile <value>] [--no-agent] [--timeout
-    <value>] [--type <value>]
+    <value>] [--columns <value> | -x] [--sort <value>] [--filter <value>] [--output csv|json|yaml |  | [--csv |
+    --no-truncate]] [--no-header | ] [--type <value>]
 
 FLAGS
   -v, --verbose      Verbose output
+  -x, --extended     show extra columns
+  --columns=<value>  only show provided columns (comma-separated)
   --config=path      [default: /home/runner/.config/dx/profile/default.yml] Config file.
+  --csv              output is csv format [alias: --output=csv]
   --dry-run          Dry run.
+  --filter=<value>   filter property by partial string matching, ex: name=foo
   --json             Output as JSON.
-  --no-agent         Auto-start agent.
+  --no-agent         Run command without agent.
+  --no-header        hide table header from output
+  --no-truncate      do not truncate output to fit screen
+  --output=<option>  output in a more machine friendly format
+                     <options: csv|json|yaml>
   --profile=<value>  [default: default] User profile.
+  --sort=<value>     property to sort by (prepend '-' for descending)
   --timeout=<value>  [default: 30] Timeout in seconds.
   --type=<value>     Type
 
@@ -673,6 +698,29 @@ DESCRIPTION
   List HALO credentials.
 ```
 
+## `dx halo info`
+
+Show HALO profile.
+
+```
+USAGE
+  $ dx halo info [--json] [--dry-run] [-v] [--config <value> --profile <value>] [--no-agent] [--timeout <value>]
+
+FLAGS
+  -v, --verbose      Verbose output
+  --config=path      [default: /home/runner/.config/dx/profile/default.yml] Config file.
+  --dry-run          Dry run.
+  --no-agent         Run command without agent.
+  --profile=<value>  [default: default] User profile.
+  --timeout=<value>  [default: 30] Timeout in seconds.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Show HALO profile.
+```
+
 ## `dx halo join`
 
 Join HALO (device) invitation.
@@ -680,7 +728,7 @@ Join HALO (device) invitation.
 ```
 USAGE
   $ dx halo join [--json] [--dry-run] [-v] [--config <value> --profile <value>] [--no-agent] [--timeout
-    <value>] [--invitation <value>]
+    <value>] [--invitation <value>] [--secret <value>]
 
 FLAGS
   -v, --verbose         Verbose output
@@ -688,8 +736,9 @@ FLAGS
   --dry-run             Dry run.
   --invitation=<value>  Invitation code
   --json                Output as JSON.
-  --no-agent            Auto-start agent.
+  --no-agent            Run command without agent.
   --profile=<value>     [default: default] User profile.
+  --secret=<value>      Invitation secret
   --timeout=<value>     [default: 30] Timeout in seconds.
 
 DESCRIPTION
@@ -709,7 +758,7 @@ FLAGS
   -v, --verbose      Verbose output
   --config=path      [default: /home/runner/.config/dx/profile/default.yml] Config file.
   --dry-run          Dry run.
-  --no-agent         Auto-start agent.
+  --no-agent         Run command without agent.
   --noCode           Flag that specifies if secret auth code is not required
   --profile=<value>  [default: default] User profile.
   --timeout=<value>  [default: 30] Timeout in seconds.
@@ -753,7 +802,7 @@ FLAGS
   -v, --verbose      Verbose output
   --config=path      [default: /home/runner/.config/dx/profile/default.yml] Config file.
   --dry-run          Dry run.
-  --no-agent         Auto-start agent.
+  --no-agent         Run command without agent.
   --profile=<value>  [default: default] User profile.
   --timeout=<value>  [default: 30] Timeout in seconds.
 
@@ -781,7 +830,7 @@ FLAGS
   --dry-run              Dry run.
   --hostname=<value>     (required) Hostname
   --json                 Output as JSON.
-  --no-agent             Auto-start agent.
+  --no-agent             Run command without agent.
   --profile=<value>      [default: default] User profile.
   --provider=<value>     [default: digitalocean] Cloud Provider
   --timeout=<value>      [default: 30] Timeout in seconds.
@@ -1041,7 +1090,7 @@ FLAGS
   --dry-run          Dry run.
   --force            Force delete.
   --json             Output as JSON.
-  --no-agent         Auto-start agent.
+  --no-agent         Run command without agent.
   --profile=<value>  [default: default] User profile.
   --timeout=<value>  [default: 30] Timeout in seconds.
 
@@ -1062,7 +1111,7 @@ FLAGS
   --config=path      [default: /home/runner/.config/dx/profile/default.yml] Config file.
   --dry-run          Dry run.
   --json             Output as JSON.
-  --no-agent         Auto-start agent.
+  --no-agent         Run command without agent.
   --profile=<value>  [default: default] User profile.
   --timeout=<value>  [default: 30] Timeout in seconds.
 
@@ -1070,27 +1119,6 @@ DESCRIPTION
   Interactive shell.
 ```
 
-## `dx space`
-
-List spaces.
-
-```
-USAGE
-  $ dx space [--json] [--dry-run] [-v] [--config <value> --profile <value>] [--no-agent] [--timeout <value>]
-
-FLAGS
-  -v, --verbose      Verbose output
-  --config=path      [default: /home/runner/.config/dx/profile/default.yml] Config file.
-  --dry-run          Dry run.
-  --json             Output as JSON.
-  --no-agent         Auto-start agent.
-  --profile=<value>  [default: default] User profile.
-  --timeout=<value>  [default: 30] Timeout in seconds.
-
-DESCRIPTION
-  List spaces.
-```
-
 ## `dx space create [NAME]`
 
 Create space.
@@ -1104,7 +1132,7 @@ FLAGS
   -v, --verbose      Verbose output
   --config=path      [default: /home/runner/.config/dx/profile/default.yml] Config file.
   --dry-run          Dry run.
-  --no-agent         Auto-start agent.
+  --no-agent         Run command without agent.
   --profile=<value>  [default: default] User profile.
   --timeout=<value>  [default: 30] Timeout in seconds.
 
@@ -1122,54 +1150,24 @@ Create new epoch.
 ```
 USAGE
   $ dx space epoch [KEY] [--json] [--dry-run] [-v] [--config <value> --profile <value>] [--no-agent] [--timeout
-    <value>] [--columns <value> | -x] [--sort <value>] [--filter <value>] [--output csv|json|yaml |  | [--csv |
-    --no-truncate]] [--no-header | ]
+    <value>]
 
 ARGUMENTS
   KEY  Space key head in hex.
 
 FLAGS
   -v, --verbose      Verbose output
-  -x, --extended     show extra columns
-  --columns=<value>  only show provided columns (comma-separated)
   --config=path      [default: /home/runner/.config/dx/profile/default.yml] Config file.
-  --csv              output is csv format [alias: --output=csv]
   --dry-run          Dry run.
-  --filter=<value>   filter property by partial string matching, ex: name=foo
-  --json             Output as JSON.
-  --no-agent         Auto-start agent.
-  --no-header        hide table header from output
-  --no-truncate      do not truncate output to fit screen
-  --output=<option>  output in a more machine friendly format
-                     <options: csv|json|yaml>
+  --no-agent         Run command without agent.
   --profile=<value>  [default: default] User profile.
-  --sort=<value>     property to sort by (prepend '-' for descending)
   --timeout=<value>  [default: 30] Timeout in seconds.
 
-DESCRIPTION
-  Create new epoch.
-```
-
-## `dx space invite KEY`
-
-Create space invitation.
-
-```
-USAGE
-  $ dx space invite KEY [--json] [--dry-run] [-v] [--config <value> --profile <value>] [--no-agent] [--timeout
-    <value>]
-
-FLAGS
-  -v, --verbose      Verbose output
-  --config=path      [default: /home/runner/.config/dx/profile/default.yml] Config file.
-  --dry-run          Dry run.
-  --json             Output as JSON.
-  --no-agent         Auto-start agent.
-  --profile=<value>  [default: default] User profile.
-  --timeout=<value>  [default: 30] Timeout in seconds.
+GLOBAL FLAGS
+  --json  Format output as json.
 
 DESCRIPTION
-  Create space invitation.
+  Create new epoch.
 ```
 
 ## `dx space join`
@@ -1187,7 +1185,7 @@ FLAGS
   --dry-run             Dry run.
   --invitation=<value>  Invitation code
   --json                Output as JSON.
-  --no-agent            Auto-start agent.
+  --no-agent            Run command without agent.
   --profile=<value>     [default: default] User profile.
   --secret=<value>      Invitation secret
   --timeout=<value>     [default: 30] Timeout in seconds.
@@ -1215,7 +1213,7 @@ FLAGS
   --dry-run          Dry run.
   --filter=<value>   filter property by partial string matching, ex: name=foo
   --json             Output as JSON.
-  --no-agent         Auto-start agent.
+  --no-agent         Run command without agent.
   --no-header        hide table header from output
   --no-truncate      do not truncate output to fit screen
   --output=<option>  output in a more machine friendly format
@@ -1250,7 +1248,7 @@ FLAGS
   --dry-run          Dry run.
   --filter=<value>   filter property by partial string matching, ex: name=foo
   --json             Output as JSON.
-  --no-agent         Auto-start agent.
+  --no-agent         Run command without agent.
   --no-header        hide table header from output
   --no-truncate      do not truncate output to fit screen
   --output=<option>  output in a more machine friendly format
@@ -1263,6 +1261,60 @@ DESCRIPTION
   List space members.
 ```
 
+## `dx space query [KEY]`
+
+Query database.
+
+```
+USAGE
+  $ dx space query [KEY] [--json] [--dry-run] [-v] [--config <value> --profile <value>] [--no-agent] [--timeout
+    <value>]
+
+ARGUMENTS
+  KEY  Space key head in hex.
+
+FLAGS
+  -v, --verbose      Verbose output
+  --config=path      [default: /home/runner/.config/dx/profile/default.yml] Config file.
+  --dry-run          Dry run.
+  --no-agent         Run command without agent.
+  --profile=<value>  [default: default] User profile.
+  --timeout=<value>  [default: 30] Timeout in seconds.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Query database.
+```
+
+## `dx space share [KEY]`
+
+Create space invitation.
+
+```
+USAGE
+  $ dx space share [KEY] [--json] [--dry-run] [-v] [--config <value> --profile <value>] [--no-agent] [--timeout
+    <value>] [--multiple] [--no-auth]
+
+ARGUMENTS
+  KEY  Space key head in hex.
+
+FLAGS
+  -v, --verbose      Verbose output
+  --config=path      [default: /home/runner/.config/dx/profile/default.yml] Config file.
+  --dry-run          Dry run.
+  --json             Output as JSON.
+  --multiple         Multiple use.
+  --no-agent         Run command without agent.
+  --no-auth          Skip authentication challenge.
+  --profile=<value>  [default: default] User profile.
+  --timeout=<value>  [default: 5000] Timeout in milliseconds.
+
+DESCRIPTION
+  Create space invitation.
+```
+
 ## `dx tunnel list`
 
 List tunnels.
@@ -1275,7 +1327,7 @@ FLAGS
   -v, --verbose      Verbose output
   --config=path      [default: /home/runner/.config/dx/profile/default.yml] Config file.
   --dry-run          Dry run.
-  --no-agent         Auto-start agent.
+  --no-agent         Run command without agent.
   --profile=<value>  [default: default] User profile.
   --timeout=<value>  [default: 30] Timeout in seconds.
 
@@ -1303,7 +1355,7 @@ FLAGS
   --dry-run          Dry run.
   --enabled          Enable tunnel.
   --json             Output as JSON.
-  --no-agent         Auto-start agent.
+  --no-agent         Run command without agent.
   --profile=<value>  [default: default] User profile.
   --timeout=<value>  [default: 30] Timeout in seconds.
 

package/dist/src/base-command.d.ts

@@ -1,6 +1,7 @@
 import { Command, Config as OclifConfig, Interfaces } from '@oclif/core';
 import { Daemon } from '@dxos/agent';
 import { Client, Config } from '@dxos/client';
+import { Space } from '@dxos/client/echo';
 import { PublisherRpcPeer, SupervisorRpcPeer, TelemetryContext, TunnelRpcPeer } from './util';
 export type Flags<T extends typeof Command> = Interfaces.InferredFlags<(typeof BaseCommand)['baseFlags'] & T['flags']>;
 export type Args<T extends typeof Command> = Interfaces.InferredArgs<T['args']>;
@@ -56,7 +57,6 @@ export declare abstract class BaseCommand<T extends typeof Command = any> extend
      * https://oclif.io/docs/error_handling
      */
     error(err: string | Error, options?: any): never;
-    catch(err: Error, options?: any): Promise<void>;
     /**
      * Called after each command run.
      */
@@ -66,6 +66,14 @@ export declare abstract class BaseCommand<T extends typeof Command = any> extend
      * Lazily create the client.
      */
     getClient(): Promise<Client>;
+    /**
+     * Get spaces and optionally wait until ready.
+     */
+    getSpaces(client: Client, wait?: boolean): Promise<Space[]>;
+    /**
+     * Get or select space.
+     */
+    getSpace(client: Client, key?: string): Promise<Space>;
     /**
      * Convenience function to wrap command passing in client object.
      */

package/dist/src/base-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-command.d.ts","sourceRoot":"","sources":["../../src/base-command.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base-command.d.ts","sourceRoot":"","sources":["../../src/base-command.ts"],"names":[],"mappings":"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"}