@teambit/harmony.content.cli-reference 1.95.65 → 1.95.66

package/cli-reference.json

@@ -33,11 +33,21 @@
         "reset-hard",
         "delete all Bit files and directories, including Bit configuration, tracking and model data. Useful for re-start using Bit from scratch"
       ],
+      [
+        "",
+        "reset-scope",
+        "removes local scope (.bit or .git/bit). snaps that were not exported will be lost. workspace left intact"
+      ],
       [
         "d",
         "default-directory <default-directory>",
         "set up default directory to import components into"
       ],
+      [
+        "",
+        "default-scope <default-scope>",
+        "set up default scope for all components in the workspace"
+      ],
       [
         "p",
         "package-manager <package-manager>",
@@ -65,52 +75,6 @@
     "private": false,
     "skipWorkspace": true
   },
-  {
-    "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"
-      ],
-      [
-        "b",
-        "bare",
-        "DEPRECATED. use --raw instead"
-      ],
-      [
-        "r",
-        "raw",
-        "show raw output (only components ids, no styling)"
-      ],
-      [
-        "o",
-        "outdated",
-        "show latest versions from remotes"
-      ],
-      [
-        "j",
-        "json",
-        "show the output in JSON format"
-      ],
-      [
-        "n",
-        "namespace <string>",
-        "show only specified namespace by using wildcards"
-      ]
-    ],
-    "description": "list components on a workspace, local scope or a remote scope.",
-    "extendedDescription": "https://bit.dev/docs/reference/cli-reference#list",
-    "group": "discover",
-    "private": false,
-    "skipWorkspace": true
-  },
   {
     "name": "config",
     "alias": "",
@@ -256,7 +220,7 @@
     "private": true
   },
   {
-    "name": "dependents <id>",
+    "name": "dependents <component-name>",
     "alias": "",
     "options": [],
     "description": "EXPERIMENTAL. show dependents of the given component",
@@ -264,21 +228,6 @@
     "group": "info",
     "private": false
   },
-  {
-    "name": "dependencies <id>",
-    "alias": "",
-    "options": [
-      [
-        "d",
-        "debug",
-        "show the immediate dependencies and how their version was determined"
-      ]
-    ],
-    "description": "EXPERIMENTAL. show dependencies (direct and indirect) of the given component",
-    "extendedDescription": "",
-    "group": "info",
-    "private": false
-  },
   {
     "name": "_log <path> <args>",
     "alias": "",
@@ -365,21 +314,6 @@
     "private": true,
     "internal": true
   },
-  {
-    "name": "inject-conf [id]",
-    "alias": "",
-    "options": [
-      [
-        "f",
-        "force",
-        "force injecting even if there are config files changes"
-      ]
-    ],
-    "description": "injecting components configuration",
-    "extendedDescription": "",
-    "group": "ungrouped",
-    "private": true
-  },
   {
     "name": "_scope <path> <args>",
     "alias": "",
@@ -390,36 +324,6 @@
     "private": true,
     "internal": true
   },
-  {
-    "name": "ci-update <id> [scopePath]",
-    "alias": "",
-    "options": [
-      [
-        "d",
-        "directory [file]",
-        "directory to run ci-update"
-      ],
-      [
-        "k",
-        "keep",
-        "keep test environment after run (default false)"
-      ],
-      [
-        "c",
-        "no-cache",
-        "ignore component cache when creating dist file"
-      ],
-      [
-        "o",
-        "output [file]",
-        "save ci results to file system"
-      ]
-    ],
-    "description": "run an update for build and test of a certain bit-component",
-    "extendedDescription": "",
-    "group": "ungrouped",
-    "private": true
-  },
   {
     "name": "cat-scope [scopePath]",
     "alias": "",
@@ -515,21 +419,11 @@
         "main <file>",
         "define entry point for the components"
       ],
-      [
-        "t",
-        "tests <file>/\"<file>,<file>\"",
-        "specify test files to track. use quotation marks to list files or use a glob pattern"
-      ],
       [
         "n",
         "namespace <namespace>",
         "organize component in a namespace"
       ],
-      [
-        "e",
-        "exclude <file>/\"<file>,<file>\"",
-        "exclude file from being tracked. use quotation marks to list files or use a glob pattern"
-      ],
       [
         "o",
         "override <boolean>",
@@ -547,22 +441,7 @@
     "private": false
   },
   {
-    "name": "untrack [ids...]",
-    "alias": "u",
-    "options": [
-      [
-        "a",
-        "all",
-        "revert add for all tracked components"
-      ]
-    ],
-    "description": "DEPRECATED (use \"bit remove\" instead). untrack a new component(s)\n  https://legacy-docs.bit.dev/docs/add-and-isolate-components#untracking-components\n  you can use a pattern for multiple ids, such as bit untrack \"utils/*\". (wrap the pattern with quotes to avoid collision with shell commands)",
-    "extendedDescription": "",
-    "group": "ungrouped",
-    "private": true
-  },
-  {
-    "name": "untag [id] [version]",
+    "name": "untag [component-name] [component-version]",
     "alias": "",
     "options": [
       [
@@ -581,67 +460,20 @@
         "revert the tag even if used as a dependency. WARNING: components that depend on this tag will corrupt"
       ]
     ],
-    "description": "revert versions tagged for component(s)",
+    "description": "revert tagged or snapped versions for component(s)",
     "extendedDescription": "https://bit.dev/docs/components/tags#undoing-a-tag\nyou can use a pattern for multiple ids, such as bit untag \"utils/*\". (wrap the pattern with quotes to avoid collision with shell commands)",
     "group": "development",
-    "private": false
+    "private": true
   },
   {
-    "name": "move <existing-dir> <new-dir>",
+    "name": "move <current-component-dir> <new-component-dir>",
     "alias": "mv",
-    "options": [
-      [
-        "c",
-        "component",
-        "move component files that are spread over multiple directories to one directory. synopsis: `move <component-id> <directory>`"
-      ]
-    ],
+    "options": [],
     "description": "move a component to a different filesystem path",
     "extendedDescription": "move files or directories of component(s)\n  https://bit.dev/docs/workspace/moving-components",
     "group": "development",
     "private": false
   },
-  {
-    "name": "remove <ids...>",
-    "alias": "rm",
-    "options": [
-      [
-        "r",
-        "remote",
-        "remove a component from a remote scope"
-      ],
-      [
-        "t",
-        "track",
-        "keep tracking component (default = false)"
-      ],
-      [
-        "d",
-        "delete-files",
-        "DEPRECATED (this is now the default). delete local component files"
-      ],
-      [
-        "",
-        "keep-files",
-        "keep component files (just untrack the component)"
-      ],
-      [
-        "f",
-        "force",
-        "removes the component from the scope, even if used as a dependency. WARNING: components that depend on this component will corrupt"
-      ],
-      [
-        "s",
-        "silent",
-        "skip confirmation"
-      ]
-    ],
-    "description": "remove component(s) from your workspace, or a remote scope",
-    "extendedDescription": "https://bit.dev/docs/components/removing-components\nyou can use a pattern for multiple ids, such as bit remove \"utils/*\". (wrap the pattern with quotes to avoid collision with shell commands)",
-    "group": "collaborate",
-    "private": false,
-    "skipWorkspace": true
-  },
   {
     "name": "_delete <path> <args>",
     "alias": "",
@@ -652,26 +484,6 @@
     "private": true,
     "internal": true
   },
-  {
-    "name": "_deprecate <path> <args>",
-    "alias": "",
-    "options": [],
-    "description": "deprecate a component from a scope",
-    "extendedDescription": "",
-    "group": "ungrouped",
-    "private": true,
-    "internal": true
-  },
-  {
-    "name": "_undeprecate <path> <args>",
-    "alias": "",
-    "options": [],
-    "description": "undeprecate a component from a scope",
-    "extendedDescription": "",
-    "group": "ungrouped",
-    "private": true,
-    "internal": true
-  },
   {
     "name": "_latest <path> <args>",
     "alias": "",
@@ -682,76 +494,6 @@
     "private": true,
     "internal": true
   },
-  {
-    "name": "checkout [values...]",
-    "alias": "U",
-    "options": [
-      [
-        "i",
-        "interactive-merge",
-        "when a component is modified and the merge process found conflicts, display options to resolve them"
-      ],
-      [
-        "o",
-        "ours",
-        "in case of a conflict, override the used version with the current modification"
-      ],
-      [
-        "t",
-        "theirs",
-        "in case of a conflict, override the current modification with the specified version"
-      ],
-      [
-        "m",
-        "manual",
-        "in case of a conflict, leave the files with a conflict state to resolve them manually later"
-      ],
-      [
-        "r",
-        "reset",
-        "remove local changes"
-      ],
-      [
-        "a",
-        "all",
-        "all components"
-      ],
-      [
-        "v",
-        "verbose",
-        "showing verbose output for inspection"
-      ],
-      [
-        "",
-        "skip-npm-install",
-        "DEPRECATED. use \"--skip-dependency-installation\" instead"
-      ],
-      [
-        "",
-        "skip-dependency-installation",
-        "do not install packages of the imported components"
-      ],
-      [
-        "",
-        "ignore-package-json",
-        "do not generate package.json for the imported component(s). (it automatically enables skip-npm-install and save-dependencies-as-components flags)"
-      ],
-      [
-        "",
-        "conf [path]",
-        "write the configuration file (bit.json) and the envs configuration files (use --conf without path to write to the default dir)"
-      ],
-      [
-        "",
-        "ignore-dist",
-        "do not write dist files (when exist)"
-      ]
-    ],
-    "description": "switch between component versions or remove local changes",
-    "extendedDescription": "\n  `bit checkout <version> [ids...]` => checkout the specified ids (or all components when --all is used) to the specified version\n  `bit checkout latest [ids...]` => checkout the specified ids (or all components when --all is used) to their latest versions\n  `bit checkout [ids...] --reset` => remove local modifications from the specified ids (or all components when --all is used)\n  you can use a pattern for multiple ids, such as bit checkout 0.0.1 \"utils/*\". (wrap the pattern with quotes to avoid collision with shell commands)",
-    "group": "development",
-    "private": false
-  },
   {
     "name": "diff [values...]",
     "alias": "",
@@ -767,7 +509,7 @@
         "show tables instead of plain text for dependencies diff"
       ]
     ],
-    "description": "show diff between components files",
+    "description": "show the diff between the components' source files and config",
     "extendedDescription": "bit diff => compare all modified components to their model version\n  bit diff [ids...] => compare the specified components against their modified states\n  bit diff [id] [version] => compare the specified version to used or modified files\n  bit diff [id] [version] [to_version] => compare the specified version files to to_version files\n  you can use a pattern for multiple ids, such as bit diff \"utils/*\". (wrap the pattern with quotes to avoid collision with shell commands)",
     "group": "development",
     "private": false
@@ -798,11 +540,11 @@
       ],
       [
         "",
-        "machine-name <string>",
+        "machine-name <name>",
         "specify machine-name to pair with the token (useful for CI to avoid accidentally revoke the token)"
       ]
     ],
-    "description": "log the CLI into Bit Cloud",
+    "description": "log in to Bit cloud",
     "extendedDescription": "",
     "group": "general",
     "private": false,
@@ -825,11 +567,6 @@
         "v",
         "verbose",
         "showing logs for the migration process"
-      ],
-      [
-        "h",
-        "harmony",
-        "migrate workspace from legacy to Harmony"
       ]
     ],
     "description": "migrate scope to the current version",
@@ -997,23 +734,13 @@
     "private": false
   },
   {
-    "name": "use [ids...]",
-    "alias": "",
-    "options": [],
-    "description": "set up aspects in the workspace/scope config",
-    "extendedDescription": "",
-    "group": "collaborate",
-    "private": false,
-    "remoteOp": true
-  },
-  {
-    "name": "show <id>",
+    "name": "show <component-name>",
     "alias": "",
     "options": [
       [
         "j",
         "json",
-        "return the component data in json format"
+        "return the component data in a json format"
       ],
       [
         "l",
@@ -1028,34 +755,25 @@
       [
         "c",
         "compare",
-        "compare current file system component to latest tagged component [default=latest]. only works in legacy."
+        "compare current file system component to the latest tagged component [default=latest]. only works in legacy."
       ]
     ],
-    "description": "show a component",
+    "description": "display the component's essential information",
     "extendedDescription": "",
     "group": "info",
-    "private": false
-  },
-  {
-    "name": "globals",
-    "alias": "",
-    "options": [
-      [
-        "j",
-        "json",
-        "json format"
-      ]
-    ],
-    "description": "list all globals",
-    "extendedDescription": "",
-    "group": "workspace",
-    "private": false
+    "private": false,
+    "arguments": [
+      {
+        "name": "component-name",
+        "description": "component name or component id"
+      }
+    ]
   },
   {
     "name": "envs",
     "alias": "env",
     "options": [],
-    "description": "list all components envs",
+    "description": "list all components maintained by the workspace and their corresponding envs",
     "extendedDescription": "",
     "group": "development",
     "private": false,
@@ -1070,36 +788,102 @@
         "private": false
       },
       {
-        "name": "get <name>",
+        "name": "get <component-name>",
         "alias": "",
         "options": [],
-        "description": "show component's env details",
+        "description": "show information about a component's env",
         "extendedDescription": "",
         "group": "development",
-        "private": false
+        "private": false,
+        "arguments": [
+          {
+            "name": "component-name",
+            "description": "the 'component name' or 'component id' of the component its env you'd like to inspect"
+          }
+        ]
       },
       {
-        "name": "set <pattern> <env>",
+        "name": "set <component-pattern> <env>",
         "options": [],
-        "description": "set an environment for component(s)",
-        "extendedDescription": "you can use a `<pattern>` for multiple component ids, such as `bit env set \"org.scope/utils/**\"`. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nto validate the pattern before running this command, run `bit pattern <pattern>`.\n",
-        "group": "development"
+        "description": "Sets one or more components with a development environment (env)",
+        "group": "development",
+        "arguments": [
+          {
+            "name": "component-pattern",
+            "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
+          },
+          {
+            "name": "env",
+            "description": "the env's component id (include version for non-core envs. e.g, `teambit.community/envs/community-react@1.95.13`)"
+          }
+        ],
+        "examples": [
+          {
+            "cmd": "set ui/button teambit.react/react",
+            "description": "configures 'ui/button' to use the 'teambit.react/react' env"
+          },
+          {
+            "cmd": "set ui/button teambit.community/envs/community-mdx@1.95.16",
+            "description": "configures 'ui/button' to use the (non-core) 'teambit.community/envs/community-mdx@1.95.16' env"
+          },
+          {
+            "cmd": "set \"ui/**\" teambit.react/react",
+            "description": "configures all components that have the 'ui' namespace to use the teambit.react/react env"
+          }
+        ]
       },
       {
-        "name": "unset <component>",
+        "name": "unset <component-pattern>",
         "options": [],
-        "description": "unset an environment from component(s)",
-        "extendedDescription": "you can use a `<pattern>` for multiple component ids, such as `bit env unset \"org.scope/utils/**\"`. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nto validate the pattern before running this command, run `bit pattern <pattern>`.\n",
-        "group": "development"
+        "description": "un-sets an env from components that were previously set by \"bit env set\" or by a component template",
+        "extendedDescription": "keep in mind that this doesn't remove envs that are set in the variants.\nin only removes envs that appear in the .bitmap file, which were previously configured via \"bit env set\".\nthe purpose of this command is to remove the specific settings and let the the variants in workspace.jsonc to control the env.\nyou can use a `<pattern>` for multiple component ids, such as `bit env unset \"org.scope/utils/**\"`.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nuse `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern.\n",
+        "group": "development",
+        "arguments": [
+          {
+            "name": "component-pattern",
+            "description": "component name, component id, or component pattern. use component pattern to select multiple components. \nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
+          }
+        ]
       },
       {
-        "name": "replace <old-env> <new-env>",
+        "name": "replace <current-env> <new-env>",
         "options": [],
         "description": "replace an existing env with another env for all components using the old env",
-        "group": "development"
+        "group": "development",
+        "arguments": [
+          {
+            "name": "current-env",
+            "description": "the component id of the current env"
+          },
+          {
+            "name": "new-env",
+            "description": "the component id of the new env"
+          }
+        ],
+        "examples": [
+          {
+            "cmd": "replace teambit.harmony/aspect teambit.harmony/node",
+            "description": "components configured to use the 'aspect' env will be configured to use the 'node' env, instead"
+          }
+        ]
       }
     ]
   },
+  {
+    "name": "globals",
+    "alias": "",
+    "options": [
+      [
+        "j",
+        "json",
+        "json format"
+      ]
+    ],
+    "description": "list all globals",
+    "extendedDescription": "",
+    "group": "workspace",
+    "private": false
+  },
   {
     "name": "start [type] [pattern]",
     "alias": "c",
@@ -1111,7 +895,7 @@
       ],
       [
         "p",
-        "port [number]",
+        "port [port-number]",
         "port of the UI server."
       ],
       [
@@ -1122,7 +906,7 @@
       [
         "v",
         "verbose",
-        "showing verbose output for inspection and prints stack trace"
+        "show verbose output for inspection and prints stack trace"
       ],
       [
         "",
@@ -1135,7 +919,7 @@
         "skip the auto-compilation before starting the web-server"
       ]
     ],
-    "description": "Start a dev environment for a workspace or a specific component",
+    "description": "run the ui/development server",
     "extendedDescription": "",
     "group": "development",
     "private": false
@@ -1153,29 +937,49 @@
     "name": "scope <sub-command>",
     "alias": "",
     "options": [],
-    "description": "EXPERIMENTAL. manage scope-name",
+    "description": "EXPERIMENTAL. manage the scope-name for components",
     "extendedDescription": "",
     "group": "development",
     "private": false,
     "commands": [
       {
-        "name": "set <scope-name> [pattern]",
+        "name": "set <scope-name> [component-pattern]",
         "options": [],
-        "description": "set the default-scope",
-        "extendedDescription": "set a new scope in the workspace.jsonc.\nif \"pattern\" is provided, the default-scope will be set to the new components matching the criteria.\n\nyou can use a `<pattern>` for multiple component ids, such as `bit scope set scope-name \"org.scope/utils/**\"`. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nto validate the pattern before running this command, run `bit pattern <pattern>`.\n",
-        "group": "development"
+        "description": "Sets components with a default-scope. If no component is specified, sets the workspace with a default scope",
+        "extendedDescription": "default scopes for components are set in the bitmap file. the default scope for a workspace is set in the workspace.jsonc. a component is set with a scope (as oppose to default scope) only once it is versioned.'\n\nyou can use a `<pattern>` for multiple component ids, such as `bit scope set scope-name \"org.scope/utils/**\"`.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nuse `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern.\n",
+        "group": "development",
+        "arguments": [
+          {
+            "name": "scope-name",
+            "description": "the scope name to use as the default scope"
+          },
+          {
+            "name": "component-pattern",
+            "description": "component name, component id, or component pattern. use component pattern to select multiple components. \nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
+          }
+        ]
       },
       {
-        "name": "rename <old-name> <new-name>",
+        "name": "rename <current-scope-name> <new-scope-name>",
         "options": [
           [
             "r",
             "refactor",
-            "change the source code of all components using the original scope-name with the new scope-name"
+            "update the import statements in all dependent components to the new package name (that contains the new scope name)"
           ]
         ],
-        "description": "rename a scope for components using the old-name, optionally change the dependencies source-code",
-        "group": "development"
+        "description": "Renames the scope name for all components with the specified 'current scope name'",
+        "group": "development",
+        "arguments": [
+          {
+            "name": "current-scope-name",
+            "description": "the scope name to be replaced by another scope name"
+          },
+          {
+            "name": "new-scope-name",
+            "description": "a new scope name to replace the current scope name"
+          }
+        ]
       },
       {
         "name": "fork <original-scope> <new-scope>",
@@ -1225,10 +1029,16 @@
         "install all missing peer dependencies"
       ]
     ],
-    "description": "install development workspace dependencies",
-    "extendedDescription": "",
+    "description": "installs workspace dependencies",
+    "extendedDescription": "when no package is specified, all workspace dependencies are installed and all workspace components are imported.",
     "group": "development",
-    "private": false
+    "private": false,
+    "arguments": [
+      {
+        "name": "packages...",
+        "description": "a list of packages to install (separated by spaces)"
+      }
+    ]
   },
   {
     "name": "update",
@@ -1270,7 +1080,7 @@
       ]
     ],
     "description": "eject components configuration (create a `component.json` file)",
-    "extendedDescription": "you can use a `<pattern>` for multiple component ids, such as `bit eject-conf \"org.scope/utils/**\"`. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nto validate the pattern before running this command, run `bit pattern <pattern>`.\n",
+    "extendedDescription": "you can use a `<pattern>` for multiple component ids, such as `bit eject-conf \"org.scope/utils/**\"`.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nuse `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern.\n",
     "group": "development",
     "private": false
   },
@@ -1279,7 +1089,7 @@
     "alias": "",
     "options": [],
     "description": "manage capsules",
-    "extendedDescription": "a capsule is a directory contains the component code, isolated from the workspace.\nnormally, capsules are created during the build process, the component files are copied and the packages are installed\nvia the configured package-manager. the purpose is to compile/test them in isolation to make sure they will work for\nother users after publishing/exporting them.",
+    "extendedDescription": "a capsule is a directory containing the component code, isolated from the workspace.\nnormally, capsules are created during the build process, the component files are copied and the packages are installed\nvia the configured package-manager. the purpose is to compile/test them in isolation to make sure they will work for\nother users after publishing/exporting them.",
     "group": "capsules",
     "private": false,
     "commands": [
@@ -1293,13 +1103,13 @@
             "json format"
           ]
         ],
-        "description": "list all capsules",
+        "description": "list the capsules generated for this workspace",
         "extendedDescription": "",
         "group": "capsules",
         "private": false
       },
       {
-        "name": "create [componentIds...]",
+        "name": "create [component-id...]",
         "alias": "",
         "options": [
           [
@@ -1343,7 +1153,7 @@
             "npm, yarn or pnpm, default to npm"
           ]
         ],
-        "description": "create capsules",
+        "description": "create capsules for components",
         "extendedDescription": "",
         "group": "capsules",
         "private": false
@@ -1377,7 +1187,7 @@
       [
         "v",
         "verbose",
-        "showing npm verbose output for inspection and prints stack trace"
+        "show npm verbose output for inspection and print the stack trace"
       ],
       [
         "",
@@ -1390,13 +1200,13 @@
         "EXPERIMENTAL. show errors/warnings for types. options are [file, project] to investigate only changed file or entire project. defaults to project"
       ]
     ],
-    "description": "watch a set of components",
+    "description": "automatically recompile modified components (on save)",
     "extendedDescription": "",
     "group": "development",
     "private": false
   },
   {
-    "name": "link [ids...]",
+    "name": "link [component-names...]",
     "alias": "",
     "options": [
       [
@@ -1425,10 +1235,32 @@
         "skip fetch missing objects from remotes before linking"
       ]
     ],
-    "description": "link components and core aspects",
+    "description": "create links in the node_modules directory, to core aspects and to components in the workspace",
     "extendedDescription": "https://bit.dev/docs/workspace/component-links",
     "group": "development",
-    "private": false
+    "private": false,
+    "arguments": [
+      {
+        "name": "component-names...",
+        "description": "names or IDs of the components to link"
+      }
+    ]
+  },
+  {
+    "name": "use <component-id>",
+    "alias": "",
+    "options": [],
+    "description": "set aspects in the workspace/scope config to make them loadable by the workspace/scope",
+    "extendedDescription": "",
+    "group": "collaborate",
+    "private": false,
+    "remoteOp": true,
+    "arguments": [
+      {
+        "name": "component-id",
+        "description": "the component ID of the aspect"
+      }
+    ]
   },
   {
     "name": "pattern <pattern>",
@@ -1441,48 +1273,70 @@
       ]
     ],
     "description": "list the component ids matching the given pattern",
-    "extendedDescription": "",
+    "extendedDescription": "this command helps validating a pattern before using it in other commands.\na pattern can be a simple component-id or component-name. e.g. \"ui/button\".\na pattern can be used with wildcards for multiple component ids, e.g. \"org.scope/utils/**\".\nto enter multiple patterns, separate them by a comma, e.g. \"ui/*, lib/*\"\nto exclude, use \"!\". e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nthe matching algorithm is done by multimatch (@see https://github.com/sindresorhus/multimatch)\n",
     "group": "development",
-    "private": false
+    "private": false,
+    "examples": [
+      {
+        "cmd": "bit pattern \"**\"",
+        "description": "matches all components"
+      },
+      {
+        "cmd": "bit pattern \"*/ui/*\"",
+        "description": "matches components with any scope-name and the \"ui\" namespace. e.g. \"ui/button\" but not \"ui/elements/button\""
+      },
+      {
+        "cmd": "bit pattern \"*/ui/**\"",
+        "description": "matches components that their namespace starts with \"ui/\" e.g. \"ui/button\", \"ui/elements/button\""
+      },
+      {
+        "cmd": "bit pattern \"bar, foo\"",
+        "description": "matches two components: bar and foo"
+      },
+      {
+        "cmd": "bit pattern \"my-scope.org/**\"",
+        "description": "matches all components of the scope \"my-scope.org\""
+      }
+    ]
   },
   {
-    "name": "import [ids...]",
-    "alias": "",
+    "name": "checkout [values...]",
+    "alias": "U",
     "options": [
       [
-        "p",
-        "path <path>",
-        "import components into a specific directory"
+        "i",
+        "interactive-merge",
+        "when a component is modified and the merge process found conflicts, display options to resolve them"
       ],
       [
         "o",
-        "objects",
-        "import components objects only, don't write the components to the file system. This is a default behavior for import with no id"
+        "ours",
+        "in case of a conflict, override the used version with the current modification"
       ],
       [
-        "d",
-        "display-dependencies",
-        "display the imported dependencies"
+        "t",
+        "theirs",
+        "in case of a conflict, override the current modification with the specified version"
       ],
       [
-        "O",
-        "override",
-        "override local changes"
+        "m",
+        "manual",
+        "in case of a conflict, leave the files with a conflict state to resolve them manually later"
       ],
       [
-        "v",
-        "verbose",
-        "showing verbose output for inspection"
+        "r",
+        "reset",
+        "revert changes that were not snapped/tagged"
       ],
       [
-        "j",
-        "json",
-        "return the output as JSON"
+        "a",
+        "all",
+        "all components"
       ],
       [
-        "",
-        "conf",
-        "write the configuration file (component.json) of the component (harmony components only)"
+        "v",
+        "verbose",
+        "showing verbose output for inspection"
       ],
       [
         "",
@@ -1495,365 +1349,177 @@
         "do not install packages of the imported components"
       ],
       [
-        "m",
-        "merge [strategy]",
-        "merge local changes with the imported version. strategy should be \"theirs\", \"ours\" or \"manual\""
+        "",
+        "ignore-package-json",
+        "do not generate package.json for the imported component(s). (it automatically enables skip-npm-install and save-dependencies-as-components flags)"
       ],
       [
         "",
-        "dependencies",
-        "EXPERIMENTAL. import all dependencies and write them to the workspace"
+        "conf [path]",
+        "write the configuration file (bit.json) and the envs configuration files (use --conf without path to write to the default dir)"
       ],
       [
         "",
-        "dependents",
-        "EXPERIMENTAL. import component dependents to allow auto-tag updating them upon tag"
-      ],
+        "ignore-dist",
+        "do not write dist files (when exist)"
+      ]
+    ],
+    "description": "switch between component versions or remove local changes",
+    "extendedDescription": "\n  `bit checkout <version> [ids...]` => checkout the specified ids (or all components when --all is used) to the specified version\n  `bit checkout head` => checkout all components to their latest versions\n  `bit checkout head [ids...]` => checkout the specified ids to their latest versions\n  `bit checkout [ids...] --reset` => remove local modifications from the specified ids (or all components when --all is used)\n  you can use a pattern for multiple ids, such as bit checkout 0.0.1 \"utils/*\". (wrap the pattern with quotes to avoid collision with shell commands)",
+    "group": "development",
+    "private": false
+  },
+  {
+    "name": "remove <component-pattern>",
+    "alias": "rm",
+    "options": [
       [
         "",
-        "skip-lane",
-        "EXPERIMENTAL. when checked out to a lane, do not import the component into the lane, save it on main"
+        "soft",
+        "EXPERIMENTAL. mark the component as deleted. after tag/snap and export the remote will be updated"
+      ],
+      [
+        "r",
+        "remote",
+        "remove a component completely from a remote scope (Careful! this is a permanent change. prefer --soft and tag+export)"
+      ],
+      [
+        "t",
+        "track",
+        "keep tracking component in .bitmap (default = false), helps transform a tagged-component to new"
+      ],
+      [
+        "d",
+        "delete-files",
+        "DEPRECATED (this is now the default). delete local component files"
       ],
       [
         "",
-        "all-history",
-        "relevant for fetching all components objects. avoid optimizations, fetch all history versions, always"
+        "keep-files",
+        "keep component files (just untrack the component)"
+      ],
+      [
+        "f",
+        "force",
+        "removes the component from the scope, even if used as a dependency. WARNING: components that depend on this component will corrupt"
+      ],
+      [
+        "s",
+        "silent",
+        "skip confirmation"
       ]
     ],
-    "description": "import components into your workspace",
-    "extendedDescription": "https://bit.dev/docs/components/importing-components\nyou can use a pattern for multiple ids, such as bit import \"utils/*\". (wrap the pattern with quotes to avoid collision with shell commands)",
+    "description": "remove component(s) from the workspace, or a remote scope",
+    "extendedDescription": "",
     "group": "collaborate",
     "private": false,
-    "remoteOp": true
+    "remoteOp": true,
+    "skipWorkspace": true,
+    "arguments": [
+      {
+        "name": "component-pattern",
+        "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
+      }
+    ]
   },
   {
-    "name": "create <templateName> <componentNames...>",
+    "name": "insights [names...]",
     "alias": "",
     "options": [
       [
-        "n",
-        "namespace <string>",
-        "sets the component's namespace and nested dirs inside the scope"
-      ],
-      [
-        "s",
-        "scope <string>",
-        "sets the component's scope-name. if not entered, the default-scope will be used"
-      ],
-      [
-        "a",
-        "aspect <string>",
-        "aspect-id of the template. helpful when multiple aspects use the same template name"
-      ],
-      [
-        "p",
-        "path <string>",
-        "relative path in the workspace. by default the path is `<scope>/<namespace>/<name>`"
+        "l",
+        "list",
+        "list all insights"
       ],
       [
-        "e",
-        "env <string>",
-        "set the component's environment. (overrides the env from variants and the template)"
+        "j",
+        "json",
+        "return the insights in json format"
       ]
     ],
-    "description": "create a new component from a template",
+    "description": "Insights on component graph",
     "extendedDescription": "",
     "group": "development",
-    "private": false
+    "private": true
   },
   {
-    "name": "templates",
+    "name": "component-issues",
     "alias": "",
     "options": [
       [
-        "s",
-        "show-all",
-        "show hidden templates"
+        "j",
+        "json",
+        "json format"
       ]
     ],
-    "description": "list templates for \"bit create\" and \"bit new\"",
-    "extendedDescription": "list components templates when inside bit-workspace (for bit-create), otherwise, list workspace templates (for bit-new)",
+    "description": "list available component-issues",
+    "extendedDescription": "",
     "group": "development",
     "private": false
   },
   {
-    "name": "new <templateName> <workspaceName>",
-    "alias": "",
+    "name": "tag [component-patterns...]",
+    "alias": "t",
     "options": [
       [
-        "a",
-        "aspect <string>",
-        "aspect-id of the template. mandatory for non-core aspects. helpful for core aspects in case of a name collision"
+        "m",
+        "message <message>",
+        "a log message describing latest changes"
       ],
       [
-        "d",
-        "default-scope <string>",
-        "set defaultScope in the new workspace.jsonc"
+        "",
+        "unmodified",
+        "include unmodified components (by default, only new and modified components are tagged)"
       ],
       [
         "",
-        "standalone",
-        "DEPRECATED. use --skip-git instead"
+        "editor [editor]",
+        "EXPERIMENTAL. open an editor to write a tag message for each component. optionally, specify the editor-name (defaults to vim)."
       ],
       [
-        "s",
-        "skip-git",
-        "skip generation of Git repository"
+        "v",
+        "ver <version>",
+        "tag with the given version"
       ],
       [
-        "e",
-        "empty",
-        "empty workspace with no components (relevant for templates that add components by default)"
+        "l",
+        "increment <level>",
+        "options are: [major, premajor, minor, preminor, patch, prepatch, prerelease], default to patch"
       ],
       [
         "",
-        "load-from <string>",
-        "path to the workspace containing the template. helpful during a development of a workspace-template"
-      ]
-    ],
-    "description": "Create a new workspace from a template",
-    "extendedDescription": "",
-    "group": "start",
-    "private": false
-  },
-  {
-    "name": "build [pattern]",
-    "alias": "",
-    "options": [
-      [
-        "a",
-        "all",
-        "build all components, not only modified and new"
-      ],
-      [
-        "d",
-        "dev",
-        "run the pipeline in dev mode"
-      ],
-      [
-        "",
-        "install",
-        "install core aspects in capsules"
-      ],
-      [
-        "",
-        "reuse-capsules",
-        "avoid deleting the capsules root-dir before starting the build"
-      ],
-      [
-        "",
-        "tasks <string>",
-        "build the specified task(s) only. for multiple tasks, separate by a comma and wrap with quotes.\nspecify the task-name (e.g. \"TypescriptCompiler\") or the task-aspect-id (e.g. teambit.compilation/compiler)"
-      ],
-      [
-        "",
-        "cache-packages-on-capsule-root",
-        "set the package-manager cache on the capsule root"
-      ],
-      [
-        "",
-        "list-tasks <string>",
-        "list tasks of an env or a component-id for each one of the pipelines: build, tag and snap"
-      ]
-    ],
-    "description": "run set of tasks for build",
-    "extendedDescription": "",
-    "group": "development",
-    "private": false
-  },
-  {
-    "name": "artifacts <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": "EXPERIMENTAL. list and download components 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
-  },
-  {
-    "name": "pack <componentId> [scopePath]",
-    "alias": "",
-    "options": [
-      [
-        "d",
-        "out-dir <out-dir>",
-        "directory to put the result tar file"
-      ],
-      [
-        "o",
-        "override",
-        "override existing pack file"
-      ],
-      [
-        "k",
-        "keep",
-        "should keep isolated environment [default = false]"
-      ],
-      [
-        "p",
-        "prefix",
-        "keep custom (binding) prefix"
-      ],
-      [
-        "j",
-        "json",
-        "return the output as JSON"
-      ]
-    ],
-    "description": "create tar for npm publish",
-    "extendedDescription": "",
-    "group": "collaborate",
-    "private": false
-  },
-  {
-    "name": "publish <componentId>",
-    "alias": "",
-    "options": [
-      [
-        "d",
-        "dry-run",
-        "npm publish --dry-run"
-      ],
-      [
-        "",
-        "allow-staged",
-        "allow publish components that were not exported yet (not recommended)"
-      ],
-      [
-        "j",
-        "json",
-        "return the output as JSON"
-      ]
-    ],
-    "description": "publish components to npm (npm publish)",
-    "extendedDescription": "",
-    "group": "collaborate",
-    "private": true
-  },
-  {
-    "name": "refactor <sub-command>",
-    "alias": "",
-    "options": [],
-    "description": "EXPERIMENTAL. source code refactoring / codemod",
-    "extendedDescription": "",
-    "group": "development",
-    "private": false,
-    "commands": [
-      {
-        "name": "dependency-name <old-id> <new-id>",
-        "alias": "",
-        "options": [],
-        "description": "replace the dependency's old package-name with a new one in the code",
-        "extendedDescription": "the `<old-id>` and `<new-id>` arguments can be either a component-id or a package-name.",
-        "group": "development",
-        "private": false
-      }
-    ]
-  },
-  {
-    "name": "component-issues",
-    "alias": "",
-    "options": [
-      [
-        "j",
-        "json",
-        "json format"
-      ]
-    ],
-    "description": "list available component-issues",
-    "extendedDescription": "",
-    "group": "development",
-    "private": false
-  },
-  {
-    "name": "insights [names...]",
-    "alias": "",
-    "options": [
-      [
-        "l",
-        "list",
-        "list all insights"
-      ],
-      [
-        "j",
-        "json",
-        "return the insights in json format"
-      ]
-    ],
-    "description": "Insights on component graph",
-    "extendedDescription": "",
-    "group": "development",
-    "private": true
-  },
-  {
-    "name": "tag [id...]",
-    "alias": "t",
-    "options": [
-      [
-        "m",
-        "message <message>",
-        "log message describing the user changes"
-      ],
-      [
-        "",
-        "unmodified",
-        "include unmodified components (by default, only new and modified components are tagged)"
-      ],
-      [
-        "",
-        "editor [editor]",
-        "EXPERIMENTAL. open an editor to edit the tag messages per component, optionally specify the editor-name, default to vim"
-      ],
-      [
-        "v",
-        "ver <version>",
-        "tag with the given version"
+        "prerelease-id <id>",
+        "prerelease identifier (e.g. \"dev\" to get \"1.0.0-dev.1\")"
       ],
       [
         "p",
         "patch",
-        "increment the patch version number"
+        "syntactic sugar for \"--increment patch\""
       ],
       [
         "",
         "minor",
-        "increment the minor version number"
+        "syntactic sugar for \"--increment minor\""
       ],
       [
         "",
         "major",
-        "increment the major version number"
+        "syntactic sugar for \"--increment major\""
+      ],
+      [
+        "",
+        "pre-release [identifier]",
+        "syntactic sugar for \"--increment prerelease\" and `--prerelease-id <identifier>`"
       ],
       [
         "",
         "snapped",
-        "tag components that their head is a snap (not a tag)"
+        "EXPERIMENTAL. tag components that their head is a snap (not a tag)"
       ],
       [
         "",
-        "pre-release [identifier]",
-        "EXPERIMENTAL. increment a pre-release version (e.g. 1.0.0-dev.1)"
+        "unmerged",
+        "EXPERIMENTAL. complete a merge process by tagging the unmerged components"
       ],
       [
         "",
@@ -1893,7 +1559,7 @@
       [
         "i",
         "ignore-issues [issues]",
-        "ignore component issues (shown in \"bit status\" as \"issues found\"), issues to ignore:\n[MissingPackagesDependenciesOnFs, MissingComponents, UntrackedDependencies, ResolveErrors, RelativeComponents, RelativeComponentsAuthored, ParseErrors, MissingLinks, MissingDists, LegacyInsideHarmony, MissingDependenciesOnFs, MissingCustomModuleResolutionLinks, ImportNonMainFiles, CustomModuleResolutionUsed, MultipleEnvs, MissingLinksFromNodeModulesToSrc, CircularDependencies]\nto ignore multiple issues, separate them by a comma and wrap with quotes. to ignore all issues, specify \"*\"."
+        "ignore component issues (shown in \"bit status\" as \"issues found\"), issues to ignore:\n[MissingPackagesDependenciesOnFs, MissingComponents, UntrackedDependencies, ResolveErrors, RelativeComponents, RelativeComponentsAuthored, ParseErrors, MissingDists, LegacyInsideHarmony, MissingDependenciesOnFs, ImportNonMainFiles, CustomModuleResolutionUsed, MultipleEnvs, MissingLinksFromNodeModulesToSrc, CircularDependencies]\nto ignore multiple issues, separate them by a comma and wrap with quotes. to ignore all issues, specify \"*\"."
       ],
       [
         "I",
@@ -1926,26 +1592,43 @@
         "DEPRECATED. use --disable-tag-pipeline instead"
       ]
     ],
-    "description": "record component changes and lock versions",
-    "extendedDescription": "if no ids are provided, it will tag all new and modified components.\nif component ids are entered, you can specify a version per id using \"@\" sign, e.g. bit tag foo@1.0.0 bar@minor baz@major\nhttps://bit.dev/components/tags\nyou can use a pattern for multiple ids, such as bit tag \"utils/*\". (wrap the pattern with quotes to avoid collision with shell commands)",
+    "description": "create an immutable and exportable component snapshot, tagged with a release version.",
+    "extendedDescription": "if no patterns are provided, it will tag all new and modified components.\nif patterns are entered, you can specify a version per pattern using \"@\" sign, e.g. bit tag foo@1.0.0 bar@minor baz@major",
     "group": "development",
     "private": false,
-    "remoteOp": true
+    "remoteOp": true,
+    "arguments": [
+      {
+        "name": "component-patterns...",
+        "description": "a list of component names, IDs or patterns (separated by space). run \"bit pattern --help\" to get more data about patterns. By default, all modified are tagged."
+      }
+    ],
+    "examples": [
+      {
+        "cmd": "tag --ver 1.0.0",
+        "description": "tag all components to version 1.0.0"
+      }
+    ]
   },
   {
-    "name": "snap [id]",
+    "name": "snap [component-pattern]",
     "alias": "",
     "options": [
       [
         "m",
         "message <message>",
-        "log message describing the user changes"
+        "log message describing the latest changes"
       ],
       [
         "",
         "unmodified",
         "include unmodified components (by default, only new and modified components are snapped)"
       ],
+      [
+        "",
+        "unmerged",
+        "EXPERIMENTAL. complete a merge process by snapping the unmerged components"
+      ],
       [
         "",
         "build",
@@ -1974,7 +1657,7 @@
       [
         "i",
         "ignore-issues [issues]",
-        "ignore component issues (shown in \"bit status\" as \"issues found\"), issues to ignore:\n[MissingPackagesDependenciesOnFs, MissingComponents, UntrackedDependencies, ResolveErrors, RelativeComponents, RelativeComponentsAuthored, ParseErrors, MissingLinks, MissingDists, LegacyInsideHarmony, MissingDependenciesOnFs, MissingCustomModuleResolutionLinks, ImportNonMainFiles, CustomModuleResolutionUsed, MultipleEnvs, MissingLinksFromNodeModulesToSrc, CircularDependencies]\nto ignore multiple issues, separate them by a comma and wrap with quotes. to ignore all issues, specify \"*\"."
+        "ignore component issues (shown in \"bit status\" as \"issues found\"), issues to ignore:\n[MissingPackagesDependenciesOnFs, MissingComponents, UntrackedDependencies, ResolveErrors, RelativeComponents, RelativeComponentsAuthored, ParseErrors, MissingDists, LegacyInsideHarmony, MissingDependenciesOnFs, ImportNonMainFiles, CustomModuleResolutionUsed, MultipleEnvs, MissingLinksFromNodeModulesToSrc, CircularDependencies]\nto ignore multiple issues, separate them by a comma and wrap with quotes. to ignore all issues, specify \"*\"."
       ],
       [
         "a",
@@ -1987,10 +1670,56 @@
         "DEPRECATED (use \"--skip-tests\" or \"--unmodified\" instead). force-snap even if tests are failing and even when component has not changed"
       ]
     ],
-    "description": "record component changes.\nhttps://bit.dev/components/snaps\nyou can use a pattern for multiple ids, such as bit snap \"utils/*\". (wrap the pattern with quotes to avoid collision with shell commands)",
-    "extendedDescription": "",
+    "description": "EXPERIMENTAL. create an immutable and exportable component snapshot (no release version)",
+    "extendedDescription": "https://bit.dev/components/snaps\nyou can use a pattern for multiple ids, such as bit snap \"utils/*\". (wrap the pattern with quotes to avoid collision with shell commands)",
     "group": "ungrouped",
-    "private": true
+    "private": true,
+    "arguments": [
+      {
+        "name": "component-pattern",
+        "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes. By default, all new and modified components are snapped."
+      }
+    ]
+  },
+  {
+    "name": "reset [component-pattern]",
+    "alias": "",
+    "options": [
+      [
+        "a",
+        "all",
+        "revert tag/snap for all tagged/snapped components"
+      ],
+      [
+        "",
+        "head",
+        "revert the head tag/snap only (by default, all local tags/snaps are reverted)"
+      ],
+      [
+        "",
+        "soft",
+        "revert only soft-tags (components tagged with --soft flag)"
+      ],
+      [
+        "f",
+        "force",
+        "revert the tag even if used as a dependency. WARNING: components that depend on this tag will corrupt"
+      ]
+    ],
+    "description": "revert tagged or snapped versions for component(s)",
+    "extendedDescription": "https://bit.dev/docs/components/tags#undoing-a-tag",
+    "group": "development",
+    "private": false,
+    "arguments": [
+      {
+        "name": "component-pattern",
+        "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
+      },
+      {
+        "name": "component-version",
+        "description": "the version to untag (semver for tags. hash for snaps)"
+      }
+    ]
   },
   {
     "name": "merge [values...]",
@@ -2031,474 +1760,152 @@
         "build",
         "in case of snap during the merge, run the build-pipeline (similar to bit snap --build)"
       ],
-      [
-        "m",
-        "message <message>",
-        "EXPERIMENTAL. override the default message for the auto snap"
-      ]
-    ],
-    "description": "merge changes of different component versions",
-    "extendedDescription": "merge changes of different component versions\n  `bit merge <version> [ids...]` => merge changes of the given version into the checked out version\n  `bit merge [ids...]` => EXPERIMENTAL. merge changes of the remote head into local, optionally use '--abort' or '--resolve'\n  you can use a pattern for multiple ids, such as bit merge 0.0.1 \"utils/*\". (wrap the pattern with quotes to avoid collision with shell commands)",
-    "group": "development",
-    "private": false
-  },
-  {
-    "name": "status",
-    "alias": "s",
-    "options": [
-      [
-        "j",
-        "json",
-        "return a json version of the component"
-      ],
       [
         "",
-        "strict",
-        "in case issues found, exit with code 1"
-      ]
-    ],
-    "description": "show the working area component(s) status",
-    "extendedDescription": "https://bit.dev/docs/workspace/workspace-status",
-    "group": "development",
-    "private": false
-  },
-  {
-    "name": "compile [component...]",
-    "alias": "",
-    "options": [
-      [
-        "c",
-        "changed",
-        "compile only new and modified components"
-      ],
-      [
-        "v",
         "verbose",
-        "show more data, such as, dist paths"
+        "show details of components that were not merged legitimately"
       ],
       [
-        "j",
-        "json",
-        "return the compile results in json format"
+        "",
+        "skip-dependency-installation",
+        "do not install packages of the imported components"
       ],
       [
-        "d",
-        "delete-dist-dir",
-        "delete existing dist folder before writing new compiled files"
+        "m",
+        "message <message>",
+        "EXPERIMENTAL. override the default message for the auto snap"
       ]
     ],
-    "description": "compile components in the development workspace",
-    "extendedDescription": "",
+    "description": "merge changes of different component versions",
+    "extendedDescription": "merge changes of different component versions\n  `bit merge <version> [ids...]` => merge changes of the given version into the checked out version\n  `bit merge [ids...]` => EXPERIMENTAL. merge changes of the remote head into local, optionally use '--abort' or '--resolve'\n  you can use a pattern for multiple ids, such as bit merge 0.0.1 \"utils/*\". (wrap the pattern with quotes to avoid collision with shell commands)",
     "group": "development",
     "private": false
   },
   {
-    "name": "run <app>",
-    "alias": "c",
+    "name": "lane [lane-name]",
+    "alias": "",
     "options": [
       [
         "d",
-        "dev",
-        "start the application in dev mode."
-      ],
-      [
-        "v",
-        "verbose",
-        "showing verbose output for inspection and prints stack trace"
+        "details",
+        "show more details on the state of each component in each lane"
       ],
-      [
-        "",
-        "skip-watch",
-        "avoid running the watch process that compiles components in the background"
-      ]
-    ],
-    "description": "run an application",
-    "extendedDescription": "",
-    "group": "apps",
-    "private": false
-  },
-  {
-    "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": "",
-    "options": [],
-    "description": "manage applications",
-    "extendedDescription": "",
-    "group": "apps",
-    "private": false,
-    "commands": [
-      {
-        "name": "list",
-        "alias": "",
-        "options": [
-          [
-            "j",
-            "json",
-            "return the component data in json format"
-          ]
-        ],
-        "description": "list all registered applications",
-        "extendedDescription": "",
-        "group": "apps",
-        "private": false
-      }
-    ]
-  },
-  {
-    "name": "test [pattern]",
-    "alias": "at",
-    "options": [
-      [
-        "w",
-        "watch",
-        "start the tester in watch mode."
-      ],
-      [
-        "d",
-        "debug",
-        "start the tester in debug mode."
-      ],
-      [
-        "a",
-        "all",
-        "test all components, not only new and modified"
+        "show lanes details in json format"
       ],
       [
-        "",
-        "junit <filepath>",
-        "write tests results as JUnit XML format into the specified file path"
+        "r",
+        "remote <string>",
+        "show remote lanes"
       ],
       [
         "",
-        "coverage",
-        "show code coverage data"
-      ],
-      [
-        "e",
-        "env <id>",
-        "test only the given env"
-      ],
-      [
-        "s",
-        "scope <scope>",
-        "name of the scope to test"
-      ]
-    ],
-    "description": "test set of components in your workspace",
-    "extendedDescription": "",
-    "group": "development",
-    "private": false
-  },
-  {
-    "name": "schema <pattern>",
-    "alias": "",
-    "options": [
-      [
-        "j",
-        "json",
-        "return the component data in json format"
-      ]
-    ],
-    "description": "shows the API schema of a certain component.",
-    "extendedDescription": "you can use a `<pattern>` for multiple component ids, such as `bit schema \"org.scope/utils/**\"`. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nto validate the pattern before running this command, run `bit pattern <pattern>`.\n",
-    "group": "development",
-    "private": false
-  },
-  {
-    "name": "check-types [pattern]",
-    "alias": "",
-    "options": [
-      [
-        "a",
-        "all",
-        "check-types for all components, not only modified and new"
+        "merged",
+        "show merged lanes"
       ],
       [
         "",
-        "strict",
-        "in case issues found, exit with code 1"
+        "not-merged",
+        "show not merged lanes"
       ]
     ],
-    "description": "check typescript types",
-    "extendedDescription": "",
-    "group": "development",
-    "private": false
-  },
-  {
-    "name": "aspect <sub-command>",
-    "alias": "",
-    "options": [],
-    "description": "EXPERIMENTAL. manage aspects",
+    "description": "show lanes details\nhttps://bit.dev/docs/components/lanes",
     "extendedDescription": "",
-    "group": "development",
-    "private": false,
+    "group": "ungrouped",
+    "private": true,
+    "remoteOp": true,
+    "skipWorkspace": true,
     "commands": [
       {
-        "name": "list [pattern]",
+        "name": "list",
         "alias": "",
         "options": [
           [
             "d",
-            "debug",
-            "show the origins were the aspects were taken from"
+            "details",
+            "show more details on the state of each component in each lane"
+          ],
+          [
+            "j",
+            "json",
+            "show lanes details in a json format"
+          ],
+          [
+            "r",
+            "remote <remote-scope-name>",
+            "show remote lanes"
+          ],
+          [
+            "",
+            "merged",
+            "show merged lanes"
+          ],
+          [
+            "",
+            "not-merged",
+            "show lanes that are not merged"
           ]
         ],
-        "description": "list all aspects configured on component(s)",
-        "extendedDescription": "you can use a `<pattern>` for multiple component ids, such as `bit aspect list \"org.scope/utils/**\"`. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nto validate the pattern before running this command, run `bit pattern <pattern>`.\n",
-        "group": "development",
-        "private": false
+        "description": "list lanes",
+        "extendedDescription": "",
+        "group": "ungrouped",
+        "private": true,
+        "remoteOp": true,
+        "skipWorkspace": true
       },
       {
-        "name": "get <component-id>",
+        "name": "switch <lane>",
         "alias": "",
         "options": [
           [
-            "d",
-            "debug",
-            "show the origins were the aspects were taken from"
+            "n",
+            "alias <string>",
+            "relevant when the specified lane is a remote late. name a local lane differently than the remote lane"
+          ],
+          [
+            "m",
+            "merge [strategy]",
+            "merge local changes with the checked out version. strategy should be \"theirs\", \"ours\" or \"manual\""
+          ],
+          [
+            "a",
+            "get-all",
+            "checkout all components in a lane include ones that do not exist in the workspace"
+          ],
+          [
+            "",
+            "skip-dependency-installation",
+            "do not install packages of the imported components"
           ],
           [
             "j",
             "json",
-            "format as json"
+            "return the output as JSON"
           ]
         ],
-        "description": "show aspects' data and configuration of the given component",
+        "description": "switch to the specified lane",
         "extendedDescription": "",
-        "group": "development",
-        "private": false
+        "group": "ungrouped",
+        "private": true
       },
       {
-        "name": "set <pattern> <aspect-id> [config]",
-        "alias": "",
-        "options": [],
-        "description": "set an aspect to component(s) with optional config.",
-        "extendedDescription": "enter the config as stringified JSON (e.g. '{\"foo\":\"bar\"}' ).\nif no config entered, the aspect will be set with empty config ({}).\nyou can use a `<pattern>` for multiple component ids, such as `bit aspect set \"org.scope/utils/**\"`. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nto validate the pattern before running this command, run `bit pattern <pattern>`.\n",
-        "group": "development",
-        "private": false
-      },
-      {
-        "name": "unset <pattern> <aspect-id>",
-        "alias": "",
-        "options": [],
-        "description": "unset an aspect from component(s).",
-        "extendedDescription": "you can use a `<pattern>` for multiple component ids, such as `bit aspect unset \"org.scope/utils/**\"`. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nto validate the pattern before running this command, run `bit pattern <pattern>`.\n",
-        "group": "development",
-        "private": false
-      },
-      {
-        "name": "update <aspect-id> [pattern]",
-        "alias": "",
-        "options": [],
-        "description": "update a version of an aspect",
-        "extendedDescription": "default to all components using the aspect, unless \"pattern\" is provided.\nyou can use a `<pattern>` for multiple component ids, such as `bit aspect update <aspect-id> \"org.scope/utils/**\"`. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nto validate the pattern before running this command, run `bit pattern <pattern>`.\n\nexamples:\n\"bit aspect update scope.org/aspect '**/ui/**'\" - update \"ui\" components that use scope.org/aspect to the latest version\n\"bit aspect update scope.org/aspect@2.0.0\"      - updates all components using scope.org/aspect to version 2.0.0.",
-        "group": "development",
-        "private": false
-      }
-    ]
-  },
-  {
-    "name": "clear-cache",
-    "alias": "cc",
-    "options": [
-      [
-        "r",
-        "remote <remote-name>",
-        "clear memory cache from a remote scope"
-      ]
-    ],
-    "description": "clears Bit's cache from current working machine",
-    "extendedDescription": "The following gets removed by this command:\n1) V8 compiled code (generated the first time Bit is loaded by v8-compile-cache package)\n2) components cache on the filesystem (mainly the dependencies graph and docs)\n3) scope's index file, which maps the component-id:object-hash\nhttps://bit.dev/docs/workspace/clearing-cache",
-    "group": "general",
-    "private": false,
-    "skipWorkspace": true
-  },
-  {
-    "name": "log <id>",
-    "alias": "",
-    "options": [
-      [
-        "r",
-        "remote",
-        "show log of a remote component"
-      ],
-      [
-        "",
-        "parents",
-        "EXPERIMENTAL. show parents and lanes data"
-      ]
-    ],
-    "description": "show components(s) version history",
-    "extendedDescription": "https://bit.dev/docs/reference/cli-reference#log",
-    "group": "info",
-    "private": false,
-    "remoteOp": true,
-    "skipWorkspace": true
-  },
-  {
-    "name": "deprecate <id>",
-    "alias": "d",
-    "options": [
-      [
-        "",
-        "new-id <string>",
-        "if replaced by another component, enter the new component id"
-      ]
-    ],
-    "description": "deprecate a component",
-    "extendedDescription": "",
-    "group": "collaborate",
-    "private": false,
-    "remoteOp": true,
-    "skipWorkspace": true
-  },
-  {
-    "name": "undeprecate <id>",
-    "alias": "",
-    "options": [],
-    "description": "undeprecate a deprecated component (local/remote)",
-    "extendedDescription": "",
-    "group": "collaborate",
-    "private": false,
-    "remoteOp": true,
-    "skipWorkspace": true
-  },
-  {
-    "name": "rename <source-name> <target-name>",
-    "alias": "",
-    "options": [
-      [
-        "s",
-        "scope <string>",
-        "default scope for the newly created component"
-      ],
-      [
-        "p",
-        "path <string>",
-        "relative path in the workspace. by default the path is `<scope>/<namespace>/<name>`"
-      ],
-      [
-        "r",
-        "refactor",
-        "change the source code of all components using this component with the new package-name"
-      ]
-    ],
-    "description": "EXPERIMENTAL. rename component. if tagged/exported, create a new component and deprecate the source-component",
-    "extendedDescription": "the `<target-name>` should include the component-name only, without the scope-name.\nto assign a default-scope to this component, please use \"--scope\" flag",
-    "group": "collaborate",
-    "private": false,
-    "remoteOp": true,
-    "skipWorkspace": true
-  },
-  {
-    "name": "fork <source-id> [target-name]",
-    "alias": "",
-    "options": [
-      [
-        "s",
-        "scope <string>",
-        "default scope for the newly created component"
-      ],
-      [
-        "p",
-        "path <string>",
-        "relative path in the workspace. by default the path is `<scope>/<namespace>/<name>`"
-      ],
-      [
-        "r",
-        "refactor",
-        "change the source code of all components using the original component with the new package-name"
-      ]
-    ],
-    "description": "EXPERIMENTAL. create a new component out of an existing one",
-    "extendedDescription": "note that [target-name] is the name only without the scope.\nto set the default-scope, please use --scope flag",
-    "group": "collaborate",
-    "private": false,
-    "remoteOp": true,
-    "skipWorkspace": true
-  },
-  {
-    "name": "lane [name]",
-    "alias": "",
-    "options": [
-      [
-        "d",
-        "details",
-        "show more details on the state of each component in each lane"
-      ],
-      [
-        "j",
-        "json",
-        "show lanes details in json format"
-      ],
-      [
-        "r",
-        "remote <string>",
-        "show remote lanes"
-      ],
-      [
-        "",
-        "merged",
-        "show merged lanes"
-      ],
-      [
-        "",
-        "not-merged",
-        "show not merged lanes"
-      ]
-    ],
-    "description": "show lanes details\nhttps://bit.dev/docs/components/lanes",
-    "extendedDescription": "",
-    "group": "ungrouped",
-    "private": true,
-    "remoteOp": true,
-    "skipWorkspace": true,
-    "commands": [
-      {
-        "name": "list",
+        "name": "show <lane-name>",
         "alias": "",
         "options": [
-          [
-            "d",
-            "details",
-            "show more details on the state of each component in each lane"
-          ],
           [
             "j",
             "json",
-            "show lanes details in json format"
+            "show the lane details in json format"
           ],
           [
             "r",
             "remote <string>",
             "show remote lanes"
-          ],
-          [
-            "",
-            "merged",
-            "show merged lanes"
-          ],
-          [
-            "",
-            "not-merged",
-            "show not merged lanes"
           ]
         ],
-        "description": "list lanes",
+        "description": "show lane details",
         "extendedDescription": "",
         "group": "ungrouped",
         "private": true,
@@ -2506,93 +1913,163 @@
         "skipWorkspace": true
       },
       {
-        "name": "switch <lane>",
+        "name": "create <lane-name>",
         "alias": "",
         "options": [
-          [
-            "n",
-            "alias <string>",
-            "relevant when the specified lane is a remote late. name a local lane differently than the remote lane"
-          ],
-          [
-            "m",
-            "merge [strategy]",
-            "merge local changes with the checked out version. strategy should be \"theirs\", \"ours\" or \"manual\""
-          ],
-          [
-            "a",
-            "get-all",
-            "checkout all components in a lane include ones that do not exist in the workspace"
-          ],
           [
             "",
-            "skip-dependency-installation",
-            "do not install packages of the imported components"
+            "remote-scope <scope-name>",
+            "remote scope where this lane will be exported to, default to the defaultScope (can be changed later with \"bit lane change-scope\")"
           ],
           [
-            "j",
-            "json",
-            "return the output as JSON"
+            "",
+            "alias <name>",
+            "a local alias to refer to this lane, defaults to the <lane-name> (can be added later with \"bit lane alias\")"
           ]
         ],
-        "description": "switch to the specified lane",
-        "extendedDescription": "",
+        "description": "creates a new lane and switches to it",
+        "extendedDescription": "a lane created from main (default-lane) is empty until components are snapped.\na lane created from another lane has all the components of the original lane.",
         "group": "ungrouped",
-        "private": true
+        "private": true,
+        "arguments": [
+          {
+            "name": "lane-name",
+            "description": "the name for the new lane"
+          }
+        ]
       },
       {
-        "name": "show <name>",
+        "name": "remove <lanes...>",
         "alias": "",
         "options": [
           [
-            "j",
-            "json",
-            "show the lane details in json format"
+            "r",
+            "remote",
+            "remove a remote lane (in the lane arg, use remote/lane-id syntax)"
           ],
           [
-            "r",
-            "remote <string>",
-            "show remote lanes"
+            "f",
+            "force",
+            "removes the component from the scope, even if used as a dependency. WARNING: components that depend on this component will corrupt"
+          ],
+          [
+            "s",
+            "silent",
+            "skip confirmation"
           ]
         ],
-        "description": "show lane details",
+        "description": "remove lanes",
         "extendedDescription": "",
         "group": "ungrouped",
         "private": true,
-        "remoteOp": true,
-        "skipWorkspace": true
+        "arguments": [
+          {
+            "name": "lanes...",
+            "description": "A list of lane names, separated by spaces"
+          }
+        ]
       },
       {
-        "name": "create <name>",
+        "name": "change-scope <lane-name> <remote-scope-name>",
         "alias": "",
-        "options": [
-          [
-            "",
-            "remote-scope <string>",
-            "remote scope where this lane will be exported to, default to the defaultScope (can be changed later with \"bit lane change-scope\")"
-          ],
-          [
-            "",
-            "alias <string>",
-            "a local alias to refer to this lane, default to the <name> (can be added later with \"bit lane alias\")"
-          ]
-        ],
-        "description": "create and switch to a new lane",
-        "extendedDescription": "a lane created from main (default-lane) is empty until components are snapped.\na lane created from another lane has all the components of the original lane.",
+        "options": [],
+        "description": "changes the remote scope of a lane",
+        "extendedDescription": "",
         "group": "ungrouped",
         "private": true
       },
       {
-        "name": "merge <lane>",
+        "name": "alias <lane-name> <alias>",
         "alias": "",
-        "options": [
-          [
-            "",
-            "remote <name>",
-            "remote scope name"
-          ],
-          [
-            "",
+        "options": [],
+        "description": "adds an alias to a lane",
+        "extendedDescription": "an alias is a name that can be used to refer to a lane. it is saved locally and never reach the remote.\nit is useful when having multiple lanes with the same name, but with different remote scopes.",
+        "group": "ungrouped",
+        "private": true
+      },
+      {
+        "name": "rename <current-name> <new-name>",
+        "alias": "",
+        "options": [],
+        "description": "EXPERIMENTAL. change the lane-name locally and on the remote (if exported)",
+        "extendedDescription": "",
+        "group": "ungrouped",
+        "private": true
+      },
+      {
+        "name": "diff [values...]",
+        "alias": "",
+        "options": [
+          [
+            "",
+            "pattern <component-pattern>",
+            "EXPERIMENTAL. show lane-diff for the specified component-pattern only"
+          ]
+        ],
+        "description": "show diff between lanes",
+        "extendedDescription": "bit lane diff => diff between the current lane and default lane. (only inside workspace).\nbit lane diff to => diff between the current lane (or default-lane when in scope) and \"to\" lane.\nbit lane diff from to => diff between \"from\" lane and \"to\" lane.",
+        "group": "ungrouped",
+        "private": true,
+        "remoteOp": true,
+        "skipWorkspace": true
+      },
+      {
+        "name": "add-readme <component-name> [lane-name]",
+        "alias": "",
+        "options": [],
+        "description": "EXPERIMENTAL. adds a readme component to a lane",
+        "extendedDescription": "",
+        "group": "ungrouped",
+        "private": true,
+        "skipWorkspace": false,
+        "arguments": [
+          {
+            "name": "component-id",
+            "description": "the component name or id of the component to use as the lane's readme"
+          },
+          {
+            "name": "lane-name",
+            "description": "the lane to attach the readme to (defaults to the current lane)"
+          }
+        ]
+      },
+      {
+        "name": "remove-readme [laneName]",
+        "alias": "",
+        "options": [],
+        "description": "EXPERIMENTAL. remove lane readme component",
+        "extendedDescription": "",
+        "group": "ungrouped",
+        "private": true,
+        "skipWorkspace": false
+      },
+      {
+        "name": "import <lane>",
+        "alias": "",
+        "options": [
+          [
+            "",
+            "skip-dependency-installation",
+            "do not install packages of the imported components"
+          ]
+        ],
+        "description": "import a remote lane to your workspace",
+        "extendedDescription": "",
+        "group": "ungrouped",
+        "private": true,
+        "arguments": [
+          {
+            "name": "lane",
+            "description": "the remote lane name"
+          }
+        ]
+      },
+      {
+        "name": "merge <lane> [pattern]",
+        "alias": "",
+        "options": [
+          [
+            "",
             "ours",
             "in case of a conflict, override the used version with the current modification"
           ],
@@ -2608,8 +2085,8 @@
           ],
           [
             "",
-            "existing",
-            "checkout only components in a lane that exist in the workspace"
+            "workspace",
+            "merge only components in a lane that exist in the workspace"
           ],
           [
             "",
@@ -2630,151 +2107,1176 @@
             "",
             "keep-readme",
             "skip deleting the lane readme component after merging"
+          ],
+          [
+            "",
+            "no-squash",
+            "EXPERIMENTAL. relevant for merging lanes into main, which by default squash."
+          ],
+          [
+            "",
+            "verbose",
+            "show details of components that were not merged legitimately"
+          ],
+          [
+            "",
+            "skip-dependency-installation",
+            "do not install packages of the imported components"
+          ],
+          [
+            "",
+            "remote",
+            "relevant when the target-lane locally is differ than the remote and you want the remote"
+          ],
+          [
+            "",
+            "include-deps",
+            "EXPERIMENTAL. relevant for \"--pattern\" and \"--workspace\". merge also dependencies of the given components"
+          ],
+          [
+            "",
+            "resolve-unrelated [merge-strategy]",
+            "EXPERIMENTAL. relevant when a component on a lane and the component on main has nothing in common. merge-strategy can be \"ours\" (default) or \"theirs\""
+          ]
+        ],
+        "description": "merge a local or a remote lane",
+        "extendedDescription": "if the <lane> exists locally, it will be merged from the local lane.\notherwise, it will fetch the lane from the remote and merge it.\nin case the <lane> exists locally but you want to merge the remote version of it, use --remote flag",
+        "private": true,
+        "remoteOp": true,
+        "arguments": [
+          {
+            "name": "lane",
+            "description": "lane-name or lane-id (if not exists locally) to merge to the current lane"
+          },
+          {
+            "name": "pattern",
+            "description": "EXPERIMENTAL. partially merge the lane with the specified component-pattern"
+          }
+        ]
+      }
+    ]
+  },
+  {
+    "name": "switch <lane>",
+    "alias": "",
+    "options": [
+      [
+        "n",
+        "alias <string>",
+        "relevant when the specified lane is a remote late. name a local lane differently than the remote lane"
+      ],
+      [
+        "m",
+        "merge [strategy]",
+        "merge local changes with the checked out version. strategy should be \"theirs\", \"ours\" or \"manual\""
+      ],
+      [
+        "a",
+        "get-all",
+        "checkout all components in a lane include ones that do not exist in the workspace"
+      ],
+      [
+        "",
+        "skip-dependency-installation",
+        "do not install packages of the imported components"
+      ],
+      [
+        "j",
+        "json",
+        "return the output as JSON"
+      ]
+    ],
+    "description": "switch to the specified lane",
+    "extendedDescription": "",
+    "group": "ungrouped",
+    "private": true
+  },
+  {
+    "name": "dependencies <sub-command>",
+    "alias": "deps",
+    "options": [],
+    "description": "manage dependencies",
+    "extendedDescription": "",
+    "group": "info",
+    "private": false,
+    "commands": [
+      {
+        "name": "get <component-name>",
+        "alias": "",
+        "options": [
+          [
+            "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": [],
+        "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.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
+          },
+          {
+            "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"
+          ],
+          [
+            "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.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
+          },
+          {
+            "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": "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",
+        "show latest versions from remotes"
+      ],
+      [
+        "j",
+        "json",
+        "show the output in JSON format"
+      ],
+      [
+        "n",
+        "namespace <string>",
+        "show only specified namespace by using wildcards"
+      ]
+    ],
+    "description": "list components on a workspace, local scope or a remote scope.",
+    "extendedDescription": "https://bit.dev/docs/reference/cli-reference#list",
+    "group": "discover",
+    "private": false,
+    "remoteOp": true,
+    "skipWorkspace": true
+  },
+  {
+    "name": "import [component-patterns...]",
+    "alias": "",
+    "options": [
+      [
+        "p",
+        "path <path>",
+        "import components into a specific directory (a relative path in the workspace)"
+      ],
+      [
+        "o",
+        "objects",
+        "import components objects to the local scope without checkout (without writing them to the file system). This is a default behavior for import with no id argument"
+      ],
+      [
+        "d",
+        "display-dependencies",
+        "display the imported dependencies"
+      ],
+      [
+        "O",
+        "override",
+        "override local changes"
+      ],
+      [
+        "v",
+        "verbose",
+        "show verbose output for inspection"
+      ],
+      [
+        "j",
+        "json",
+        "return the output as JSON"
+      ],
+      [
+        "",
+        "conf",
+        "write the configuration file (component.json) of the component"
+      ],
+      [
+        "",
+        "skip-npm-install",
+        "DEPRECATED. use \"--skip-dependency-installation\" instead"
+      ],
+      [
+        "",
+        "skip-dependency-installation",
+        "do not install packages of the imported components"
+      ],
+      [
+        "m",
+        "merge [strategy]",
+        "merge local changes with the imported version. strategy should be \"theirs\", \"ours\" or \"manual\""
+      ],
+      [
+        "",
+        "dependencies",
+        "EXPERIMENTAL. import all dependencies and write them to the workspace"
+      ],
+      [
+        "",
+        "dependents",
+        "EXPERIMENTAL. import the components' dependents. this enables changes to propagate from (modified) components to their dependents"
+      ],
+      [
+        "",
+        "save-in-lane",
+        "EXPERIMENTAL. when checked out to a lane and the component is not on the remote-lane, save it in the lane (default to save on main)"
+      ],
+      [
+        "",
+        "all-history",
+        "relevant for fetching all components objects. avoid optimizations, fetch all history versions, always"
+      ]
+    ],
+    "description": "import components from their remote scopes to the local workspace",
+    "extendedDescription": "https://bit.dev/docs/components/importing-components\nyou can use a pattern for multiple ids, such as bit import \"utils/*\". (wrap the pattern with quotes to avoid collision with shell commands)",
+    "group": "collaborate",
+    "private": false,
+    "remoteOp": true,
+    "arguments": [
+      {
+        "name": "component-patterns...",
+        "description": "component IDs or component patterns (separated by space). Use patterns to import groups of components using a common scope or namespace. E.g., \"utils/*\" (wrap with double quotes)"
+      }
+    ]
+  },
+  {
+    "name": "create <template-name> <component-names...>",
+    "alias": "",
+    "options": [
+      [
+        "n",
+        "namespace <string>",
+        "sets the component's namespace and nested dirs inside the scope"
+      ],
+      [
+        "s",
+        "scope <string>",
+        "sets the component's scope-name. if not entered, the default-scope will be used"
+      ],
+      [
+        "a",
+        "aspect <string>",
+        "aspect-id of the template. helpful when multiple aspects use the same template name"
+      ],
+      [
+        "p",
+        "path <string>",
+        "relative path in the workspace. by default the path is `<scope>/<namespace>/<name>`"
+      ],
+      [
+        "e",
+        "env <string>",
+        "set the component's environment. (overrides the env from variants and the template)"
+      ]
+    ],
+    "description": "create a new component (source files and config) using a template.",
+    "extendedDescription": "",
+    "group": "development",
+    "private": false,
+    "arguments": [
+      {
+        "name": "template-name",
+        "description": "the template for generating the component \n(run 'bit templates' for a list of available templates)"
+      },
+      {
+        "name": "component-names...",
+        "description": "a list of component names to generate"
+      }
+    ],
+    "examples": [
+      {
+        "cmd": "bit create react ui/button",
+        "description": "creates a component named 'ui/button' using the 'react' template"
+      },
+      {
+        "cmd": "bit create react ui/button pages/register",
+        "description": "creates two components, 'ui/button' and 'pages/register', using the 'react' template"
+      },
+      {
+        "cmd": "bit create react ui/button --scope my-org.my-scope",
+        "description": "creates a component named 'ui/button' and sets it scope to 'my-org.my-scope'. \nby default, the scope is the `defaultScope` value, configured in your `workspace.jsonc`."
+      },
+      {
+        "cmd": "bit create react ui/button --env teambit.community/envs/community-react@1.95.13",
+        "description": "creates a component named 'ui/button' and sets it to use the 'community-react' env. \n(the template's default env is 'teambit.react/react')."
+      }
+    ]
+  },
+  {
+    "name": "templates",
+    "alias": "",
+    "options": [
+      [
+        "s",
+        "show-all",
+        "show hidden templates"
+      ]
+    ],
+    "description": "list templates for \"bit create\" and \"bit new\"",
+    "extendedDescription": "list components templates when inside bit-workspace (for bit-create), otherwise, list workspace templates (for bit-new)",
+    "group": "development",
+    "private": false
+  },
+  {
+    "name": "new <template-name> <workspace-name>",
+    "alias": "",
+    "options": [
+      [
+        "a",
+        "aspect <aspect-id>",
+        "aspect-id of the template. mandatory for non-core aspects. helpful for core aspects in case of a name collision"
+      ],
+      [
+        "d",
+        "default-scope <scope-name>",
+        "set defaultScope in the new workspace.jsonc"
+      ],
+      [
+        "",
+        "standalone",
+        "DEPRECATED. use --skip-git instead"
+      ],
+      [
+        "s",
+        "skip-git",
+        "skip generation of Git repository"
+      ],
+      [
+        "e",
+        "empty",
+        "empty workspace with no components (relevant for templates that add components by default)"
+      ],
+      [
+        "",
+        "load-from <path-to-template>",
+        "path to the workspace containing the template. helpful during a development of a workspace-template"
+      ]
+    ],
+    "description": "create a new workspace from a template",
+    "extendedDescription": "",
+    "group": "start",
+    "private": false,
+    "arguments": [
+      {
+        "name": "template-name",
+        "description": "the name of the workspace template (run 'bit templates', outside of a workspace, to get a list of available templates)"
+      },
+      {
+        "name": "workspace-name",
+        "description": "the name for the new workspace and workspace directory"
+      }
+    ]
+  },
+  {
+    "name": "build [component-pattern]",
+    "alias": "",
+    "options": [
+      [
+        "a",
+        "all",
+        "build all components, not only modified and new"
+      ],
+      [
+        "d",
+        "dev",
+        "run the pipeline in dev mode"
+      ],
+      [
+        "",
+        "install",
+        "install core aspects in capsules"
+      ],
+      [
+        "",
+        "reuse-capsules",
+        "avoid deleting the capsules root-dir before starting the build"
+      ],
+      [
+        "",
+        "tasks <string>",
+        "build the specified task(s) only. for multiple tasks, separate by a comma and wrap with quotes.\nspecify the task-name (e.g. \"TypescriptCompiler\") or the task-aspect-id (e.g. teambit.compilation/compiler)"
+      ],
+      [
+        "",
+        "cache-packages-on-capsule-root",
+        "set the package-manager cache on the capsule root"
+      ],
+      [
+        "",
+        "list-tasks <string>",
+        "list tasks of an env or a component-id for each one of the pipelines: build, tag and snap"
+      ]
+    ],
+    "description": "run set of tasks for build",
+    "extendedDescription": "",
+    "group": "development",
+    "private": false,
+    "arguments": [
+      {
+        "name": "component-pattern",
+        "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
+      }
+    ]
+  },
+  {
+    "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": "EXPERIMENTAL. list and download components 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.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
+      }
+    ]
+  },
+  {
+    "name": "pack <componentId> [scopePath]",
+    "alias": "",
+    "options": [
+      [
+        "d",
+        "out-dir <out-dir>",
+        "directory to put the result tar file"
+      ],
+      [
+        "o",
+        "override",
+        "override existing pack file"
+      ],
+      [
+        "k",
+        "keep",
+        "should keep isolated environment [default = false]"
+      ],
+      [
+        "p",
+        "prefix",
+        "keep custom (binding) prefix"
+      ],
+      [
+        "j",
+        "json",
+        "return the output as JSON"
+      ]
+    ],
+    "description": "create tar for npm publish",
+    "extendedDescription": "",
+    "group": "collaborate",
+    "private": false
+  },
+  {
+    "name": "publish <component-pattern>",
+    "alias": "",
+    "options": [
+      [
+        "d",
+        "dry-run",
+        "npm publish --dry-run"
+      ],
+      [
+        "",
+        "allow-staged",
+        "allow publish components that were not exported yet (not recommended)"
+      ],
+      [
+        "j",
+        "json",
+        "return the output as JSON"
+      ]
+    ],
+    "description": "publish components to npm (npm publish)",
+    "extendedDescription": "",
+    "group": "collaborate",
+    "private": true,
+    "arguments": [
+      {
+        "name": "component-pattern",
+        "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
+      }
+    ]
+  },
+  {
+    "name": "refactor <sub-command>",
+    "alias": "",
+    "options": [],
+    "description": "EXPERIMENTAL. source code refactoring / codemod",
+    "extendedDescription": "",
+    "group": "development",
+    "private": false,
+    "commands": [
+      {
+        "name": "dependency-name <old-id> <new-id>",
+        "alias": "",
+        "options": [],
+        "description": "replace the dependency's old package-name with a new one in the code",
+        "extendedDescription": "the `<old-id>` and `<new-id>` arguments can be either a component-id or a package-name.",
+        "group": "development",
+        "private": false
+      }
+    ]
+  },
+  {
+    "name": "status",
+    "alias": "s",
+    "options": [
+      [
+        "j",
+        "json",
+        "return a json version of the component"
+      ],
+      [
+        "",
+        "verbose",
+        "show full snap hashes"
+      ],
+      [
+        "",
+        "strict",
+        "in case issues found, exit with code 1"
+      ]
+    ],
+    "description": "present the current status of components in the workspace, and notifies when issues are detected",
+    "extendedDescription": "",
+    "group": "development",
+    "private": false
+  },
+  {
+    "name": "compile [component-names...]",
+    "alias": "",
+    "options": [
+      [
+        "c",
+        "changed",
+        "compile only new and modified components"
+      ],
+      [
+        "v",
+        "verbose",
+        "show more data, such as, dist paths"
+      ],
+      [
+        "j",
+        "json",
+        "return the compile results in json format"
+      ],
+      [
+        "d",
+        "delete-dist-dir",
+        "delete existing dist folder before writing new compiled files"
+      ]
+    ],
+    "description": "compile components in the workspace",
+    "extendedDescription": "",
+    "group": "development",
+    "private": false,
+    "arguments": [
+      {
+        "name": "component-names...",
+        "description": "a list of component names or component IDs (defaults to all components)"
+      }
+    ]
+  },
+  {
+    "name": "run <app-name>",
+    "alias": "c",
+    "options": [
+      [
+        "d",
+        "dev",
+        "start the application in dev mode."
+      ],
+      [
+        "v",
+        "verbose",
+        "showing verbose output for inspection and prints stack trace"
+      ],
+      [
+        "",
+        "skip-watch",
+        "avoid running the watch process that compiles components in the background"
+      ],
+      [
+        "",
+        "ssr",
+        "run app in server side rendering mode."
+      ]
+    ],
+    "description": "run an app (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": "",
+    "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."
+          ],
+          [
+            "v",
+            "verbose",
+            "showing verbose output for inspection and prints stack trace"
+          ],
+          [
+            "",
+            "skip-watch",
+            "avoid running the watch process that compiles components in the background"
+          ],
+          [
+            "",
+            "ssr",
+            "run app in server side rendering mode."
+          ]
+        ],
+        "description": "run an app (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": "test [component-pattern]",
+    "alias": "at",
+    "options": [
+      [
+        "w",
+        "watch",
+        "start the tester in watch mode."
+      ],
+      [
+        "d",
+        "debug",
+        "start the tester in debug mode."
+      ],
+      [
+        "a",
+        "all",
+        "test all components, not only new and modified"
+      ],
+      [
+        "",
+        "junit <filepath>",
+        "write tests results as JUnit XML format into the specified file path"
+      ],
+      [
+        "",
+        "coverage",
+        "show code coverage data"
+      ],
+      [
+        "e",
+        "env <id>",
+        "test only the given env"
+      ],
+      [
+        "s",
+        "scope <scope-name>",
+        "DEPRECATED. (use the pattern instead, e.g. \"scopeName/**\"). name of the scope to test"
+      ]
+    ],
+    "description": "test components in the workspace",
+    "extendedDescription": "",
+    "group": "development",
+    "private": false,
+    "arguments": [
+      {
+        "name": "component-pattern",
+        "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
+      }
+    ]
+  },
+  {
+    "name": "schema <pattern>",
+    "alias": "",
+    "options": [
+      [
+        "j",
+        "json",
+        "return the component data in json format"
+      ]
+    ],
+    "description": "shows the API schema of a certain component.",
+    "extendedDescription": "you can use a `<pattern>` for multiple component ids, such as `bit schema \"org.scope/utils/**\"`.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nuse `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern.\n",
+    "group": "development",
+    "private": false
+  },
+  {
+    "name": "check-types [component-pattern]",
+    "alias": "",
+    "options": [
+      [
+        "a",
+        "all",
+        "check-types for all components, not only modified and new"
+      ],
+      [
+        "",
+        "strict",
+        "in case issues found, exit with code 1"
+      ]
+    ],
+    "description": "check typescript types",
+    "extendedDescription": "",
+    "group": "development",
+    "private": false,
+    "arguments": [
+      {
+        "name": "component-pattern",
+        "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
+      }
+    ]
+  },
+  {
+    "name": "aspect <sub-command>",
+    "alias": "",
+    "options": [],
+    "description": "EXPERIMENTAL. manage aspects",
+    "extendedDescription": "",
+    "group": "development",
+    "private": false,
+    "commands": [
+      {
+        "name": "list [pattern]",
+        "alias": "",
+        "options": [
+          [
+            "d",
+            "debug",
+            "show the origins were the aspects were taken from"
           ]
         ],
-        "description": "merge a local or a remote lane",
+        "description": "list all aspects configured on component(s)",
         "extendedDescription": "",
-        "group": "ungrouped",
-        "private": true,
-        "remoteOp": true
+        "group": "development",
+        "private": false,
+        "arguments": [
+          {
+            "name": "pattern",
+            "description": "component name, component id, or component pattern. use component pattern to select multiple components. \nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
+          }
+        ]
       },
       {
-        "name": "remove <lane...>",
+        "name": "get <component-name>",
         "alias": "",
         "options": [
           [
-            "r",
-            "remote",
-            "remove a remote lane (in the lane arg, use remote/lane-id syntax)"
-          ],
-          [
-            "f",
-            "force",
-            "removes the component from the scope, even if used as a dependency. WARNING: components that depend on this component will corrupt"
+            "d",
+            "debug",
+            "show the origins were the aspects were taken from"
           ],
           [
-            "s",
-            "silent",
-            "skip confirmation"
+            "j",
+            "json",
+            "format as json"
           ]
         ],
-        "description": "remove lanes",
+        "description": "list the aspects set on a component, as well as their config and data",
         "extendedDescription": "",
-        "group": "ungrouped",
-        "private": true
+        "group": "development",
+        "private": false,
+        "arguments": [
+          {
+            "name": "component-name",
+            "description": "the component name or component id"
+          }
+        ]
       },
       {
-        "name": "change-scope <lane-name> <remote-scope>",
+        "name": "set <pattern> <aspect-id> [config]",
         "alias": "",
-        "options": [],
-        "description": "change the remote scope of a lane",
+        "options": [
+          [
+            "m",
+            "merge",
+            "merge with an existing config if exits. (by default, it replaces the config)"
+          ]
+        ],
+        "description": "set components with an aspect to extend their development tools, metadata and (possibly) artifacts",
         "extendedDescription": "",
-        "group": "ungrouped",
-        "private": true
+        "group": "development",
+        "private": false,
+        "arguments": [
+          {
+            "name": "pattern",
+            "description": "the components to extend. use component name, component id, or component pattern. use component pattern to select multiple components. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\". wrap the pattern with quotes"
+          },
+          {
+            "name": "aspect-id",
+            "description": "the aspect's component id"
+          },
+          {
+            "name": "config",
+            "description": "the aspect config. enter the config as a stringified JSON (e.g. '{\"foo\":\"bar\"}' ). when no config is provided, an aspect is set with an empty config ({})."
+          }
+        ]
       },
       {
-        "name": "alias <lane-name> <alias>",
+        "name": "unset <pattern> <aspect-id>",
         "alias": "",
         "options": [],
-        "description": "add an alias to a lane",
-        "extendedDescription": "an alias is a name that can be used to refer to a lane. it is saved locally and never reach the remote.\nit is useful when having multiple lanes with the same name, but with different remote scopes.",
-        "group": "ungrouped",
-        "private": true
+        "description": "unset an aspect from component(s).",
+        "extendedDescription": "",
+        "group": "development",
+        "private": false,
+        "arguments": [
+          {
+            "name": "pattern",
+            "description": "the components to target. use component name, component id, or component pattern. use component pattern to select multiple components. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\". wrap the pattern with quotes"
+          },
+          {
+            "name": "aspect-id",
+            "description": "the aspect's component id"
+          }
+        ]
       },
       {
-        "name": "rename <current-name> <new-name>",
+        "name": "update <aspect-id> [pattern]",
         "alias": "",
         "options": [],
-        "description": "EXPERIMENTAL. change the lane-name locally and on the remote (if exported)",
+        "description": "update a version of an aspect",
         "extendedDescription": "",
-        "group": "ungrouped",
-        "private": true
-      },
+        "group": "development",
+        "private": false,
+        "arguments": [
+          {
+            "name": "aspect-id",
+            "description": "the aspect's component id. optionally, add a version (id@version), otherwise, it finds the latest version on the remote"
+          },
+          {
+            "name": "pattern",
+            "description": "the components to update (defaults to all components). use component name, component id, or component pattern. use component pattern to select multiple components. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\". wrap the pattern with quotes"
+          }
+        ],
+        "examples": [
+          {
+            "cmd": "update scope.org/aspect '**/ui/**'",
+            "description": "update \"ui\" components that use scope.org/aspect to use its latest version"
+          },
+          {
+            "cmd": "bit aspect update scope.org/aspect@2.0.0",
+            "description": "update all components that use scope.org/aspect to version 2.0.0 (of this aspect)."
+          }
+        ]
+      }
+    ]
+  },
+  {
+    "name": "clear-cache",
+    "alias": "cc",
+    "options": [
+      [
+        "r",
+        "remote <remote-name>",
+        "clear memory cache from a remote scope"
+      ]
+    ],
+    "description": "clears Bit's cache from current working machine",
+    "extendedDescription": "The following gets removed by this command:\n1) V8 compiled code (generated the first time Bit is loaded by v8-compile-cache package)\n2) components cache on the filesystem (mainly the dependencies graph and docs)\n3) scope's index file, which maps the component-id:object-hash\nhttps://bit.dev/docs/workspace/clearing-cache",
+    "group": "general",
+    "private": false,
+    "skipWorkspace": true
+  },
+  {
+    "name": "log <id>",
+    "alias": "",
+    "options": [
+      [
+        "r",
+        "remote",
+        "show log of a remote component"
+      ],
+      [
+        "",
+        "parents",
+        "EXPERIMENTAL. show parents and lanes data"
+      ],
+      [
+        "j",
+        "json",
+        "json format"
+      ]
+    ],
+    "description": "show components(s) version history",
+    "extendedDescription": "https://bit.dev/docs/reference/cli-reference#log",
+    "group": "info",
+    "private": false,
+    "remoteOp": true,
+    "skipWorkspace": true,
+    "arguments": [
       {
-        "name": "diff [values...]",
-        "alias": "",
-        "options": [],
-        "description": "show diff between lanes",
-        "extendedDescription": "bit lane diff => diff between the current lane and default lane. (only inside workspace).\nbit lane diff to => diff between the current lane (or default-lane when in scope) and \"to\" lane.\nbit lane diff from to => diff between \"from\" lane and \"to\" lane.",
-        "group": "ungrouped",
-        "private": true,
-        "remoteOp": true,
-        "skipWorkspace": true
-      },
+        "name": "id",
+        "description": "component-id or component-name"
+      }
+    ]
+  },
+  {
+    "name": "deprecate <component-name>",
+    "alias": "d",
+    "options": [
+      [
+        "",
+        "new-id <string>",
+        "if replaced by another component, enter the new component id"
+      ]
+    ],
+    "description": "deprecate a component",
+    "extendedDescription": "",
+    "group": "collaborate",
+    "private": false,
+    "remoteOp": true,
+    "skipWorkspace": true,
+    "arguments": [
       {
-        "name": "add-readme <componentId> [laneName]",
-        "alias": "",
-        "options": [],
-        "description": "EXPERIMENTAL. add lane readme component",
-        "extendedDescription": "",
-        "group": "ungrouped",
-        "private": true,
-        "skipWorkspace": false
-      },
+        "name": "component-name",
+        "description": "component name or component id"
+      }
+    ]
+  },
+  {
+    "name": "undeprecate <id>",
+    "alias": "",
+    "options": [],
+    "description": "undeprecate a deprecated component (local/remote)",
+    "extendedDescription": "",
+    "group": "collaborate",
+    "private": false,
+    "remoteOp": true,
+    "skipWorkspace": true
+  },
+  {
+    "name": "rename <current-name> <new-name>",
+    "alias": "",
+    "options": [
+      [
+        "s",
+        "scope <scope-name>",
+        "default scope for the newly created component"
+      ],
+      [
+        "p",
+        "path <relative-path>",
+        "relative path in the workspace. by default the path is `<scope>/<namespace>/<name>`"
+      ],
+      [
+        "r",
+        "refactor",
+        "update the import/require statements in all dependent components (in the same workspace)"
+      ]
+    ],
+    "description": "EXPERIMENTAL. rename component. if tagged/exported, create a new component and deprecate the original component",
+    "extendedDescription": "",
+    "group": "collaborate",
+    "private": false,
+    "remoteOp": true,
+    "skipWorkspace": true,
+    "arguments": [
       {
-        "name": "remove-readme [laneName]",
-        "alias": "",
-        "options": [],
-        "description": "EXPERIMENTAL. remove lane readme component",
-        "extendedDescription": "",
-        "group": "ungrouped",
-        "private": true,
-        "skipWorkspace": false
+        "name": "current-name",
+        "description": "the current component name (without its scope name)"
       },
       {
-        "name": "import <lane>",
-        "alias": "",
-        "options": [
-          [
-            "",
-            "skip-dependency-installation",
-            "do not install packages of the imported components"
-          ]
-        ],
-        "description": "import a remote lane to your workspace",
-        "extendedDescription": "",
-        "group": "ungrouped",
-        "private": true
+        "name": "new-name",
+        "description": "the new component name (without its scope name)"
       }
     ]
   },
   {
-    "name": "switch <lane>",
+    "name": "fork <source-component-id> [target-component-name]",
     "alias": "",
     "options": [
       [
-        "n",
-        "alias <string>",
-        "relevant when the specified lane is a remote late. name a local lane differently than the remote lane"
+        "s",
+        "scope <string>",
+        "default scope for the new component"
       ],
       [
-        "m",
-        "merge [strategy]",
-        "merge local changes with the checked out version. strategy should be \"theirs\", \"ours\" or \"manual\""
+        "p",
+        "path <string>",
+        "relative path in the workspace for the new component. by default the path is `<scope>/<namespace>/<name>`"
       ],
       [
-        "a",
-        "get-all",
-        "checkout all components in a lane include ones that do not exist in the workspace"
+        "r",
+        "refactor",
+        "update the import/require statements in all dependent components (in the same workspace)"
       ],
       [
         "",
         "skip-dependency-installation",
         "do not install packages of the imported components"
-      ],
-      [
-        "j",
-        "json",
-        "return the output as JSON"
       ]
     ],
-    "description": "switch to the specified lane",
+    "description": "EXPERIMENTAL. create a new component out of an existing one (copies source files and config)",
     "extendedDescription": "",
-    "group": "ungrouped",
-    "private": true
+    "group": "collaborate",
+    "private": false,
+    "remoteOp": true,
+    "skipWorkspace": true,
+    "arguments": [
+      {
+        "name": "source-component-id",
+        "description": "the component id of the source component"
+      },
+      {
+        "name": "target-component-name",
+        "description": "the name for the new component (component name without scope). to set a different scope, use the '--scope' flag"
+      }
+    ]
   },
   {
-    "name": "eject <pattern>",
+    "name": "eject <component-pattern>",
     "alias": "E",
     "options": [
       [
@@ -2793,10 +3295,16 @@
         "keep the component files in the workspace intact"
       ]
     ],
-    "description": "replaces the components from the local scope with the corresponding packages",
-    "extendedDescription": "you can use a `<pattern>` for multiple component ids, such as `bit eject \"org.scope/utils/**\"`. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nto validate the pattern before running this command, run `bit pattern <pattern>`.\n",
+    "description": "replace components maintained in the workspace with their corresponding packages",
+    "extendedDescription": "",
     "group": "development",
-    "private": false
+    "private": false,
+    "arguments": [
+      {
+        "name": "component-pattern",
+        "description": "component name, component id, or component pattern.\nuse component pattern to select multiple components. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
+      }
+    ]
   },
   {
     "name": "resume-export <export-id> <remotes...>",
@@ -2809,48 +3317,28 @@
     "remoteOp": true
   },
   {
-    "name": "export [remote] [id...]",
+    "name": "export [component-patterns...]",
     "alias": "e",
     "options": [
       [
         "e",
         "eject",
-        "replaces the exported components from the local scope with the corresponding packages"
+        "replace the exported components with their corresponding packages (to use these components without further maintaining them)"
       ],
       [
         "a",
         "all",
-        "export all components include non-staged"
-      ],
-      [
-        "d",
-        "include-dependencies",
-        "LEGACY ONLY. include the component's dependencies as part of the export to the remote scope"
-      ],
-      [
-        "s",
-        "set-current-scope",
-        "LEGACY ONLY. ensure the component's remote scope is set according to the target location"
-      ],
-      [
-        "r",
-        "rewire",
-        "LEGACY ONLY. when exporting to a different or new scope, replace import/require statements in the source code to match the new scope"
-      ],
-      [
-        "f",
-        "force",
-        "force changing a component remote without asking for a confirmation"
+        "export all components, including non-staged (useful when components in the remote scope are corrupted or missing)"
       ],
       [
         "",
         "all-versions",
-        "export not only staged versions but all of them"
+        "export not only staged versions but all of them (useful when versions in the remote scope are corrupted or missing)"
       ],
       [
         "",
         "origin-directly",
-        "HARMONY ONLY. avoid export to the central hub, instead, export directly to the original scopes. not recommended!"
+        "EXPERIMENTAL. avoid export to the central hub, instead, export directly to the original scopes. not recommended!"
       ],
       [
         "",
@@ -2868,11 +3356,17 @@
         "show output in json format"
       ]
     ],
-    "description": "Export components to a remote scope",
-    "extendedDescription": "bit export => export all staged components to their current scope, if checked out to a lane, export the lane as well\n`bit export [id...]` => export the given ids to their current scope\n\nhttps://bit.dev/docs/components/exporting-components\nyou can use a pattern for multiple ids, such as bit export remote-scope \"utils/*\". (wrap the pattern with quotes to avoid collision with shell commands)",
+    "description": "export components from the workspace to remote scopes",
+    "extendedDescription": "bit export => export all staged components to their current scope, if checked out to a lane, export the lane as well\n  `bit export [id...]` => export the given ids to their current scope\n  you can use a pattern for multiple ids, such as bit export remote-scope \"utils/*\". (wrap the pattern with quotes to avoid collision with shell commands)",
     "group": "collaborate",
     "private": false,
-    "remoteOp": true
+    "remoteOp": true,
+    "arguments": [
+      {
+        "name": "component-patterns...",
+        "description": "component IDs, component names, or component patterns (separated by space). Use patterns to export groups of components using a common scope or namespace. E.g., \"utils/*\" (wrap with double quotes)"
+      }
+    ]
   },
   {
     "name": "update-dependencies <data>",