ls command

  1. Usage
    1. Specifying a run
    2. Remote runs
  2. Options


guild ls [OPTIONS] [RUN]

List run files.

‑‑path may be specified as a relative path pattern to limit results within the run directory to matching files.

‑‑source limits the results to run source files. If ‑‑path is specified with ‑‑source, the path pattern limits results within the source directory rather than the run directory.

Specifying a run

You may specify a run using a run ID, a run ID prefix, or a one-based index corresponding to a run returned by the list command.

If RUN isn't specified, the latest run is selected.

Remote runs

Use ‑‑remote to list files for a remote run.

REMOTE is the name of a configured remote. Use guild remotes to list available remotes.

For information on configuring remotes, see remotes.


-p, --path PATH

Path to list.

-s, --sourcecode

List source code files.

-a, --all

Show all files including Guild files.

-f, --full-path

Show full path for files.

-L, --follow-links

Follow links.

-n, --no-format

Show files without additional formatting.

-o, --operation VAL

Include runs with operations matching VAL.

-l, --label VAL

Include runs with labels matching VAL.

-u, --unlabeled

Include only runs without labels.

-M, --marked

Include only marked runs.

-U, --unmarked

Include only unmarked runs.

-R, --running

Include only runs that are still running.

-C, --completed

Include only completed runs.

-E, --error

Include only runs that exited with an error.

-T, --terminated

Include only runs terminated by the user.

-P, --pending

Include only pending runs.

-r, --remote REMOTE

List files for for remote run.

--help Show command help and exit.
Guild AI version 0.6.5.dev3