Command: api merge


guild api merge [OPTIONS] [RUN]

Provides merge support.

Use ‘–preview’ to generate JSON output describing a merge.

This command does not prompt for user input. If ‘–yes’ is not specified, the command fails with an error.


-f, --format Format the JSON outout.
-F, --filter EXPR Filter runs using a filter expression. See Filter by Expression above for details…
-Fo, --operation VAL Filter runs with operations matching VAL.
-Fl, --label VAL Filter runs with labels matching VAL. To show unlabeled runs, use --unlabeled.
-Fu, --unlabeled Filter only runs without labels.
-Ft, --tag TAG Filter runs with TAG.
-Fc, --comment VAL Filter runs with comments matching VAL.
-Fm, --marked Filter only marked runs.
-Fn, --unmarked Filter only unmarked runs.
-Fs, --started RANGE Filter only runs started within RANGE. See above for valid time ranges.
-Fd, --digest VAL Filter only runs with a matching source code digest.
-Sr, --running Filter only runs that are still running.
-Sc, --completed Filter only completed runs.
-Se, --error Filter only runs that exited with an error.
-St, --terminated Filter only runs terminated by the user.
-Sp, --pending Filter only pending runs.
-Ss, --staged Filter only staged runs.
-t, --target-dir DIR Directory to merge run files to (required if project directory cannot be determined for the run).
-s, --sourcecode Only copy run source code. Implies use of --skip-deps. Cannot be used with --skip-sourcecode.
-a, --all Copy all run files. May be used with --skip-sourcecode, --skip-deps, and --exclude to copy all but the skipped/excluded files.
-S, --skip-sourcecode Don’t copy run source code.
-D, --skip-deps Don’t copy project-local dependencies.
-x, --exclude PATTERN Exclude a file or pattern (may be used multiple times).
-S, --no-summary Don’t generate a run summary.
--summary-name NAME Name used for the run summary. Use ‘${run_id}’ in the name to include the run ID.
-p, --preview Show what would happen on a merge.
-y, --yes Don’t prompt before copying files.
--replace Allow replacement of existing files. Cannot be used with --no-replace
--no-replace Fail if any target file would be replaced, even if that file is committed to the project VCS. Cannot be used with --replace.
--help Show this message and exit.

Guild AI version 0.8.2