dbt clone command

website/dbt-versions.js

@@ -31,6 +31,10 @@ exports.versions = [
 ]
 
 exports.versionedPages = [
+  {
+    "page": "reference/commands/clone",
+    "firstVersion": "1.6",
+  },
   {
     "page": "docs/collaborate/govern/project-dependencies",
     "firstVersion": "1.6",
@@ -51,7 +55,7 @@ exports.versionedPages = [
     "page": "docs/collaborate/govern/model-contracts",
     "firstVersion": "1.5",
   },
-    {
+  {
     "page": "reference/commands/show",
     "firstVersion": "1.5",
   },

website/docs/reference/commands/clone.md

@@ -0,0 +1,30 @@
+---
+title: "About dbt clone command"
+sidebar_label: "clone"
+id: "clone"
+---
+
+The `dbt clone` command clones selected nodes from the [specified state](/reference/node-selection/syntax#establishing-state) to the target schema(s). This command makes use of the `clone` materialization:
+- If your data platform supports zero-copy cloning of tables, and this model exists as a table in the other environment, dbt will create it in your environment as a clone
+- Otherwise, dbt will create a simple pointer view (`select * from` the other object)
+- By default, `dbt clone` will not recreate pre-existing relations in the current target. To override this, use the `--full-refresh` flag. 
+- You may want to specify a higher number of [threads](/docs/running-a-dbt-project/using-threads) to decrease execution time since individual clone statements are independent of one another.
+
+The `clone` command is useful for:
+- blue/green continuous deployment
+- cloning current production state into development schema(s)
+- handling incremental models in Slim CI dbt Cloud jobs
+
+```bash
+# clone all of my models from specified state to my target schema(s)
+dbt clone --state path/to/artifacts
+
+# clone one_specific_model of my models from specified state to my target schema(s)
+dbt clone --select one_specific_model --state path/to/artifacts
+
+# clone all of my models from specified state to my target schema(s) and recreate all pre-exisiting relations in the current target
+dbt clone --state path/to/artifacts --full-refresh
+
+# clone all of my models from specified state to my target schema(s), running up to 50 clone statements in parallel
+dbt clone --state path/to/artifacts --threads 50
+```

website/docs/reference/dbt-commands.md

@@ -20,6 +20,7 @@ Select the tabs that are relevant to the your development workflow. For example,
 Use the following dbt commands in the [dbt Cloud IDE](/docs/cloud/dbt-cloud-ide/develop-in-the-cloud) and use the `dbt` prefix. For example, to run the `test` command, type `dbt test`.
 
 - [build](/reference/commands/build): build and test all selected resources (models, seeds, snapshots, tests)
+- [clone](/reference/commands/clone): clone selected nodes from specified state (requires dbt 1.6 or higher)
 - [compile](/reference/commands/compile): compiles (but does not run) the models in a project
 - [deps](/reference/commands/deps): downloads dependencies for a project
 - [docs](/reference/commands/cmd-docs) : generates documentation for a project
@@ -40,6 +41,7 @@ Use the following dbt commands in the [CLI](/docs/core/about-the-cli) and use th
 
 - [build](/reference/commands/build): build and test all selected resources (models, seeds, snapshots, tests)
 - [clean](/reference/commands/clean): deletes artifacts present in the dbt project
+- [clone](/reference/commands/clone): clone selected models from specified state (requires dbt 1.6 or higher)
 - [compile](/reference/commands/compile): compiles (but does not run) the models in a project
 - [debug](/reference/commands/debug): debugs dbt connections and projects
 - [deps](/reference/commands/deps): downloads dependencies for a project

website/docs/reference/node-selection/syntax.md

@@ -91,8 +91,9 @@ dbt can leverage artifacts from a prior invocation as long as their file path is
 - [The `state:` selector](/reference/node-selection/methods#the-state-method), whereby dbt can identify resources that are new or modified
 by comparing code in the current project against the state manifest.
 - [Deferring](/reference/node-selection/defer) to another environment, whereby dbt can identify upstream, unselected resources that don't exist in your current environment and instead "defer" their references to the environment provided by the state manifest.
+- The [`dbt clone` command](/reference/commands/clone), whereby dbt can clone nodes based on their location in the manifest provided to the `--state` flag.
 
-Together, these two features enable ["slim CI"](/guides/legacy/best-practices#run-only-modified-models-to-test-changes-slim-ci). We expect to add more features in future releases that can leverage artifacts passed to the `--state` flag.
+Together, the `state:` selector and deferral enable ["slim CI"](/guides/legacy/best-practices#run-only-modified-models-to-test-changes-slim-ci). We expect to add more features in future releases that can leverage artifacts passed to the `--state` flag.
 
 ### Establishing state
 

website/sidebars.js

@@ -735,6 +735,7 @@ const sidebarSettings = {
           items: [
             "reference/commands/build",
             "reference/commands/clean",
+            "reference/commands/clone",
             "reference/commands/cmd-docs",
             "reference/commands/compile",
             "reference/commands/debug",