Skip to main content

Workspace Management

Windmill CLI can be used on several workspaces from several instances.

List workspaces

You can list all the workspaces you have access to using:

wmill workspace

The currently selected workspace will be underlined.

Adding a workspace


The wmill CLI is capable of handling working with many remotes & workspaces. Each combination of remote & workspace is registered with together with a name locally using:

wmill workspace add [workspace_name] [workspace_id] [remote]

You can login to the workspace with a token or directly from browser.

The new workspace will automatically be switched to.

Arguments

ArgumentDescription
workspace_nameThe name of the workspace. Note: This is a name used to refer this workspace locally on your machine. It can be same or different from your remote instance
workspace_idThe ID of the workspace.remote. The workspace ID is displayed in the switch workspace menu.
remoteThe remote URL.

Options

OptionparameterDescription
-c, --createNoneCreate the workspace if it does not exist.
--create-workspace-name<workspace_name>Specify the workspace name. Ignored if --create is not specified or the workspace already exists. Defaults to the workspace ID.
--create-username<username>Specify your own username in the newly created workspace. Ignored if --create is not specified or the workspace already exists. Defaults to "admin".

Examples

  1. Prompts for the workspace name, ID, and remote URL.
wmill workspace add
  1. Adds a workspace with the name "MyWorkspace", ID "workspace123", and remote URL "https://example.com/myworkspace".
wmill workspace add MyWorkspace workspace123 https://example.com/myworkspace
  1. This command creates a workspace with the name "MyWorkspace2," using the provided username "john.doe."
wmill workspace add --create --create-workspace-name MyWorkspace2 --create-username john.doe

Switch Workspaces

The wmill workspace switch command allows you to switch to another workspace. It requires specifying the target workspace as a positional argument and performs the necessary operations to switch to that workspace. Here is the documentation for the wmill workspace switch command:

wmill workspace switch <workspace_name>

Arguments

ArgumentDescription
workspace_nameThe name of the workspace to switch to.

Examples

  1. Switch to the workspace named "MyWorkspace".
 wmill workspace switch MyWorkspace

Selected Workspace

The currently selected workspace will be used for all operations. This workspace is underlined in the list of workspaces.

Removing a workspace

The wmill workspace remove command allows you to remove a workspace from the CLI.

wmill workspace remove <workspace_name>

Arguments

ArgumentDescription
workspace_nameThe name of the workspace to remove.

Examples

  1. Remove the workspace named "MyWorkspace".
wmill workspace remove MyWorkspace
Get help

At any point you can ask help with the command -h after a given instruction to see the list of options & commands.

Example here just using windmill -h:


CLI help

whoami

The wmill workspace whoami command allows you to display the currently active user and the active workspace.

wmill workspace whoami