[UX]: Better UX for switching between projects using the CLI #2553

Author: peterschmidt85

docs/docs/concepts/projects.md

@@ -49,11 +49,11 @@ and when using the CLI or API.
 
 ### Setting up the CLI
 
-To use the CLI with a specific project, run the `dstack config` command with the server address, user token, and project name.
+You can configure multiple projects on the client and set the default project using the [`dstack project`](../reference/cli/dstack/project.md) CLI command. 
 
 You can find the command on the project’s settings page:
 
-<img src="https://dstack.ai/static-assets/static-assets/images/dstack-projects-project-cli.png" width="750px" />
+<img src="https://dstack.ai/static-assets/static-assets/images/dstack-projects-project-cli-v2.png" width="750px" />
 
 ??? info "API"
     In addition to the UI, managing projects, users, and user permissions can also be done via the [REST API](../reference/api/rest/index.md).

docs/docs/reference/cli/dstack/config.md

@@ -1,5 +1,8 @@
 # dstack config
 
+!!! info "Deprecated"
+    The `dstack config` is deprecated. Use [`dstack project`](project.md) instead.
+
 Both the CLI and API need to be configured with the server address, user token, and project name
 via `~/.dstack/config.yml`.
 
@@ -13,7 +16,7 @@ To use CLI and API on different machines or projects, use the `dstack config` co
 <div class="termy">
 
 ```shell
-$ dstack project --help
+$ dstack config --help
 #GENERATE#
 ```
 

docs/docs/reference/cli/dstack/project.md

@@ -0,0 +1,63 @@
+# dstack project
+
+Before the CLI can be used, it must be configured with a [project](../../../concepts/projects.md), including a project name, server address, and user token. You can configure multiple projects using the `dstack project` CLI command. The configuration is stored in `~/.dstack/config.yml`.
+
+> The `dstack server` command automatically creates the default `main` project and adds its configuration in `~/.dstack/config.yml`.
+
+The `dstack project set-default` command can be used to switch between multiple projects.
+
+## dstack project add
+
+This command adds a new project configuration.
+
+<div class="termy">
+
+```shell
+$ dstack project add --help
+#GENERATE#
+```
+
+</div>
+
+You can find the command on the project’s settings page:
+
+<img src="https://dstack.ai/static-assets/static-assets/images/dstack-projects-project-cli-v2.png" width="750px" />
+
+## dstack project list
+
+This command lists the projects configured on the client.
+
+<div class="termy">
+
+```shell
+$ dstack project list --help
+#GENERATE#
+```
+
+</div>
+
+## dstack project set-default
+
+This command sets the given project as default.
+
+<div class="termy">
+
+```shell
+$ dstack project set-default --help
+#GENERATE#
+```
+
+</div>
+
+## dstack project delete
+
+This command deletes the given project configuration.
+
+<div class="termy">
+
+```shell
+$ dstack project delete --help
+#GENERATE#
+```
+
+</div>

mkdocs.yml

@@ -245,7 +245,7 @@ nav:
             - dstack attach: docs/reference/cli/dstack/attach.md
             - dstack logs: docs/reference/cli/dstack/logs.md
             - dstack metrics: docs/reference/cli/dstack/metrics.md
-            - dstack config: docs/reference/cli/dstack/config.md
+            - dstack project: docs/reference/cli/dstack/project.md
             - dstack fleet: docs/reference/cli/dstack/fleet.md
             - dstack offer: docs/reference/cli/dstack/offer.md
             - dstack volume: docs/reference/cli/dstack/volume.md

src/dstack/_internal/cli/commands/project.py

@@ -15,14 +15,14 @@
 
 class ProjectCommand(BaseCommand):
     NAME = "project"
-    DESCRIPTION = "Manage projects"
+    DESCRIPTION = "Manage projects configs"
 
     def _register(self):
         super()._register()
         subparsers = self._parser.add_subparsers(dest="subcommand", help="Command to execute")
 
         # Add subcommand
-        add_parser = subparsers.add_parser("add", help="Add or update a project")
+        add_parser = subparsers.add_parser("add", help="Add or update a project config")
         add_parser.add_argument(
             "--name", type=str, help="The name of the project to configure", required=True
         )
@@ -43,7 +43,7 @@ def _register(self):
         add_parser.set_defaults(subfunc=self._add)
 
         # Delete subcommand
-        delete_parser = subparsers.add_parser("delete", help="Delete a project")
+        delete_parser = subparsers.add_parser("delete", help="Delete a project config")
         delete_parser.add_argument(
             "--name", type=str, help="The name of the project to delete", required=True
         )