Synchronize remote runs.
A remote run is an operation that runs on another system. Guild keeps track of where each remote run is located and can synchronize with it. This includes downloading files generated by the run as well as updating run status.
By default, Guild synchronizes once with the remote run and
exits. If you want to automatically synchronize with the run while
watching its output, use the
You can only watch one running operation at a time. If you don't
specify a RUN with the
‑‑watch option, Guild will watch the most
recently started running operation.
When a remote status stops (it finished successfully, is terminated, or exits with an error), Guild will no longer synchronize with it.
You can synchronize specific runs by selecting them using
arguments. For more information, see SELECTING RUNS and FILTERING
You may use one or more
RUN arguments to limit the runs that are
RUN may be a run ID, a run ID prefix, or a one-based
index corresponding to a run returned by the list command.
Indexes may also be specified in ranges in the form
START is the start index and
END is the end
END may be omitted. If
omitted, all runs up to
END are selected. If
END id omitted,
all runs from
START on are selected. If both
are omitted (i.e. the
: char is used by itself) all runs are
RUN argument is not specified,
: is assumed (all runs
Filtering by operation and label
Runs may be filtered by operation using
‑‑operation. A run is
only included if any part of its full operation name, including
the package and model name, matches the value.
‑‑label to only include runs with labels matching a
‑‑label may be used multiple times to expand
the runs that are included.
‑‑unlabeled to only include runs without labels. This option
may not be used with
Watch a remote run and synchronize in the background.
|-o, --operation VAL||
Include runs with operations matching
|-l, --label VAL||
Include runs with labels matching
Include only runs without labels.
|--help||Show command help and exit.|