Controlling the workflow using Cylc GUI, TUI and CLI

Cylc GUI

Cylc GUI is a web-based interface that allows users to interact with the Cylc workflow manager. It provides a graphical representation of the workflow, allowing users to monitor the progress of tasks, view logs, and control the execution of the workflow.

Cylc Graphical User Interface

The GUI displaying a workflow using the “tree” view. @CylcDoc,2024

The GUI is accessible through a web browser, and can be launched by running the cylc gui command. This will open a new tab in your default web browser, displaying the Cylc GUI home page.

It can be deployed with Jupyter Hub to support remote and multi-user access. This is useful when you want to access the workflow manager from another computer on the same network. The central server is started by the cylc hub command.

Jupyter Hub authentication page

Jupyter Hub authentication page in a multi-user setup. @CylcDoc,2024

Cylc TUI

Cylc TUI is a terminal-based graphical interface that ports most of Cylc UI’s features to the terminal. It provides a beginner-friendly interface when you’re remotely accessing the machine running the workflow, and not exposing a Cylc Hub (JupyterHub) instance. It requires no setup, and can be opened by running the cylc tui command.

Cylc terminal user interface

The TUI showing the details of a failed job. @CylcDoc,2024

Cylc CLI

Cylc also provides a command-line interface (CLI) that allows users to interact with the workflow manager from the terminal. Here’s a cheat sheet of major subcommands.