website/docs/cli/commands/workspace/list.mdx
The tofu workspace list command is used to list all existing workspaces.
Usage: tofu workspace list [DIR]
The command will list all existing workspaces. The current workspace is
indicated using an asterisk (*) marker.
:::note
Use of variables in module sources,
backend configuration,
or encryption block
requires assigning values to root module variables
when running tofu workspace list.
:::
This command also accepts the following options:
-var 'NAME=VALUE' - Sets a value for a single
input variable declared in the
root module of the configuration. Use this option multiple times to set
more than one variable. Refer to
Input Variables on the Command Line for more information.
-var-file=FILENAME - Sets values for potentially many
input variables declared in the
root module of the configuration, using definitions from a
"tfvars" file.
Use this option multiple times to include values from more than one file.
There are several other ways to set values for input variables in the root
module, aside from the -var and -var-file options. Refer to
Assigning Values to Root Module Variables for more information.
$ tofu workspace list
default
* development
jsmith-test