@teambit/harmony.content.cli-reference 2.0.341 → 2.0.343

package/cli-reference.json

@@ -1179,422 +1179,137 @@
     ]
   },
   {
-    "name": "deps <sub-command>",
-    "alias": "dependencies",
+    "name": "watch",
+    "alias": "",
+    "options": [
+      [
+        "v",
+        "verbose",
+        "show all watch events and compiler verbose output"
+      ],
+      [
+        "",
+        "skip-pre-compilation",
+        "skip compilation step before starting to watch"
+      ],
+      [
+        "t",
+        "check-types [string]",
+        "EXPERIMENTAL. show errors/warnings for types. options are [file, project] to investigate only changed file or entire project. defaults to project"
+      ],
+      [
+        "i",
+        "import",
+        "DEPRECATED. it is now the default. helpful when using git. import component objects if .bitmap changed not by bit"
+      ],
+      [
+        "",
+        "skip-import",
+        "do not import component objects if .bitmap changed not by bit"
+      ]
+    ],
+    "description": "automatically recompile modified components (on save)",
+    "extendedDescription": "by default, the watcher doesn't use polling, to keep the CPU idle.\nif this doesn't work well for you, run \"bit config set watch_use_polling true\" to use polling.",
+    "group": "development",
+    "private": false
+  },
+  {
+    "name": "ws-config <sub-command>",
+    "alias": "workspace-config",
     "options": [],
-    "description": "manage dependencies",
+    "description": "manage workspace config files",
     "extendedDescription": "",
-    "group": "info",
+    "group": "development",
     "private": false,
     "commands": [
       {
-        "name": "get <component-name>",
+        "name": "write",
         "alias": "",
         "options": [
           [
-            "",
-            "scope",
-            "get the data from the scope instead of the workspace"
+            "c",
+            "clean",
+            "delete existing config files from the workspace. highly recommended to run it with \"--dry-run\" first"
           ],
           [
-            "t",
-            "tree",
-            "EXPERIMENTAL. render dependencies as a tree, similar to \"npm ls\""
-          ]
-        ],
-        "description": "show direct and indirect dependencies of the given component",
-        "extendedDescription": "",
-        "group": "info",
-        "private": false,
-        "arguments": [
-          {
-            "name": "component-name",
-            "description": "component name or component id"
-          }
-        ]
-      },
-      {
-        "name": "remove <component-pattern> <package...>",
-        "alias": "",
-        "options": [
+            "w",
+            "writers <writers>",
+            "only write config files for the given writers. use comma to separate multiple writers. use ws-config list to see all writers"
+          ],
           [
-            "d",
-            "dev",
-            "remove from devDependencies"
+            "s",
+            "silent",
+            "do not prompt for confirmation"
           ],
           [
-            "p",
-            "peer",
-            "remove from peerDependencies"
-          ]
-        ],
-        "description": "remove a dependency to component(s)",
-        "extendedDescription": "",
-        "group": "info",
-        "private": false,
-        "arguments": [
-          {
-            "name": "component-pattern",
-            "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nwrap the pattern with quotes. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\".\nuse '$' prefix to filter by states/attributes, e.g. '$deprecated', '$modified' or '$env:teambit.react/react'.\nuse `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern."
-          },
-          {
-            "name": "package...",
-            "description": "package name with or without a version, e.g. \"lodash@1.0.0\" or just \"lodash\" which will remove all lodash instances of any version"
-          }
-        ]
-      },
-      {
-        "name": "unset <component-pattern> <package...>",
-        "alias": "",
-        "options": [
+            "",
+            "no-dedupe",
+            "write configs inside each one of the component's dir, avoid deduping"
+          ],
           [
-            "d",
-            "dev",
-            "unset from devDependencies"
+            "",
+            "dry-run",
+            "show the paths that configs will be written per env"
           ],
           [
-            "p",
-            "peer",
-            "unset from peerDependencies"
+            "",
+            "dry-run-with-content",
+            "use with --json flag. show the config content and the paths that will be written per env"
+          ],
+          [
+            "v",
+            "verbose",
+            "showing verbose output for writing"
+          ],
+          [
+            "j",
+            "json",
+            "json format"
           ]
         ],
-        "description": "unset a dependency to component(s) that was previously set by \"bit deps set\"",
-        "extendedDescription": "",
-        "group": "info",
-        "private": false,
-        "arguments": [
-          {
-            "name": "component-pattern",
-            "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nwrap the pattern with quotes. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\".\nuse '$' prefix to filter by states/attributes, e.g. '$deprecated', '$modified' or '$env:teambit.react/react'.\nuse `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern."
-          },
-          {
-            "name": "package...",
-            "description": "package name with or without a version, e.g. \"lodash@1.0.0\" or just \"lodash\" which will remove all lodash instances of any version"
-          }
-        ]
-      },
-      {
-        "name": "debug <component-name>",
-        "alias": "",
-        "options": [],
-        "description": "show the immediate dependencies and how their versions were determined",
+        "description": "write config files in the workspace. useful for IDEs",
         "extendedDescription": "",
-        "group": "info",
-        "private": false,
-        "arguments": [
-          {
-            "name": "component-name",
-            "description": "component name or component id"
-          }
-        ]
+        "group": "development",
+        "private": false
       },
       {
-        "name": "set <component-pattern> <package...>",
+        "name": "clean",
         "alias": "",
         "options": [
           [
-            "d",
-            "dev",
-            "add to the devDependencies"
+            "s",
+            "silent",
+            "do not prompt for confirmation"
           ],
           [
-            "o",
-            "optional",
-            "add to the optionalDependencies"
+            "w",
+            "writers <writers>",
+            "only clean config files for the given writers. use comma to separate multiple writers. use ws-config list to see all writers"
           ],
           [
-            "p",
-            "peer",
-            "add to the peerDependencies"
+            "",
+            "dry-run",
+            "show the paths of configs that will be cleaned"
+          ],
+          [
+            "j",
+            "json",
+            "json format"
           ]
         ],
-        "description": "set a dependency to component(s)",
-        "extendedDescription": "",
-        "group": "info",
-        "private": false,
-        "arguments": [
-          {
-            "name": "component-pattern",
-            "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nwrap the pattern with quotes. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\".\nuse '$' prefix to filter by states/attributes, e.g. '$deprecated', '$modified' or '$env:teambit.react/react'.\nuse `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern."
-          },
-          {
-            "name": "package...",
-            "description": "package name with or without a version, e.g. \"lodash@1.0.0\" or just \"lodash\" which will be resolved to the latest"
-          }
-        ]
-      },
-      {
-        "name": "reset <component-pattern>",
-        "alias": "",
-        "options": [],
-        "description": "reset dependencies to the default values (revert any previously \"bit deps set\")",
-        "extendedDescription": "",
-        "group": "info",
-        "private": false,
-        "arguments": [
-          {
-            "name": "component-pattern",
-            "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nwrap the pattern with quotes. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\".\nuse '$' prefix to filter by states/attributes, e.g. '$deprecated', '$modified' or '$env:teambit.react/react'.\nuse `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern."
-          }
-        ]
-      },
-      {
-        "name": "eject <component-pattern>",
-        "alias": "",
-        "options": [],
-        "description": "write dependencies that were previously set via \"bit deps set\" into .bitmap",
-        "extendedDescription": "",
-        "group": "info",
-        "private": false,
-        "arguments": [
-          {
-            "name": "component-pattern",
-            "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nwrap the pattern with quotes. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\".\nuse '$' prefix to filter by states/attributes, e.g. '$deprecated', '$modified' or '$env:teambit.react/react'.\nuse `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern."
-          }
-        ]
-      },
-      {
-        "name": "blame <component-name> <dependency-name>",
-        "alias": "",
-        "options": [],
-        "description": "EXPERIMENTAL. find out which snap/tag changed a dependency version",
+        "description": "clean (delete) written config files in the workspace. useful for IDEs",
         "extendedDescription": "",
-        "group": "info",
-        "private": false,
-        "arguments": [
-          {
-            "name": "dependency-name",
-            "description": "package-name. for components, you can use either component-id or package-name"
-          }
-        ]
+        "group": "development",
+        "private": false
       },
       {
-        "name": "usage <dependency-name>",
+        "name": "list",
         "alias": "",
         "options": [
           [
-            "",
-            "depth <number>",
-            "max display depth of the dependency graph"
-          ]
-        ],
-        "description": "EXPERIMENTAL. find components that use the specified dependency",
-        "extendedDescription": "",
-        "group": "info",
-        "private": false,
-        "arguments": [
-          {
-            "name": "dependency-name",
-            "description": "package-name. for components, you can use either component-id or package-name. if version is specified, it will search for the exact version"
-          }
-        ]
-      }
-    ]
-  },
-  {
-    "name": "why <dependency-name>",
-    "alias": "",
-    "options": [
-      [
-        "",
-        "depth <number>",
-        "max display depth of the dependency graph"
-      ]
-    ],
-    "description": "EXPERIMENTAL. find components that use the specified dependency",
-    "extendedDescription": "",
-    "group": "info",
-    "private": false,
-    "arguments": [
-      {
-        "name": "dependency-name",
-        "description": "package-name. for components, you can use either component-id or package-name. if version is specified, it will search for the exact version"
-      }
-    ]
-  },
-  {
-    "name": "set-peer <component-id> <range>",
-    "alias": "",
-    "options": [],
-    "description": "set a component as always peer",
-    "extendedDescription": "",
-    "group": "info",
-    "private": false,
-    "arguments": [
-      {
-        "name": "component-id",
-        "description": "the component to set as always peer"
-      },
-      {
-        "name": "range",
-        "description": "the default range to use for the componnent, when added to peerDependencies"
-      }
-    ]
-  },
-  {
-    "name": "unset-peer <component-id>",
-    "alias": "",
-    "options": [],
-    "description": "unset a component as always peer",
-    "extendedDescription": "",
-    "group": "info",
-    "private": false,
-    "arguments": [
-      {
-        "name": "component-id",
-        "description": "the component to unset as always peer"
-      }
-    ]
-  },
-  {
-    "name": "dependents <component-name>",
-    "alias": "",
-    "options": [],
-    "description": "show dependents of the given component",
-    "extendedDescription": "",
-    "group": "info",
-    "private": false,
-    "arguments": [
-      {
-        "name": "component-name",
-        "description": "component name or component id"
-      }
-    ]
-  },
-  {
-    "name": "list [remote-scope]",
-    "alias": "ls",
-    "options": [
-      [
-        "i",
-        "ids",
-        "show only component ids, unformatted"
-      ],
-      [
-        "s",
-        "scope",
-        "show only components stored in the local scope, including indirect dependencies"
-      ],
-      [
-        "o",
-        "outdated",
-        "highlight outdated components, in comparison with their latest remote version (if one exists)"
-      ],
-      [
-        "j",
-        "json",
-        "show the output in JSON format"
-      ],
-      [
-        "n",
-        "namespace <string>",
-        "show only components in the specified namespace/s e.g. '-n ui' or '*/ui'"
-      ]
-    ],
-    "description": "list components on a workspace or a remote scope (with flag).",
-    "extendedDescription": "",
-    "group": "discover",
-    "private": false,
-    "remoteOp": true,
-    "skipWorkspace": true
-  },
-  {
-    "name": "ws-config <sub-command>",
-    "alias": "workspace-config",
-    "options": [],
-    "description": "manage workspace config files",
-    "extendedDescription": "",
-    "group": "development",
-    "private": false,
-    "commands": [
-      {
-        "name": "write",
-        "alias": "",
-        "options": [
-          [
-            "c",
-            "clean",
-            "delete existing config files from the workspace. highly recommended to run it with \"--dry-run\" first"
-          ],
-          [
-            "w",
-            "writers <writers>",
-            "only write config files for the given writers. use comma to separate multiple writers. use ws-config list to see all writers"
-          ],
-          [
-            "s",
-            "silent",
-            "do not prompt for confirmation"
-          ],
-          [
-            "",
-            "no-dedupe",
-            "write configs inside each one of the component's dir, avoid deduping"
-          ],
-          [
-            "",
-            "dry-run",
-            "show the paths that configs will be written per env"
-          ],
-          [
-            "",
-            "dry-run-with-content",
-            "use with --json flag. show the config content and the paths that will be written per env"
-          ],
-          [
-            "v",
-            "verbose",
-            "showing verbose output for writing"
-          ],
-          [
-            "j",
-            "json",
-            "json format"
-          ]
-        ],
-        "description": "write config files in the workspace. useful for IDEs",
-        "extendedDescription": "",
-        "group": "development",
-        "private": false
-      },
-      {
-        "name": "clean",
-        "alias": "",
-        "options": [
-          [
-            "s",
-            "silent",
-            "do not prompt for confirmation"
-          ],
-          [
-            "w",
-            "writers <writers>",
-            "only clean config files for the given writers. use comma to separate multiple writers. use ws-config list to see all writers"
-          ],
-          [
-            "",
-            "dry-run",
-            "show the paths of configs that will be cleaned"
-          ],
-          [
-            "j",
-            "json",
-            "json format"
-          ]
-        ],
-        "description": "clean (delete) written config files in the workspace. useful for IDEs",
-        "extendedDescription": "",
-        "group": "development",
-        "private": false
-      },
-      {
-        "name": "list",
-        "alias": "",
-        "options": [
-          [
-            "j",
-            "json",
-            "json format"
+            "j",
+            "json",
+            "json format"
           ]
         ],
         "description": "list config writers",
@@ -1807,41 +1522,6 @@
       }
     ]
   },
-  {
-    "name": "watch",
-    "alias": "",
-    "options": [
-      [
-        "v",
-        "verbose",
-        "show all watch events and compiler verbose output"
-      ],
-      [
-        "",
-        "skip-pre-compilation",
-        "skip compilation step before starting to watch"
-      ],
-      [
-        "t",
-        "check-types [string]",
-        "EXPERIMENTAL. show errors/warnings for types. options are [file, project] to investigate only changed file or entire project. defaults to project"
-      ],
-      [
-        "i",
-        "import",
-        "DEPRECATED. it is now the default. helpful when using git. import component objects if .bitmap changed not by bit"
-      ],
-      [
-        "",
-        "skip-import",
-        "do not import component objects if .bitmap changed not by bit"
-      ]
-    ],
-    "description": "automatically recompile modified components (on save)",
-    "extendedDescription": "by default, the watcher doesn't use polling, to keep the CPU idle.\nif this doesn't work well for you, run \"bit config set watch_use_polling true\" to use polling.",
-    "group": "development",
-    "private": false
-  },
   {
     "name": "build [component-pattern]",
     "alias": "",
@@ -1910,178 +1590,508 @@
         "",
         "include-tag",
         "EXPERIMENTAL. include tag pipeline tasks. Warning: this may deploy/publish if you have such tasks"
-      ]
-    ],
+      ],
+      [
+        "i",
+        "ignore-issues <issues>",
+        "ignore component issues (shown in \"bit status\" as \"issues found\"), issues to ignore:\n[MissingPackagesDependenciesOnFs, MissingManuallyConfiguredPackages, UntrackedDependencies, ResolveErrors, RelativeComponents, RelativeComponentsAuthored, ParseErrors, MissingDists, LegacyInsideHarmony, MissingDependenciesOnFs, ImportNonMainFiles, MultipleEnvs, MissingLinksFromNodeModulesToSrc, CircularDependencies, DuplicateComponentAndPackage, MergeConfigHasConflict, NonLoadedEnv, ExternalEnvWithoutVersion, RemovedDependencies, RemovedEnv, DeprecatedDependencies, SelfReference, ImportFromDirectory]\nto ignore multiple issues, separate them by a comma and wrap with quotes. to ignore all issues, specify \"*\"."
+      ]
+    ],
     "description": "run set of tasks for build.",
     "extendedDescription": "by default, only new and modified components are built.\nthe build takes place in an isolated directories on the filesystem (called \"capsules\"). the component files are copied to these directories\nand the package-manager installs the dependencies in the capsules root. once done, the build pipeline is running.\nbecause this process can take a while on a large workspace, some flags are available to shorten the process. See the example section for more info.\n  ",
     "group": "development",
     "private": false,
     "arguments": [
       {
-        "name": "component-pattern",
-        "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nwrap the pattern with quotes. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\".\nuse '$' prefix to filter by states/attributes, e.g. '$deprecated', '$modified' or '$env:teambit.react/react'.\nuse `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern."
-      }
-    ],
-    "examples": [
+        "name": "component-pattern",
+        "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nwrap the pattern with quotes. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\".\nuse '$' prefix to filter by states/attributes, e.g. '$deprecated', '$modified' or '$env:teambit.react/react'.\nuse `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern."
+      }
+    ],
+    "examples": [
+      {
+        "cmd": "build --reuse-capsules --tasks \"custom-task\"",
+        "description": "helps to debug this \"custom-task\" without recreating the capsules from scratch"
+      },
+      {
+        "cmd": "build --reuse-capsules --rewrite --tasks \"BabelCompile,MochaTest\"",
+        "description": "helpful when for example the tests are failing and code changes are needed to debug it.\nthe \"--rewrite\" flag ensures the component files are fresh, and the \"--tasks\" ensures to re-compile them and then run the tests"
+      }
+    ]
+  },
+  {
+    "name": "artifacts <component-pattern>",
+    "alias": "",
+    "options": [
+      [
+        "",
+        "aspect <aspect-id>",
+        "show/download only artifacts generated by this aspect-id"
+      ],
+      [
+        "",
+        "task <task-id>",
+        "show/download only artifacts generated by this task-id"
+      ],
+      [
+        "",
+        "files <glob>",
+        "show/download only artifacts matching the given files or the glob pattern (wrap glob patterns in quotes)"
+      ],
+      [
+        "",
+        "out-dir <string>",
+        "download the files to the specified dir"
+      ]
+    ],
+    "description": "list and download component artifacts",
+    "extendedDescription": "artifacts are created on isolated capsules during tag or snap commands.\nexample of artifacts are dists files generated by a compiler, a JUnit.xml file generated by a tester\nand a package.tgz file generated by pkg aspect.\n",
+    "group": "development",
+    "private": false,
+    "arguments": [
+      {
+        "name": "component-pattern",
+        "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nwrap the pattern with quotes. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\".\nuse '$' prefix to filter by states/attributes, e.g. '$deprecated', '$modified' or '$env:teambit.react/react'.\nuse `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern."
+      }
+    ]
+  },
+  {
+    "name": "run <app-name>",
+    "alias": "c",
+    "options": [
+      [
+        "d",
+        "dev",
+        "start the application in dev mode."
+      ],
+      [
+        "p",
+        "port [port-number]",
+        "port to run the app on"
+      ],
+      [
+        "v",
+        "verbose",
+        "show verbose output for inspection and print stack trace"
+      ],
+      [
+        "w",
+        "watch",
+        "watch and compile your components upon changes"
+      ]
+    ],
+    "description": "locally run an app component (independent of bit's dev server)",
+    "extendedDescription": "",
+    "group": "apps",
+    "private": false,
+    "arguments": [
+      {
+        "name": "app-name",
+        "description": "the app's name is registered by the app (run 'bit app list' to list the names of the available apps)"
+      }
+    ]
+  },
+  {
+    "name": "app-list",
+    "alias": "",
+    "options": [
+      [
+        "j",
+        "json",
+        "return the component data in json format"
+      ]
+    ],
+    "description": "DEPRECATED. use \"bit app list\"",
+    "extendedDescription": "",
+    "group": "apps",
+    "private": true
+  },
+  {
+    "name": "app <sub-command>",
+    "alias": "apps",
+    "options": [],
+    "description": "Manages apps",
+    "extendedDescription": "",
+    "group": "apps",
+    "private": false,
+    "commands": [
+      {
+        "name": "list",
+        "alias": "",
+        "options": [
+          [
+            "j",
+            "json",
+            "return the component data in json format"
+          ]
+        ],
+        "description": "list all registered apps",
+        "extendedDescription": "",
+        "group": "apps",
+        "private": false
+      },
+      {
+        "name": "run <app-name>",
+        "alias": "c",
+        "options": [
+          [
+            "d",
+            "dev",
+            "start the application in dev mode."
+          ],
+          [
+            "p",
+            "port [port-number]",
+            "port to run the app on"
+          ],
+          [
+            "v",
+            "verbose",
+            "show verbose output for inspection and print stack trace"
+          ],
+          [
+            "w",
+            "watch",
+            "watch and compile your components upon changes"
+          ]
+        ],
+        "description": "locally run an app component (independent of bit's dev server)",
+        "extendedDescription": "",
+        "group": "apps",
+        "private": false,
+        "arguments": [
+          {
+            "name": "app-name",
+            "description": "the app's name is registered by the app (run 'bit app list' to list the names of the available apps)"
+          }
+        ]
+      }
+    ]
+  },
+  {
+    "name": "deps <sub-command>",
+    "alias": "dependencies",
+    "options": [],
+    "description": "manage dependencies",
+    "extendedDescription": "",
+    "group": "info",
+    "private": false,
+    "commands": [
+      {
+        "name": "get <component-name>",
+        "alias": "",
+        "options": [
+          [
+            "",
+            "scope",
+            "get the data from the scope instead of the workspace"
+          ],
+          [
+            "t",
+            "tree",
+            "EXPERIMENTAL. render dependencies as a tree, similar to \"npm ls\""
+          ]
+        ],
+        "description": "show direct and indirect dependencies of the given component",
+        "extendedDescription": "",
+        "group": "info",
+        "private": false,
+        "arguments": [
+          {
+            "name": "component-name",
+            "description": "component name or component id"
+          }
+        ]
+      },
+      {
+        "name": "remove <component-pattern> <package...>",
+        "alias": "",
+        "options": [
+          [
+            "d",
+            "dev",
+            "remove from devDependencies"
+          ],
+          [
+            "p",
+            "peer",
+            "remove from peerDependencies"
+          ]
+        ],
+        "description": "remove a dependency to component(s)",
+        "extendedDescription": "",
+        "group": "info",
+        "private": false,
+        "arguments": [
+          {
+            "name": "component-pattern",
+            "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nwrap the pattern with quotes. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\".\nuse '$' prefix to filter by states/attributes, e.g. '$deprecated', '$modified' or '$env:teambit.react/react'.\nuse `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern."
+          },
+          {
+            "name": "package...",
+            "description": "package name with or without a version, e.g. \"lodash@1.0.0\" or just \"lodash\" which will remove all lodash instances of any version"
+          }
+        ]
+      },
+      {
+        "name": "unset <component-pattern> <package...>",
+        "alias": "",
+        "options": [
+          [
+            "d",
+            "dev",
+            "unset from devDependencies"
+          ],
+          [
+            "p",
+            "peer",
+            "unset from peerDependencies"
+          ]
+        ],
+        "description": "unset a dependency to component(s) that was previously set by \"bit deps set\"",
+        "extendedDescription": "",
+        "group": "info",
+        "private": false,
+        "arguments": [
+          {
+            "name": "component-pattern",
+            "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nwrap the pattern with quotes. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\".\nuse '$' prefix to filter by states/attributes, e.g. '$deprecated', '$modified' or '$env:teambit.react/react'.\nuse `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern."
+          },
+          {
+            "name": "package...",
+            "description": "package name with or without a version, e.g. \"lodash@1.0.0\" or just \"lodash\" which will remove all lodash instances of any version"
+          }
+        ]
+      },
+      {
+        "name": "debug <component-name>",
+        "alias": "",
+        "options": [],
+        "description": "show the immediate dependencies and how their versions were determined",
+        "extendedDescription": "",
+        "group": "info",
+        "private": false,
+        "arguments": [
+          {
+            "name": "component-name",
+            "description": "component name or component id"
+          }
+        ]
+      },
+      {
+        "name": "set <component-pattern> <package...>",
+        "alias": "",
+        "options": [
+          [
+            "d",
+            "dev",
+            "add to the devDependencies"
+          ],
+          [
+            "o",
+            "optional",
+            "add to the optionalDependencies"
+          ],
+          [
+            "p",
+            "peer",
+            "add to the peerDependencies"
+          ]
+        ],
+        "description": "set a dependency to component(s)",
+        "extendedDescription": "",
+        "group": "info",
+        "private": false,
+        "arguments": [
+          {
+            "name": "component-pattern",
+            "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nwrap the pattern with quotes. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\".\nuse '$' prefix to filter by states/attributes, e.g. '$deprecated', '$modified' or '$env:teambit.react/react'.\nuse `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern."
+          },
+          {
+            "name": "package...",
+            "description": "package name with or without a version, e.g. \"lodash@1.0.0\" or just \"lodash\" which will be resolved to the latest"
+          }
+        ]
+      },
+      {
+        "name": "reset <component-pattern>",
+        "alias": "",
+        "options": [],
+        "description": "reset dependencies to the default values (revert any previously \"bit deps set\")",
+        "extendedDescription": "",
+        "group": "info",
+        "private": false,
+        "arguments": [
+          {
+            "name": "component-pattern",
+            "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nwrap the pattern with quotes. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\".\nuse '$' prefix to filter by states/attributes, e.g. '$deprecated', '$modified' or '$env:teambit.react/react'.\nuse `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern."
+          }
+        ]
+      },
+      {
+        "name": "eject <component-pattern>",
+        "alias": "",
+        "options": [],
+        "description": "write dependencies that were previously set via \"bit deps set\" into .bitmap",
+        "extendedDescription": "",
+        "group": "info",
+        "private": false,
+        "arguments": [
+          {
+            "name": "component-pattern",
+            "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nwrap the pattern with quotes. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\".\nuse '$' prefix to filter by states/attributes, e.g. '$deprecated', '$modified' or '$env:teambit.react/react'.\nuse `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern."
+          }
+        ]
+      },
       {
-        "cmd": "build --reuse-capsules --tasks \"custom-task\"",
-        "description": "helps to debug this \"custom-task\" without recreating the capsules from scratch"
+        "name": "blame <component-name> <dependency-name>",
+        "alias": "",
+        "options": [],
+        "description": "EXPERIMENTAL. find out which snap/tag changed a dependency version",
+        "extendedDescription": "",
+        "group": "info",
+        "private": false,
+        "arguments": [
+          {
+            "name": "dependency-name",
+            "description": "package-name. for components, you can use either component-id or package-name"
+          }
+        ]
       },
       {
-        "cmd": "build --reuse-capsules --rewrite --tasks \"BabelCompile,MochaTest\"",
-        "description": "helpful when for example the tests are failing and code changes are needed to debug it.\nthe \"--rewrite\" flag ensures the component files are fresh, and the \"--tasks\" ensures to re-compile them and then run the tests"
+        "name": "usage <dependency-name>",
+        "alias": "",
+        "options": [
+          [
+            "",
+            "depth <number>",
+            "max display depth of the dependency graph"
+          ]
+        ],
+        "description": "EXPERIMENTAL. find components that use the specified dependency",
+        "extendedDescription": "",
+        "group": "info",
+        "private": false,
+        "arguments": [
+          {
+            "name": "dependency-name",
+            "description": "package-name. for components, you can use either component-id or package-name. if version is specified, it will search for the exact version"
+          }
+        ]
       }
     ]
   },
   {
-    "name": "artifacts <component-pattern>",
+    "name": "why <dependency-name>",
     "alias": "",
     "options": [
       [
         "",
-        "aspect <aspect-id>",
-        "show/download only artifacts generated by this aspect-id"
-      ],
-      [
-        "",
-        "task <task-id>",
-        "show/download only artifacts generated by this task-id"
-      ],
-      [
-        "",
-        "files <glob>",
-        "show/download only artifacts matching the given files or the glob pattern (wrap glob patterns in quotes)"
-      ],
-      [
-        "",
-        "out-dir <string>",
-        "download the files to the specified dir"
+        "depth <number>",
+        "max display depth of the dependency graph"
       ]
     ],
-    "description": "list and download component artifacts",
-    "extendedDescription": "artifacts are created on isolated capsules during tag or snap commands.\nexample of artifacts are dists files generated by a compiler, a JUnit.xml file generated by a tester\nand a package.tgz file generated by pkg aspect.\n",
-    "group": "development",
+    "description": "EXPERIMENTAL. find components that use the specified dependency",
+    "extendedDescription": "",
+    "group": "info",
     "private": false,
     "arguments": [
       {
-        "name": "component-pattern",
-        "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nwrap the pattern with quotes. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\".\nuse '$' prefix to filter by states/attributes, e.g. '$deprecated', '$modified' or '$env:teambit.react/react'.\nuse `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern."
+        "name": "dependency-name",
+        "description": "package-name. for components, you can use either component-id or package-name. if version is specified, it will search for the exact version"
       }
     ]
   },
   {
-    "name": "run <app-name>",
-    "alias": "c",
-    "options": [
-      [
-        "d",
-        "dev",
-        "start the application in dev mode."
-      ],
-      [
-        "p",
-        "port [port-number]",
-        "port to run the app on"
-      ],
-      [
-        "v",
-        "verbose",
-        "show verbose output for inspection and print stack trace"
-      ],
-      [
-        "w",
-        "watch",
-        "watch and compile your components upon changes"
-      ]
-    ],
-    "description": "locally run an app component (independent of bit's dev server)",
+    "name": "set-peer <component-id> <range>",
+    "alias": "",
+    "options": [],
+    "description": "set a component as always peer",
     "extendedDescription": "",
-    "group": "apps",
+    "group": "info",
     "private": false,
     "arguments": [
       {
-        "name": "app-name",
-        "description": "the app's name is registered by the app (run 'bit app list' to list the names of the available apps)"
+        "name": "component-id",
+        "description": "the component to set as always peer"
+      },
+      {
+        "name": "range",
+        "description": "the default range to use for the componnent, when added to peerDependencies"
       }
     ]
   },
   {
-    "name": "app-list",
+    "name": "unset-peer <component-id>",
     "alias": "",
-    "options": [
-      [
-        "j",
-        "json",
-        "return the component data in json format"
-      ]
-    ],
-    "description": "DEPRECATED. use \"bit app list\"",
+    "options": [],
+    "description": "unset a component as always peer",
     "extendedDescription": "",
-    "group": "apps",
-    "private": true
+    "group": "info",
+    "private": false,
+    "arguments": [
+      {
+        "name": "component-id",
+        "description": "the component to unset as always peer"
+      }
+    ]
   },
   {
-    "name": "app <sub-command>",
-    "alias": "apps",
+    "name": "dependents <component-name>",
+    "alias": "",
     "options": [],
-    "description": "Manages apps",
+    "description": "show dependents of the given component",
     "extendedDescription": "",
-    "group": "apps",
+    "group": "info",
     "private": false,
-    "commands": [
-      {
-        "name": "list",
-        "alias": "",
-        "options": [
-          [
-            "j",
-            "json",
-            "return the component data in json format"
-          ]
-        ],
-        "description": "list all registered apps",
-        "extendedDescription": "",
-        "group": "apps",
-        "private": false
-      },
+    "arguments": [
       {
-        "name": "run <app-name>",
-        "alias": "c",
-        "options": [
-          [
-            "d",
-            "dev",
-            "start the application in dev mode."
-          ],
-          [
-            "p",
-            "port [port-number]",
-            "port to run the app on"
-          ],
-          [
-            "v",
-            "verbose",
-            "show verbose output for inspection and print stack trace"
-          ],
-          [
-            "w",
-            "watch",
-            "watch and compile your components upon changes"
-          ]
-        ],
-        "description": "locally run an app component (independent of bit's dev server)",
-        "extendedDescription": "",
-        "group": "apps",
-        "private": false,
-        "arguments": [
-          {
-            "name": "app-name",
-            "description": "the app's name is registered by the app (run 'bit app list' to list the names of the available apps)"
-          }
-        ]
+        "name": "component-name",
+        "description": "component name or component id"
       }
     ]
   },
+  {
+    "name": "list [remote-scope]",
+    "alias": "ls",
+    "options": [
+      [
+        "i",
+        "ids",
+        "show only component ids, unformatted"
+      ],
+      [
+        "s",
+        "scope",
+        "show only components stored in the local scope, including indirect dependencies"
+      ],
+      [
+        "o",
+        "outdated",
+        "highlight outdated components, in comparison with their latest remote version (if one exists)"
+      ],
+      [
+        "d",
+        "include-deleted",
+        "EXPERIMENTAL. show also deleted components"
+      ],
+      [
+        "j",
+        "json",
+        "show the output in JSON format"
+      ],
+      [
+        "n",
+        "namespace <string>",
+        "show only components in the specified namespace/s e.g. '-n ui' or '*/ui'"
+      ]
+    ],
+    "description": "list components on a workspace or a remote scope (with flag).",
+    "extendedDescription": "",
+    "group": "discover",
+    "private": false,
+    "remoteOp": true,
+    "skipWorkspace": true
+  },
   {
     "name": "compile [component-names...]",
     "alias": "",
@@ -3390,6 +3400,11 @@
         "env <id>",
         "test only components assigned the given env"
       ],
+      [
+        "",
+        "update-snapshot",
+        "if supported by the tester, re-record every snapshot that fails during the test run"
+      ],
       [
         "s",
         "scope <scope-name>",