Workspaces/Advanced Features/ws list

ws_list - List Workspaces

List all your workspaces with details about expiration, location, and available extensions.

Basic Usage

  $ ws_list                                # List all your workspaces

Shows workspace ID, location, available extensions, creation date, and remaining time.

Common Use Cases

See what expires soon:

  $ ws_list -Rr                            # Sort by remaining time (-R), reverse (-r) = soonest first

List group workspaces:

  $ ws_list -g                             # Show workspaces from your group

For scripts (names only):

  $ ws_list -s                             # Short format, just workspace names

Check available filesystems:

  $ ws_list -l                             # List filesystem locations

All Options

Sorting:

• -N - Sort alphabetically by name
• -C - Sort by creation date
• -R - Sort by remaining time (default: most time remaining first)
• -r - Reverse sort order (combine with -R for soonest expiring first)

Display Format:

• -s - Short format (only names, for scripts)
• -t - Terse format
• -v - Verbose format with all metadata

Filtering:

• -F <location> - Show only workspaces on specific filesystem
• -g - Show group workspaces (created with -g or -G)
• -l - List available filesystem locations

Note

To list expired workspaces that can be restored, use ws_restore -l instead. See ws_restore.

For more information: ws_list -h or man ws_list