Skip to main content

Command: workspace list

The tofu workspace list command is used to list all existing workspaces.

Usage​

Usage: tofu workspace list [DIR]

The command will list all existing workspaces. The current workspace is indicated using an asterisk (*) marker.

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.

Example​

Code Block
$ tofu workspace list
  default
* development
  jsmith-test