@teambit/harmony.content.cli-reference 2.0.766 → 2.0.767

package/dist/cli-reference.mdx.js

@@ -43,9 +43,9 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": track one or more directories as new components", (0, _react2.mdx)("br", {
+  }, "Description"), ": track existing directory contents as new components in the workspace", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "Learn the recommended workflow for tracking directories as components, in the link below."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }), "\n", "Registers one or more directories as Bit components without changing your files. Each provided path becomes a component root tracked by Bit."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit add [path...]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -181,7 +181,13 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": Manages apps"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": manage application components", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "applications are components that create deployable, runnable applications like React apps or Node.js servers.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "list available apps in the workspace and inspect their configurations.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "use \"bit run\" to start an application locally."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit app [sub-command]")), (0, _react2.mdx)("h3", null, "app list"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
@@ -231,7 +237,13 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "app run [app-name]")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": locally run an app component (independent of bit's dev server)"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "Description"), ": start an application component locally", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "runs application components in their own development server, separate from the \"bit start\" UI.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "apps are components that create deployable applications (React apps, Node.js servers, etc.).", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "when no app name is specified, automatically detects and runs the app if only one exists in the workspace."), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -370,13 +382,13 @@ function MDXContent(_ref) {
     "align": null
   }, "the arguments passing to the app. for example, --args=\"--a=1 --b\". don't forget to use quotes to wrap the value to escape special characters.")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "artifacts"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": list and download component artifacts", (0, _react2.mdx)("br", {
+  }, "Description"), ": view and download build artifacts", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "artifacts are created on isolated capsules during tag or snap commands.", (0, _react2.mdx)("br", {
+  }), "\n", "displays artifacts created during the build pipeline in isolated capsules during tag or snap operations.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "example of artifacts are dists files generated by a compiler, a JUnit.xml file generated by a tester", (0, _react2.mdx)("br", {
+  }), "\n", "artifacts include compiled files, test reports, package files, and other build outputs generated by various tasks.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "and a package.tgz file generated by pkg aspect."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }), "\n", "use --out-dir to download artifacts locally for inspection or deployment purposes."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit artifacts <component-pattern>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -483,7 +495,13 @@ function MDXContent(_ref) {
     "align": null
   }, "download the files to the specified dir")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "aspect"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": manage aspects"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": manage component aspects and their configurations", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "aspects provide functionality and tools for components throughout their development lifecycle.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "primarily useful for inspecting aspect assignments and configurations with \"bit aspect get\".", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "rarely used for manual aspect management as most aspects are configured automatically."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit aspect <sub-command>")), (0, _react2.mdx)("h3", null, "aspect list"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
@@ -898,7 +916,13 @@ function MDXContent(_ref) {
     parentName: "td"
   }, "bit pattern <pattern>"), " to validate the pattern.")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "blame"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": EXPERIMENTAL. per line, show who and when was the last to modify it"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": EXPERIMENTAL. show line-by-line authorship and modification history", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "displays who last modified each line of a file and when the change was made.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "tracks line-level changes across component versions.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "shows author, date, version hash, and optionally commit messages for each line."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit blame <filepath>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -964,15 +988,15 @@ function MDXContent(_ref) {
     "align": null
   }, "show the commit message")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "build"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": run set of tasks for build.", (0, _react2.mdx)("br", {
+  }, "Description"), ": run build pipeline tasks in isolated environments", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "by default, only new and modified components are built.", (0, _react2.mdx)("br", {
+  }), "\n", "executes the complete build pipeline including compilation, testing, linting, and other tasks defined by component environments.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "the build takes place in an isolated directories on the filesystem (called \"capsules\"). the component files are copied to these directories", (0, _react2.mdx)("br", {
+  }), "\n", "the build takes place in isolated directories called \"capsules\" where component files are copied and dependencies are installed via the package manager.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "and the package-manager installs the dependencies in the capsules root. once done, the build pipeline is running.", (0, _react2.mdx)("br", {
+  }), "\n", "by default processes only new and modified components - use --unmodified to build all components.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "because this process can take a while on a large workspace, some flags are available to shorten the process. See the example section for more info."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }), "\n", "because this process can take a while on large workspaces, various flags are available to optimize the process - see examples for debugging workflows."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit build [component-pattern]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -1241,15 +1265,13 @@ function MDXContent(_ref) {
     "align": null
   }, "ignore component issues (shown in \"bit status\" as \"issues found\"), issues to ignore: ", "[MissingPackagesDependenciesOnFs, MissingManuallyConfiguredPackages, UntrackedDependencies, ResolveErrors, RelativeComponents, RelativeComponentsAuthored, ParseErrors, MissingDists, LegacyInsideHarmony, MissingDependenciesOnFs, ImportNonMainFiles, MultipleEnvs, MissingLinksFromNodeModulesToSrc, CircularDependencies, DuplicateComponentAndPackage, MergeConfigHasConflict, NonLoadedEnv, ExternalEnvWithoutVersion, RemovedDependencies, RemovedEnv, DeprecatedDependencies, SelfReference, ImportFromDirectory]", " to ignore multiple issues, separate them by a comma and wrap with quotes. to ignore all issues, specify \"", "*", "\".")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "capsule"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": manage capsules", (0, _react2.mdx)("br", {
+  }, "Description"), ": manage isolated component environments", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "a capsule is a directory containing the component code, isolated from the workspace.", (0, _react2.mdx)("br", {
+  }), "\n", "capsules are temporary isolated directories containing component code and dependencies.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "normally, capsules are created during the build process, the component files are copied and the packages are installed", (0, _react2.mdx)("br", {
+  }), "\n", "automatically created during build processes to compile and test components in isolation.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "via the configured package-manager. the purpose is to compile/test them in isolation to make sure they will work for", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "other users after publishing/exporting them."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }), "\n", "ensures components work independently before publishing, similar to how they'll be consumed."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit capsule")), (0, _react2.mdx)("h3", null, "capsule list"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
@@ -1548,7 +1570,13 @@ function MDXContent(_ref) {
     "align": null
   }, "json format")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "check-types"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": check typescript types"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": validate TypeScript type correctness", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "checks for TypeScript type errors in component files, similar to running tsc.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "by default only checks new and modified components. use --all to check all components.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "useful for catching type issues before tagging, snapping or building components."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit check-types [component-pattern]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -1652,27 +1680,25 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": switch between component versions or remove local changes"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": switch between component versions or remove local changes", (0, _react2.mdx)("br", {
     parentName: "p"
-  }, "bit checkout <version> [component-pattern]"), " => checkout the specified ids (or all components when --all is used) to the specified version", (0, _react2.mdx)("br", {
+  }), "\n", "checkout components to specified versions or remove local changes. most commonly used as 'bit checkout head' to get latest versions.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit checkout head [component-pattern]"), " => checkout to the last snap/tag (use --latest if you only want semver tags), omit ", "[component-pattern]", " to checkout head for all", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit checkout head~x [component-pattern]"), " => go backward x generations from the head and checkout to that version", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit checkout latest [component-pattern]"), " => checkout to the latest satisfying semver tag, omit ", "[component-pattern]", " to checkout latest for all", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit checkout reset [component-pattern]"), " => remove local modifications from the specified ids (or all components when --all is used). also, if a component dir is deleted from the filesystem, it'll be restored", (0, _react2.mdx)("br", {
+  }), "\n", "the ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }), "\n", "when on a lane, \"checkout head\" only checks out components on this lane. to update main components, run \"bit lane merge main\""), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "<to>"), " argument accepts these values:"), (0, _react2.mdx)("ul", null, (0, _react2.mdx)("li", {
+    parentName: "ul"
+  }, "head: checkout to last snap/tag (most common usage)"), (0, _react2.mdx)("li", {
+    parentName: "ul"
+  }, "specific version: checkout to exact version (e.g. 'bit checkout 1.0.5 component-name')"), (0, _react2.mdx)("li", {
+    parentName: "ul"
+  }, "head~x: go back x generations from head (e.g. 'head~2' for two versions back)"), (0, _react2.mdx)("li", {
+    parentName: "ul"
+  }, "latest: checkout to latest semver tag"), (0, _react2.mdx)("li", {
+    parentName: "ul"
+  }, "reset: remove local modifications and restore original files (also restores deleted component directories)", (0, _react2.mdx)("br", {
+    parentName: "li"
+  }), "when on lanes, 'checkout head' only affects lane components. to update main components, run 'bit lane merge main'.")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit checkout <to> [component-pattern]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -1866,7 +1892,9 @@ function MDXContent(_ref) {
     "align": null
   }, "do not merge, just overwrite with incoming files")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "ci"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": CI commands"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": continuous integration commands for automated workflows", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "provides commands designed for use in CI/CD pipelines with Git workflows to automate component development tasks like verification, pull request handling, and deployment preparation."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit ci <sub-command>")), (0, _react2.mdx)("h3", null, "ci verify"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
@@ -2211,13 +2239,15 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": clears Bit's cache from current working machine", (0, _react2.mdx)("br", {
+  }, "Description"), ": remove cached data to resolve stale data issues", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "The following gets removed by this command:"), (0, _react2.mdx)("ol", null, (0, _react2.mdx)("li", {
+  }), "\n", "clears various caches that Bit uses to improve performance. useful when experiencing stale data issues or", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "unexpected behavior. this command removes:"), (0, _react2.mdx)("ol", null, (0, _react2.mdx)("li", {
     parentName: "ol"
   }, "components cache on the filesystem (mainly the dependencies graph and docs)"), (0, _react2.mdx)("li", {
     parentName: "ol"
-  }, "scope's index file, which maps the component-id:object-hash")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "scope's index file, which maps the component-id:object-hash")), (0, _react2.mdx)("p", null, "note: this cache has minimal impact on disk space. to free significant disk space, use \"bit capsule delete --all\" to remove build capsules."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit clear-cache")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -2255,81 +2285,15 @@ function MDXContent(_ref) {
   }, "-r")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "clear memory cache from a remote scope")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "cli"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
-    parentName: "p"
-  }, "Description"), ": EXPERIMENTAL. enters bit cli program and generates commands list"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "clear memory cache from a remote scope")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "compile"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "bit cli")), (0, _react2.mdx)("h3", null, "cli generate"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "Description"), ": transpile component source files", (0, _react2.mdx)("br", {
     parentName: "p"
-  }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "cli generate")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }), "\n", "compiles TypeScript, JSX, and other source files into JavaScript using the compiler configured by each component's environment.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }, "Description"), ": generate an .md file with all commands details"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
-    parentName: "table"
-  }, (0, _react2.mdx)("tr", {
-    parentName: "thead"
-  }, (0, _react2.mdx)("th", {
-    parentName: "tr",
-    "align": null
-  }, (0, _react2.mdx)("strong", {
-    parentName: "th"
-  }, "Option")), (0, _react2.mdx)("th", {
-    parentName: "tr",
-    "align": "center"
-  }, (0, _react2.mdx)("strong", {
-    parentName: "th"
-  }, "Option alias")), (0, _react2.mdx)("th", {
-    parentName: "tr",
-    "align": null
-  }, (0, _react2.mdx)("strong", {
-    parentName: "th"
-  }, "Description")))), (0, _react2.mdx)("tbody", {
-    parentName: "table"
-  }, (0, _react2.mdx)("tr", {
-    parentName: "tbody"
-  }, (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "--metadata")), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": "center"
-  }), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, "metadata/front-matter to place at the top of the .md file, enter as an object e.g. --metadata.id=cli --metadata.title=commands")), (0, _react2.mdx)("tr", {
-    parentName: "tbody"
-  }, (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "--docs")), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": "center"
-  }), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, "generate the cli-reference.docs.mdx file")), (0, _react2.mdx)("tr", {
-    parentName: "tbody"
-  }, (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "--json")), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": "center"
-  }, (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "-j")), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, "output the commands info as JSON")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "compile"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }), "\n", "outputs compiled files to node_modules/component-package-name/dist for consumption by other components.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }, "Description"), ": compile components in the workspace"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }), "\n", "automatically triggered by \"bit watch\", \"bit start\", or IDE extensions, but can be run manually for debugging."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit compile [component-names...]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -2453,7 +2417,15 @@ function MDXContent(_ref) {
     "align": null
   }, "EXPERIMENTAL. generate d.ts files for typescript components (hurts performance)")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "config"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": config management", (0, _react2.mdx)("br", {
+  }, "Description"), ": manage Bit configuration settings", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "view and modify Bit configuration at different levels: global, workspace, or scope.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "configurations control various aspects of Bit including user settings, registries, and feature flags.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "use environment variables prefixed with BIT", (0, _react2.mdx)("em", {
+    parentName: "p"
+  }, "CONFIG"), " for temporary overrides.", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("a", {
     parentName: "p",
@@ -2645,7 +2617,9 @@ function MDXContent(_ref) {
     "align": null
   }, "output as JSON")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "create"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": create a new component (source files and config) using a template."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": scaffold new component(s) from a template (sources, config, and env)", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "Generates one or more components from a chosen template with ready-to-use source files, configuration, and environment. Use it to quickly scaffold consistent components across your workspace. Run 'bit templates' to discover available templates."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit create <template-name> <component-names...>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -2813,13 +2787,13 @@ function MDXContent(_ref) {
     "align": null
   }, "replace existing files at the target location")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "delete"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": mark components as deleted on the remote", (0, _react2.mdx)("br", {
+  }, "Description"), ": soft-delete components from remote scopes", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "to remove components from your local workspace only, use \"bit remove\" command.", (0, _react2.mdx)("br", {
+  }), "\n", "marks components as deleted so they won't be visible on remote scopes after export.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "this command marks the components as deleted, and after snap/tag and export they will be marked as deleted from the remote scope as well.", (0, _react2.mdx)("br", {
+  }), "\n", "components remain recoverable using \"bit recover\" unless --hard is used (permanent deletion, not recommended).", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "unless the '--hard' flag is used (not recommended!), in which case, the component will be deleted from the remote scope immediately."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }), "\n", "to remove components from your local workspace only, use \"bit remove\" instead."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit delete <component-pattern>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -2972,7 +2946,13 @@ function MDXContent(_ref) {
     "align": null
   }, "comma-separated list of snap hashes to mark as deleted (e.g. --snaps \"hash1,hash2,hash3\")")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "dependents"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": show dependents of the given component"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": show components that depend on the specified component", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "displays components from both workspace and scope that depend on the specified component.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "useful for understanding impact before making changes to a component or when planning refactoring.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "shows both direct and transitive dependents organized by their origin (workspace vs scope)."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit dependents <component-name>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -3044,7 +3024,13 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": deprecate a component"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": mark a component as deprecated to discourage its use", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "marks a component as deprecated locally, then after snap/tag and export it becomes deprecated in the remote scope.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "optionally specify a replacement component or deprecate only specific version ranges.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "deprecated components remain available but display warnings when installed or imported."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit deprecate <component-name>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -3130,7 +3116,9 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": manage dependencies"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": manage component dependencies", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "configure and analyze component dependencies with sub-commands for setting, removing, and inspecting dependency relationships."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit deps <sub-command>")), (0, _react2.mdx)("h3", null, "deps get"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
@@ -3684,7 +3672,13 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "deps usage <dependency-name>")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": find components that use the specified dependency"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "Description"), ": find components that use the specified dependency", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "searches workspace components to find which ones depend on the specified package or component.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "useful for understanding dependency usage before removing packages or when refactoring components.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "supports both exact version matching and package name patterns."), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -3790,7 +3784,13 @@ function MDXContent(_ref) {
     "align": null
   }, "specify where the dependencies should be written. By default they are saved to workspace.jsonc")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "diff"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": show the diff between the components' current source files and config, and their latest snapshot or tag"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": compare component changes between versions or against the current workspace", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "shows a detailed diff of component files, dependencies, and configuration changes.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "by default, compares workspace changes against the latest version. specify versions to compare historical changes.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "supports pattern matching to filter components and various output formats for better readability."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit diff [component-pattern] [version] [to-version]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -3910,7 +3910,13 @@ function MDXContent(_ref) {
     "align": null
   }, "show tables instead of plain text for dependencies diff")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "doctor"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": diagnose a bit workspace"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": diagnose and troubleshoot workspace issues", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "runs comprehensive health checks on your workspace to detect and report configuration problems,", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "missing dependencies, corrupted data, and other issues that may affect workspace functionality.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "can generate diagnostic reports and workspace archives for debugging and support purposes."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit doctor [diagnosis-name]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -4044,9 +4050,13 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": remove component from the workspace and install it instead as a regular npm package.", (0, _react2.mdx)("br", {
+  }, "Description"), ": remove component from workspace and install it as npm package", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "By default the component files will be removed from the workspace"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }), "\n", "converts workspace components to external npm packages by removing them from .bitmap and installing via package manager.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "by default removes component files from workspace. use --keep-files to preserve source code while converting to package dependency.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "useful for components that no longer need active development in current workspace."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit eject <component-pattern>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -4159,13 +4169,13 @@ function MDXContent(_ref) {
     "align": null
   }, "keep the component files in the workspace intact")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "eject-conf"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": eject components configuration (create a ", (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": create component.json configuration files for components", (0, _react2.mdx)("br", {
     parentName: "p"
-  }, "component.json"), " file)", (0, _react2.mdx)("br", {
+  }), "\n", "generates component.json files containing component-specific configuration that overrides workspace defaults.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "note this can be reversed at any time by snapping/tagging changes and deleting the component.json file", (0, _react2.mdx)("br", {
+  }), "\n", "useful for customizing individual component settings. alternatively, use commands like \"bit env set\", \"bit deps set\", or \"bit aspect set\".", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "you can use a ", (0, _react2.mdx)("inlineCode", {
+  }), "\n", "can be reversed by deleting the component.json file and snapping/tagging the changes."), (0, _react2.mdx)("p", null, "you can use a ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "<pattern>"), " for multiple component ids, such as ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -4242,7 +4252,11 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": list all components maintained by the workspace and their corresponding envs"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": show components and their assigned environments", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "displays a table showing each workspace component and its corresponding environment.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "environments control how components are built, tested, linted, and deployed."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit envs")), (0, _react2.mdx)("h3", null, "envs list"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
@@ -4520,17 +4534,13 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": export components from the workspace to remote scopes", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "bit export => export all staged snaps/tags of components to their remote scope. if checked out to a lane, export the lane as well", (0, _react2.mdx)("br", {
+  }, "Description"), ": upload components to remote scopes", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "", (0, _react2.mdx)("inlineCode", {
+  }), "\n", "uploads staged versions (snaps/tags) to remote scopes, making them available for consumption by other workspaces.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }, "bit export [pattern...]"), " => export components included by the pattern to their remote scope (we recommend not using a pattern in", (0, _react2.mdx)("br", {
+  }), "\n", "without arguments, exports all staged components. when on a lane, exports the lane as well.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "most scenarios so that all changes are exported simultaneously)", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "you can use a pattern for multiple ids, such as bit export \"utils/", "*", "\". (wrap the pattern with quotes to avoid collision with shell commands)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }), "\n", "exporting is the final step after development and versioning to share components with your team."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit export [component-patterns...]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -4734,7 +4744,13 @@ function MDXContent(_ref) {
     "align": null
   }, "show output in json format")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "fork"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": create a new component forked from an existing one (copies source files and configs)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": create a new component by copying from an existing one", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "duplicates an existing component's source files and configuration to create a new independent component.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "useful for creating variations or starting development from a similar component.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "automatically handles import/require statement updates and provides refactoring options."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit fork <source-component-id> [target-component-name]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -4924,7 +4940,13 @@ function MDXContent(_ref) {
     "align": null
   }, "use ast to transform files instead of regex")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "format"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": format components in the development workspace"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": auto-format component source code", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "formats component files using the formatter configured by each component's environment (Prettier, etc.).", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "by default formats all components. use --changed to format only new and modified components.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "supports check mode to verify formatting without making changes."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit format [component-pattern]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -5022,7 +5044,13 @@ function MDXContent(_ref) {
     "align": null
   }, "return the format results in json format")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "git"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": perform git operations"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": Git utilities for Bit repositories", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "provides specialized Git utilities for handling Bit-specific files and conflicts.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "includes tools for setting up merge drivers for bitmap files and resolving conflicts during Git merges.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "essential for properly handling Bit's internal files when working with Git repositories."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit git <sub-command>")), (0, _react2.mdx)("h3", null, "git set-merge-driver"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
@@ -5074,7 +5102,11 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "Description"), ": a special command to merge conflicting bitmap files during git merge"), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "globals"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": list all globals"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": display global directories and paths used by Bit", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "shows all global directories including cache, logs, and config locations used by Bit across your system.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "useful for debugging and understanding where Bit stores data."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit globals")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -5114,7 +5146,13 @@ function MDXContent(_ref) {
     "align": null
   }, "json format")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "graph"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": generate an SVG image file with the components' dependencies graph"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": visualize component dependencies as a graph image", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "generates an SVG (or PNG) image showing component dependency relationships.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "black arrows represent runtime dependencies, red arrows show dev or peer dependencies.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "by default shows only workspace components; use --include-dependencies for full dependency tree."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit graph [id]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -5240,7 +5278,11 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": shows help"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": display available commands and usage information", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "shows a categorized list of all available Bit commands with brief descriptions. use ", (0, _react2.mdx)("inlineCode", {
+    parentName: "p"
+  }, "bit <command> --help"), " for detailed help on specific commands."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit help")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -5278,7 +5320,13 @@ function MDXContent(_ref) {
     "align": null
   }, "show internal commands")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "import"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": import components from their remote scopes to the local workspace"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": bring components from remote scopes into your workspace", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "brings component source files from remote scopes into your workspace and installs their dependencies as packages.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "supports pattern matching for bulk imports, merge strategies for handling conflicts, and various optimization options.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "without arguments, fetches all workspace components' latest versions from their remote scopes."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit import [component-patterns...]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -5712,9 +5760,13 @@ function MDXContent(_ref) {
     "align": null
   })))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "init"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": create or reinitialize an empty workspace", (0, _react2.mdx)("br", {
+  }, "Description"), ": initialize a Bit workspace in an existing project", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "creates Bit configuration files in an existing project directory to start tracking components.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "if already a workspace, validates and repairs Bit files as needed.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "if the current directory is already a workspace, it validates that bit files are correct and rewrite them if needed."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }), "\n", "supports various reset options to recover from corrupted state or restart from scratch."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit init [path]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -5967,9 +6019,13 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": installs workspace dependencies", (0, _react2.mdx)("br", {
+  }, "Description"), ": install workspace dependencies", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "when no package is specified, all workspace dependencies are installed and all workspace components are imported."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }), "\n", "installs workspace dependencies and prepares the workspace for development.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "when packages are specified, adds them to workspace.jsonc policy and installs. when no packages specified, installs existing dependencies.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "automatically imports components, compiles components, links to node_modules, and writes config files."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit install [packages...]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -6214,7 +6270,13 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": manage lanes - if no sub-command is used, runs \"bit lane list\""), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": manage lanes for parallel development", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "lanes allow isolated development of features without affecting main branch components.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "create, switch between, and merge lanes to coordinate parallel work across teams.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "without a sub-command, lists all available lanes."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit lane [sub-command]")), (0, _react2.mdx)("h3", null, "lane list"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
@@ -8155,7 +8217,13 @@ function MDXContent(_ref) {
     "align": null
   }, "list only lanes that haven't been merged")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "link"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": create links in the node_modules directory, to core aspects and to components in the workspace"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": create links between components and node_modules", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "creates links in node_modules for workspace components and core aspects, enabling import resolution.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "automatically links all workspace components and Bit's core aspects to their respective package names.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "useful for development when components need to reference each other or when debugging linking issues."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit link [component-names...]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -8301,7 +8369,13 @@ function MDXContent(_ref) {
     "align": null
   }, "show only a summary of component links instead of listing all components")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "lint"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": lint components in the development workspace"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": analyze component code for issues and style violations", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "runs linters configured by each component's environment (ESLint, etc.) to check for code quality issues.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "by default lints all components. use --changed to lint only new and modified components.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "supports automatic fixing of certain issues with --fix flag."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit lint [component-pattern]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -8420,7 +8494,13 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": list components on a workspace or a remote scope (with flag)."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": display components in workspace or remote scope", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "shows components in the current workspace by default, or from a specified remote scope.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "supports filtering by scope, namespace, and various display options.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "use --outdated to highlight components that have newer versions available."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit list [remote-scope]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -8550,7 +8630,13 @@ function MDXContent(_ref) {
     "align": null
   }, "filter components by their namespace (a logical grouping within a scope, e.g., 'ui', '", "*", "/ui')")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "local-only"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": manage local-only components, which reside only in the workspace and are not snapped/tagged"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": manage components that exist only in the workspace", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "controls components that are excluded from versioning (snap/tag) and exporting operations.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "local-only components are useful for workspace-specific tools, configs, or temporary components.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "these components remain in the workspace but won't be shared or versioned."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit local-only <sub-command>")), (0, _react2.mdx)("h3", null, "local-only set"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
@@ -8632,7 +8718,13 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "Description"), ": list all local-only components"), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "log"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": show components(s) version history"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": display component version history", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "shows chronological history of component versions including tags and snaps with metadata.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "displays commit messages, authors, dates, and version information. supports both local and remote component logs.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "use various format options for compact or detailed views of version history."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit log <id>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -8784,7 +8876,13 @@ function MDXContent(_ref) {
     "align": null
   }, "json format")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "log-file"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": EXPERIMENTAL. show file history"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": EXPERIMENTAL. display history of changes to a specific file", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "shows version history for a specific file within component versions.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "tracks file-level changes across component snaps and tags.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "displays file modifications, hashes, and associated commit information."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit log-file <filepath>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -8850,7 +8948,13 @@ function MDXContent(_ref) {
     "align": null
   }, "show each log entry in one line")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "login"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": log in to Bit cloud"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": authenticate with Bit Cloud for component publishing and collaboration", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "opens browser to authenticate with Bit Cloud (bit.cloud) and obtain access token for publishing components.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "automatically updates .npmrc file with registry configuration and authentication token for seamless package publishing.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "supports custom cloud domains, CI/machine authentication, and manual token refresh options."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit login")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -8983,11 +9087,23 @@ function MDXContent(_ref) {
     "align": null
   }, "DEPRECATE. use --no-browser instead")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "logout"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": log the CLI out of Bit"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": sign out of Bit Cloud and clear authentication tokens", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "removes stored authentication tokens and signs out of Bit Cloud.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "clears local credentials while preserving .npmrc configurations.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "use this to switch between accounts or when authentication tokens expire."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit logout")), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "mcp-server"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": Start the Bit CLI Model Context Protocol (MCP) server for programmatic and remote access to Bit commands."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": start Model Context Protocol server for AI assistants", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "enables AI assistants and other tools to interact with Bit via the Model Context Protocol.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "provides a standardized interface for AI agents to execute Bit commands and access component information.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "allows writing custom instructions and rules to guide AI agents in their interactions with Bit."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit mcp-server [sub-command]")), (0, _react2.mdx)("h3", null, "mcp-server start"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
@@ -9326,15 +9442,17 @@ function MDXContent(_ref) {
     "align": null
   }, "For non-Bit workspaces that only consume Bit component packages. Enables only \"schema\", \"show\", and \"remote_search\" tools")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "merge"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": merge changes of the remote head into local - auto-snaps all merged components", (0, _react2.mdx)("br", {
+  }, "Description"), ": merge diverged component history when local and remote have different versions", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "merge changes of the remote head into local when they are diverged. when on a lane, merge the remote head of the lane into the local", (0, _react2.mdx)("br", {
+  }), "\n", "resolves diverged component history when both local and remote have created different snaps/tags from the same base version.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "and creates snaps for merged components that have diverged, on the lane.", (0, _react2.mdx)("br", {
+  }), "\n", "if no component pattern is specified, all pending-merge components will be merged (run 'bit status' to list them).", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "if no ids are specified, all pending-merge components will be merged. (run \"bit status\" to list them).", (0, _react2.mdx)("br", {
+  }), "\n", "'bit status' will show diverged components and suggest either merging or resetting local changes.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "optionally use '--abort' to revert the last merge. to revert a lane merge, use \"bit lane merge-abort\" command."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }), "\n", "preferred approach: use 'bit reset' to remove local versions, then 'bit checkout head' to get remote versions.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "for lane-to-lane merging, use 'bit lane merge' instead."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit merge [component-pattern]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -9544,9 +9662,13 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": move a component to a different filesystem path", (0, _react2.mdx)("br", {
+  }, "Description"), ": relocate a component to a different directory", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "moves component files to a new location within the workspace and updates the .bitmap tracking.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "(note: this does NOT affect the component's name or scope, just its location in the workspace)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }), "\n", "only changes the filesystem location - does not affect the component's name, scope, or ID.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "useful for reorganizing workspace structure or following new directory conventions."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit move <current-component-dir> <new-component-dir>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -9586,7 +9708,13 @@ function MDXContent(_ref) {
     "align": "center"
   }, "the new directory (relative to the workspace root) to create and move the component's files to")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "new"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": create a new workspace from a template"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": create a new Bit workspace from a template", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "initializes a new Bit workspace with pre-configured settings, environments, and optionally starter components.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "templates provide different setups for React, Angular, Node.js, or custom development workflows.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "installs dependencies and configures the workspace for immediate development."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit new <template-name> <workspace-name>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -9776,7 +9904,13 @@ function MDXContent(_ref) {
     "align": null
   }, "create the new workspace in current directory (default is to create a new directory, inside the current dir)")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "npmrc"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": manage npmrc file with scope, registry, and token information from bit.cloud"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": configure .npmrc file with Bit Cloud registry and authentication settings", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "manages .npmrc configuration for seamless package installation from Bit Cloud registries.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "automatically configures scoped registries and authentication tokens for your workspace components.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "provides sub-commands for generating, updating, and managing npm registry configurations."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit npmrc [sub-command]")), (0, _react2.mdx)("h3", null, "npmrc generate"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
@@ -9835,7 +9969,7 @@ function MDXContent(_ref) {
     "align": null
   }, "force update the .npmrc file even if there are conflicts")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "pattern"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": list the component ids matching the given pattern", (0, _react2.mdx)("br", {
+  }, "Description"), ": test and validate component patterns", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", "this command helps validating a pattern before using it in other commands.", (0, _react2.mdx)("br", {
     parentName: "p"
@@ -9906,7 +10040,9 @@ function MDXContent(_ref) {
     "align": null
   }, "return the output as JSON")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "recover"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": recover component(s) soft-deleted from the workspace, or a remote scope"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": restore soft-deleted components", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "reverses the soft-deletion of components marked with \"bit delete\", restoring them to their previous state. works for both local and remote soft-deleted components."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit recover <component-name>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -9959,7 +10095,13 @@ function MDXContent(_ref) {
     "align": null
   }, "do not write config files (such as eslint, tsconfig, prettier, etc...)")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "refactor"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": source code refactoring / codemod"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": automatically refactor component source code", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "performs automated code transformations and refactoring operations across components.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "currently supports updating import/require statements when component names or dependencies change.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "useful for maintaining code consistency after renaming or restructuring components."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit refactor <sub-command>")), (0, _react2.mdx)("h3", null, "refactor dependency-name"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
@@ -9975,7 +10117,13 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "<new-id>"), " arguments can be either a component-id or a package-name."), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "remote"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": manage set of tracked bit scope(s)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": manage remote scopes for self-hosted environments", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "configure connections to self-hosted remote scopes via HTTP or file protocol.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "note: this command is only needed for self-hosted scopes. when using bit.cloud, remote scopes are automatically configured.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "remotes are bare scopes that store exported components and enable collaboration across teams."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit remote")), (0, _react2.mdx)("h3", null, "remote add"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
@@ -10151,9 +10299,13 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": remove component(s) from the local workspace", (0, _react2.mdx)("br", {
+  }, "Description"), ": untrack components from the workspace", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "to mark components as deleted on the remote scope, use \"bit delete\"."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }), "\n", "removes components from the local workspace only - stops tracking them in .bitmap and deletes their files by default.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "does not affect remote scopes - to delete components from remotes, use \"bit delete\" instead.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "use --keep-files to preserve component files while only removing the tracking."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit remove <component-pattern>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -10266,7 +10418,13 @@ function MDXContent(_ref) {
     "align": null
   }, "skip confirmation")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "rename"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": rename component. if exported, create a new component and delete the original component. otherwise just renames current component"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": change a component name", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "renames a component and optionally refactors dependent code to use the new name.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "for exported components: creates a new component with the new name and marks the original as deleted.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "for local components: simply renames the existing component in place."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit rename <current-name> <new-name>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -10424,12 +10582,13 @@ function MDXContent(_ref) {
     "align": null
   }, "relative path in the workspace to place new component in. by default, the directory of the new component is from your workspace's \"defaultScope\" value")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "reset"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": revert tagged or snapped versions for component(s)", (0, _react2.mdx)("br", {
+  }, "Description"), ": revert local tags and snaps to previous versions", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", (0, _react2.mdx)("a", {
-    parentName: "p",
-    "href": "https://bit.dev/components/tags#undoing-a-tag"
-  }, "https://bit.dev/components/tags#undoing-a-tag")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }), "\n", "removes local component versions (tags/snaps) that haven't been exported yet.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "by default reverts all local versions. use --head to revert only the latest version.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "useful for undoing mistakes before exporting. exported versions cannot be reset."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit reset [component-pattern]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -10553,7 +10712,11 @@ function MDXContent(_ref) {
     "align": null
   }, "reset only components that were never exported")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "revert"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": replace the current component files by the specified version, leave the version intact"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": replace component files with specified version while preserving current version", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "replaces component source files with files from the specified version but keeps the current component version.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "useful for reverting file changes without changing the component's version history. different from checkout which changes the version."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit revert <component-pattern> <to>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -10654,7 +10817,13 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": locally run an app component (independent of bit's dev server)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": start an application component locally", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "runs application components in their own development server, separate from the \"bit start\" UI.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "apps are components that create deployable applications (React apps, Node.js servers, etc.).", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "when no app name is specified, automatically detects and runs the app if only one exists in the workspace."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit run [app-name]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -10795,11 +10964,13 @@ function MDXContent(_ref) {
     "align": null
   }, "the arguments passing to the app. for example, --args=\"--a=1 --b\". don't forget to use quotes to wrap the value to escape special characters.")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "schema"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": extracts and displays the API schema (types, functions, classes, interfaces) of the specified component/s.", (0, _react2.mdx)("br", {
+  }, "Description"), ": display component API schema and type definitions", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "Extracts TypeScript definitions to provide a comprehensive view of a component's public API.", (0, _react2.mdx)("br", {
+  }), "\n", "extracts and displays the public API structure of components including types, functions, classes, and interfaces.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "Shows detailed information about exported elements including classes, interfaces, functions, types, and enums with their respective signatures and documentation."), (0, _react2.mdx)("p", null, "you can use a ", (0, _react2.mdx)("inlineCode", {
+  }), "\n", "shows detailed type information, function signatures, and JSDoc documentation for exported elements.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "useful for understanding component interfaces and generating documentation."), (0, _react2.mdx)("p", null, "you can use a ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "<pattern>"), " for multiple component ids, such as ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -10870,7 +11041,13 @@ function MDXContent(_ref) {
     "align": null
   }, "return the component schema in json format")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "scope"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": manage the scope-name for components"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": manage component scope names and assignments", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "configure scope assignments for components including setting default scopes and renaming existing scopes.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "scopes determine where components are stored and published, forming the first part of component IDs.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "essential for organizing components and managing component namespaces across teams."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit scope <sub-command>")), (0, _react2.mdx)("h3", null, "scope set"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
@@ -11252,7 +11429,13 @@ function MDXContent(_ref) {
     "align": null
   }, "do not install packages of the imported components")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "set-peer"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": set a component as always peer"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": configure component to always be installed as peer dependency", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "marks a component to always be treated as a peer dependency when used by other components.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "useful for shared libraries that should be provided by the consuming application.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "the specified version range will be used when adding this component as a peer dependency."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit set-peer <component-id> <range>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -11290,9 +11473,15 @@ function MDXContent(_ref) {
   }, "range")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "the default range to use for the componnent, when added to peerDependencies")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "show"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "the default range to use for the component, when added to peerDependencies")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "show"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+    parentName: "p"
+  }, "Description"), ": display component metadata, dependencies, and configuration", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "shows detailed information about a component including its version, dependencies, environment, and other metadata.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "note: to see file changes made in a specific version, use ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "Description"), ": display the component's essential information"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "bit diff <component> <version> --parent"), "."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit show <component-name>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -11418,7 +11607,13 @@ function MDXContent(_ref) {
     "align": null
   }, "legacy-only. compare current file system component to its latest tagged version ", "[default=latest]")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "snap"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": create an immutable and exportable component snapshot (non-release version)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": create immutable component snapshots for development versions", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "creates snapshots with hash-based versions for development and testing. snapshots are immutable and exportable.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "by default snaps only new and modified components. use for development iterations before creating semantic version tags.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "snapshots maintain component history and enable collaboration without formal releases."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit snap [component-pattern]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -11682,7 +11877,13 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": run the ui/development server"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": launch the Bit development server", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "starts the local development server providing a UI to browse, preview, and interact with components.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "works in both workspaces and scopes. opens automatically in your browser at http://localhost:3000 (or specified port).", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "includes hot module reloading for development."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit start [component-pattern]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -11866,7 +12067,11 @@ function MDXContent(_ref) {
     "align": null
   }, "name of the ui root to use, e.g. \"teambit.scope/scope\" or \"teambit.workspace/workspace\"")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "stash"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": stash modified components"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": temporarily save and restore component changes", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "temporarily stores modified component files without creating versions.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "allows saving work-in-progress changes and switching context, then restoring changes later."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit stash <sub-command>")), (0, _react2.mdx)("h3", null, "stash save"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
@@ -12092,7 +12297,13 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": present the current status of components in the workspace, including indication of detected issues"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": show workspace component status and issues", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "displays the current state of all workspace components including new, modified, staged, and problematic components.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "identifies blocking issues that prevent tagging/snapping and provides warnings with --warnings flag.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "essential for understanding workspace health before versioning components."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit status")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -12216,7 +12427,11 @@ function MDXContent(_ref) {
     "align": null
   }, "do not check for circular dependencies to get the results quicker")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "system"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": system operations"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": access system-level operations and debugging tools", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "provides commands for system-level operations including viewing and tailing debug logs.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "useful for troubleshooting issues and monitoring Bit's internal operations in real-time."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit system <sub-command>")), (0, _react2.mdx)("h3", null, "system log"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
@@ -12240,14 +12455,16 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": create an immutable and exportable component snapshot, tagged with a release version.", (0, _react2.mdx)("br", {
+  }, "Description"), ": create immutable component snapshots with semantic version tags", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "if no patterns are provided, it will tag all new and modified components.", (0, _react2.mdx)("br", {
+  }), "\n", "creates tagged versions using semantic versioning (semver) for component releases. tags are immutable and exportable.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "if patterns are entered, you can specify a version per pattern using \"@\" sign, e.g. bit tag ", (0, _react2.mdx)("a", {
+  }), "\n", "by default tags all new and modified components. supports version specification per pattern using \"@\" (e.g. ", (0, _react2.mdx)("a", {
     parentName: "p",
     "href": "mailto:foo@1.0.0"
-  }, "foo@1.0.0"), " bar@minor baz@major"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "foo@1.0.0"), ", bar@minor).", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "use for official releases. for development versions, use 'bit snap' instead."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit tag [component-patterns...]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -12684,9 +12901,9 @@ function MDXContent(_ref) {
     "align": null
   }, "UNSUPPORTED YET. in case a component is checked out to an older version, tag it without changing the head")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "templates"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": list available templates for \"bit create\" and \"bit new\"", (0, _react2.mdx)("br", {
+  }, "Description"), ": list available templates for creating components and workspaces", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "list components templates when inside bit-workspace (for bit-create), otherwise, list workspace templates (for bit-new)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }), "\n", "Lists available templates. Inside a workspace it shows component templates for 'bit create'; outside a workspace it shows workspace templates for 'bit new'."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit templates")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -12762,7 +12979,13 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": test components in the workspace. by default only runs tests for new and modified components"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": run component tests", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "executes tests using the testing framework configured by each component's environment (Jest, Mocha, etc.).", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "by default only runs tests for new and modified components. use --unmodified to test all components.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "supports watch mode, coverage reporting, and debug mode for development workflows."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit test [component-pattern]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -12961,7 +13184,9 @@ function MDXContent(_ref) {
     "align": null
   }, "return the results in json format")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "undeprecate"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": undeprecate a deprecated component (local/remote)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": remove the deprecation status from a component", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "reverses the deprecation of a component, removing warnings and allowing normal use again."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit undeprecate <id>")), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "uninstall"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
@@ -12971,13 +13196,11 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": uninstall dependencies"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": remove dependencies from workspace", (0, _react2.mdx)("br", {
     parentName: "p"
-  }, "bit uninstall [packages...]")), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "unset-peer"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }), "\n", "removes specified packages from workspace.jsonc dependency policy and runs install to update node_modules."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "Description"), ": unset a component as always peer"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit unset-peer <component-id>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "bit uninstall [packages...]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -13000,20 +13223,18 @@ function MDXContent(_ref) {
     "align": null
   }, (0, _react2.mdx)("inlineCode", {
     parentName: "td"
-  }, "component-id")), (0, _react2.mdx)("td", {
+  }, "packages...")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "the component to unset as always peer")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "update"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
-    parentName: "p"
-  }, "Alias"), ": ", (0, _react2.mdx)("inlineCode", {
+  }, "list of package names to remove from workspace dependencies")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "unset-peer"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "up"), (0, _react2.mdx)("br", {
+  }, "Description"), ": remove always-peer configuration from component", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", (0, _react2.mdx)("strong", {
+  }), "\n", "removes the always-peer marking from a component, allowing it to be installed as a regular dependency.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }, "Description"), ": update dependencies. By default, dependencies are updated to the highest semver compatible versions."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }), "\n", "reverses the effect of 'bit set-peer' command. the component will be treated normally in dependency resolution."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit update [package-patterns...]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "bit unset-peer <component-id>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -13036,12 +13257,26 @@ function MDXContent(_ref) {
     "align": null
   }, (0, _react2.mdx)("inlineCode", {
     parentName: "td"
-  }, "package-patterns...")), (0, _react2.mdx)("td", {
+  }, "component-id")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "a string list of package names, or patterns (separated by spaces or commas), e.g. \"@teambit/", (0, _react2.mdx)("strong", {
-    parentName: "td"
-  }, ",@my-org/ui."), "\". The patterns should be in glob format. By default, all packages are selected.")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "the component to unset as always peer")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "update"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+    parentName: "p"
+  }, "Alias"), ": ", (0, _react2.mdx)("inlineCode", {
+    parentName: "p"
+  }, "up"), (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", (0, _react2.mdx)("strong", {
+    parentName: "p"
+  }, "Description"), ": update workspace dependencies to newer versions", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "updates dependencies in workspace.jsonc to newer versions and runs install to apply changes.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "by default, updates to highest semver-compatible versions. use --major, --minor, or --patch for specific version types.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "supports glob patterns to update specific packages. prompts for confirmation unless --yes is specified."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+    parentName: "p"
+  }, "bit update [package-patterns...]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -13050,108 +13285,11 @@ function MDXContent(_ref) {
     "align": null
   }, (0, _react2.mdx)("strong", {
     parentName: "th"
-  }, "Option")), (0, _react2.mdx)("th", {
-    parentName: "tr",
-    "align": "center"
-  }, (0, _react2.mdx)("strong", {
-    parentName: "th"
-  }, "Option alias")), (0, _react2.mdx)("th", {
-    parentName: "tr",
-    "align": null
-  }, (0, _react2.mdx)("strong", {
-    parentName: "th"
-  }, "Description")))), (0, _react2.mdx)("tbody", {
-    parentName: "table"
-  }, (0, _react2.mdx)("tr", {
-    parentName: "tbody"
-  }, (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "--yes")), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": "center"
-  }, (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "-y")), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, "automatically update all outdated versions for packages specified in pattern (all if no pattern supplied) - use carefully as could result in breaking updates for dependencies")), (0, _react2.mdx)("tr", {
-    parentName: "tbody"
-  }, (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "--patch")), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": "center"
-  }), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, "update to the latest patch version. Semver rules are ignored")), (0, _react2.mdx)("tr", {
-    parentName: "tbody"
-  }, (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "--minor")), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": "center"
-  }), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, "update to the latest minor version. Semver rules are ignored")), (0, _react2.mdx)("tr", {
-    parentName: "tbody"
-  }, (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "--major")), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": "center"
-  }), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, "update to the latest major version. Semver rules are ignored")), (0, _react2.mdx)("tr", {
-    parentName: "tbody"
-  }, (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "--semver")), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": "center"
-  }), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, "update to the newest version respecting semver")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "version"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
-    parentName: "p"
-  }, "Description"), ": shows bit version"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit version")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
-    parentName: "table"
-  }, (0, _react2.mdx)("tr", {
-    parentName: "thead"
-  }, (0, _react2.mdx)("th", {
-    parentName: "tr",
-    "align": null
-  }, (0, _react2.mdx)("strong", {
-    parentName: "th"
-  }, "Option")), (0, _react2.mdx)("th", {
+  }, "Arg")), (0, _react2.mdx)("th", {
     parentName: "tr",
     "align": "center"
   }, (0, _react2.mdx)("strong", {
     parentName: "th"
-  }, "Option alias")), (0, _react2.mdx)("th", {
-    parentName: "tr",
-    "align": null
-  }, (0, _react2.mdx)("strong", {
-    parentName: "th"
   }, "Description")))), (0, _react2.mdx)("tbody", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
@@ -13161,31 +13299,12 @@ function MDXContent(_ref) {
     "align": null
   }, (0, _react2.mdx)("inlineCode", {
     parentName: "td"
-  }, "--json")), (0, _react2.mdx)("td", {
+  }, "package-patterns...")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, (0, _react2.mdx)("inlineCode", {
+  }, "a string list of package names, or patterns (separated by spaces or commas), e.g. \"@teambit/", (0, _react2.mdx)("strong", {
     parentName: "td"
-  }, "-j")), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, "return the version in json format")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "version-history"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
-    parentName: "p"
-  }, "Alias"), ": ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "vh"), (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", (0, _react2.mdx)("strong", {
-    parentName: "p"
-  }, "Description"), ": manage the version-history of components"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit version-history <sub-command>")), (0, _react2.mdx)("h3", null, "version-history graph"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
-    parentName: "p"
-  }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "version-history graph <component-id>")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
-    parentName: "p"
-  }, "Description"), ": generate a graph of the version history of a component and save as an SVG file"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, ",@my-org/ui."), "\". The patterns should be in glob format. By default, all packages are selected.")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -13213,77 +13332,71 @@ function MDXContent(_ref) {
     "align": null
   }, (0, _react2.mdx)("inlineCode", {
     parentName: "td"
-  }, "--short-hash")), (0, _react2.mdx)("td", {
+  }, "--yes")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
   }, (0, _react2.mdx)("inlineCode", {
     parentName: "td"
-  }, "-s")), (0, _react2.mdx)("td", {
+  }, "-y")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "show only 9 chars of the hash")), (0, _react2.mdx)("tr", {
+  }, "automatically update all outdated versions for packages specified in pattern (all if no pattern supplied) - use carefully as could result in breaking updates for dependencies")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
   }, (0, _react2.mdx)("inlineCode", {
     parentName: "td"
-  }, "--mark <string>")), (0, _react2.mdx)("td", {
+  }, "--patch")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "-m")), (0, _react2.mdx)("td", {
+  }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "paint the given node-ids in the graph in red color, for multiple, separate by commas")), (0, _react2.mdx)("tr", {
+  }, "update to the latest patch version. Semver rules are ignored")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
   }, (0, _react2.mdx)("inlineCode", {
     parentName: "td"
-  }, "--png")), (0, _react2.mdx)("td", {
+  }, "--minor")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "save the graph as a png file instead of svg. requires \"graphviz\" to be installed")), (0, _react2.mdx)("tr", {
+  }, "update to the latest minor version. Semver rules are ignored")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
   }, (0, _react2.mdx)("inlineCode", {
     parentName: "td"
-  }, "--layout <name>")), (0, _react2.mdx)("td", {
+  }, "--major")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "-l")), (0, _react2.mdx)("td", {
+  }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "GraphVis layout. default to \"dot\". options are ", "[circo, dot, fdp, neato, osage, patchwork, sfdp, twopi]")), (0, _react2.mdx)("tr", {
+  }, "update to the latest major version. Semver rules are ignored")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
   }, (0, _react2.mdx)("inlineCode", {
     parentName: "td"
-  }, "--limit <number>")), (0, _react2.mdx)("td", {
+  }, "--semver")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "limit the number of nodes in the graph (starting from the heads)")))), (0, _react2.mdx)("h3", null, "version-history show"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
-    parentName: "p"
-  }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
+  }, "update to the newest version respecting semver")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "version"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "version-history show <component-id>")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "Description"), ": display the installed Bit version"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "Description"), ": show the version-history of a component"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "bit version")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -13311,21 +13424,6 @@ function MDXContent(_ref) {
     "align": null
   }, (0, _react2.mdx)("inlineCode", {
     parentName: "td"
-  }, "--short-hash")), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": "center"
-  }, (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "-s")), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, "show only 9 chars of the hash")), (0, _react2.mdx)("tr", {
-    parentName: "tbody"
-  }, (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
   }, "--json")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
@@ -13334,122 +13432,15 @@ function MDXContent(_ref) {
   }, "-j")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "json format")))), (0, _react2.mdx)("h3", null, "version-history build"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "return the version in json format")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "watch"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": watch and compile components on file changes", (0, _react2.mdx)("br", {
     parentName: "p"
-  }, "version-history build <component-pattern>")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }), "\n", "monitors component files for changes and automatically recompiles them using their environment's configured compiler.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }, "Description"), ": rebuild the version history of a component. helpful when it got corrupted for some reason"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
-    parentName: "table"
-  }, (0, _react2.mdx)("tr", {
-    parentName: "thead"
-  }, (0, _react2.mdx)("th", {
-    parentName: "tr",
-    "align": null
-  }, (0, _react2.mdx)("strong", {
-    parentName: "th"
-  }, "Arg")), (0, _react2.mdx)("th", {
-    parentName: "tr",
-    "align": "center"
-  }, (0, _react2.mdx)("strong", {
-    parentName: "th"
-  }, "Description")))), (0, _react2.mdx)("tbody", {
-    parentName: "table"
-  }, (0, _react2.mdx)("tr", {
-    parentName: "tbody"
-  }, (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "component-pattern")), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": "center"
-  }, "component name, component id, or component pattern. use component pattern to select multiple components. wrap the pattern with quotes. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/", "*", "*", ", !ui/button\". use '$' prefix to filter by states/attributes, e.g. '$deprecated', '$modified' or '$env:teambit.react/react'. use ", (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "bit pattern --help"), " to understand patterns better and ", (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "bit pattern <pattern>"), " to validate the pattern.")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
-    parentName: "table"
-  }, (0, _react2.mdx)("tr", {
-    parentName: "thead"
-  }, (0, _react2.mdx)("th", {
-    parentName: "tr",
-    "align": null
-  }, (0, _react2.mdx)("strong", {
-    parentName: "th"
-  }, "Option")), (0, _react2.mdx)("th", {
-    parentName: "tr",
-    "align": "center"
-  }, (0, _react2.mdx)("strong", {
-    parentName: "th"
-  }, "Option alias")), (0, _react2.mdx)("th", {
-    parentName: "tr",
-    "align": null
-  }, (0, _react2.mdx)("strong", {
-    parentName: "th"
-  }, "Description")))), (0, _react2.mdx)("tbody", {
-    parentName: "table"
-  }, (0, _react2.mdx)("tr", {
-    parentName: "tbody"
-  }, (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "--from-snap <snap>")), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": "center"
-  }), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, "build the version history from a specific snap. the pattern must be a single component-id")), (0, _react2.mdx)("tr", {
-    parentName: "tbody"
-  }, (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "--from-all-lanes")), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": "center"
-  }), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, "build the version history from the heads of all lanes that include this component")), (0, _react2.mdx)("tr", {
-    parentName: "tbody"
-  }, (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "--delete-existing")), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": "center"
-  }), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, "delete the existing version history before building it")), (0, _react2.mdx)("tr", {
-    parentName: "tbody"
-  }, (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "--remote <scope>")), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": "center"
-  }), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, "make the change on the remote scope")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "watch"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
-    parentName: "p"
-  }, "Description"), ": automatically recompile modified components (on save)", (0, _react2.mdx)("br", {
+  }), "\n", "enables immediate feedback during development by keeping components compiled as you work.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "by default, the watcher doesn't use polling, to keep the CPU idle.", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "if this doesn't work well for you, run \"bit config set watch_use_polling true\" to use polling."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }), "\n", "by default uses file system events (not polling) to minimize CPU usage - enable polling with \"bit config set watch_use_polling true\" if needed."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit watch")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -13571,11 +13562,23 @@ function MDXContent(_ref) {
     "align": null
   }, "trigger recompilation of the specified component regardless of what changed. helpful when this comp-id must be a bundle")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "whoami"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": display the currently logged in user"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": display the currently authenticated Bit Cloud user", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "shows the username of the currently logged in Bit Cloud account.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "verifies authentication status with the cloud service and displays the active username.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "useful for confirming authentication before publishing or when switching between accounts."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit whoami")), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "why"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": find components that use the specified dependency"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": find components that use the specified dependency", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "searches workspace components to find which ones depend on the specified package or component.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "useful for understanding dependency usage before removing packages or when refactoring components.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "supports both exact version matching and package name patterns."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit why <dependency-name>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -13645,7 +13648,13 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": manage workspace config files"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": generate IDE configuration files", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "writes configuration files (tsconfig.json, eslintrc.js, etc.) to your workspace for better IDE support.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "automatically generates configs based on your components' environments and settings.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "useful for enabling proper IntelliSense, linting, and type-checking in your IDE."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit ws-config <sub-command>")), (0, _react2.mdx)("h3", null, "ws-config write"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"