wb - Workbench command-line interface.




The Workbench CLI allows advanced users to interact with Workbench workspaces and resources, and to perform administrative actions.

Example usage:

  • Fetch the user’s credentials and check the authentication status. wb auth login wb auth status
  • Ping the Workbench server. wb server status
  • Create a new Workbench workspace and backing Google project. Check the current context to confirm it was created successfully. wb workspace create wb status
  • List all workspaces the user has read or write access to. wb workspace list
  • To use an existing Workbench workspace, use the set command instead of create. wb workspace set –id=<workspace-id>
  • Create a Workbench-managed bucket for temporary data storage. wb resource create gcs-bucket –id=<id> –bucket-name=<name>


  • app Run applications in the workspace.
  • auth Commands to manage user credentials.
  • bq Call bq in the Workbench workspace.
  • cluster Use spark clusters in the workspace.
  • config Commands to configure the CLI.
  • pod, crg Manage Workbench pods.
  • cromwell Commands related to Cromwell workflows.
  • folder Commands related to folder.
  • gcloud Call gcloud in the Workbench workspace.
  • generate-completion Generate bash/zsh completion script for wb.
  • git Call git in the Workbench workspace.
  • group Manage groups of Workbench users.
  • gsutil Call gsutil in the Workbench workspace.
  • nextflow Call nextflow in the Workbench workspace.
  • notebook Use Notebooks in the workspace.
  • organization, org Manage workbench organizations.
  • resolve Resolve a resource to its cloud id or path.
  • resource Manage references and controlled resources in the workspace.
  • security Manage Workbench security credentials such as SSH keys.
  • server Connect to a Workbench server.
  • status Print details about the current workspace and server.
  • version Get the installed version.
  • workspace Setup a Workbench workspace.

Exit codes:

  • 0
    Successful program execution
  • 1
    User-actionable error (e.g. missing parameter, workspace not defined in the current context)
  • 2
    System or internal error (e.g. error response from the Workbench server)
  • 3
    Unexpected error (e.g. Java exception)
  • other
    Third-party application exit codes will be passed through to the caller. For example, if gcloud --malformedOption returns exit code 2, then wb gcloud --malformedOption will also return exit code 2.

Last Modified: 1 January 0001