#fj run

Manage workflow runs (Forgejo Actions)

fj run [OPTIONS] <COMMAND>

Every command also accepts the global flags: --host, --debug, --no-pager, --json-fields.

#fj run list

List workflow runs

fj run list [OPTIONS]

Options

• -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
• -L, --limit <LIMIT> — Maximum number of runs to fetch [default: 20]
• --json — Emit JSON instead of a table

#fj run view

View a workflow run, or its logs with --log / --log-failed

fj run view [OPTIONS] <RUN_ID>

Arguments

• <RUN_ID> — Run number, as shown in the # column of fj run list

Options

• -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
• --log — Print the full job log instead of the run summary
• --log-failed — Print only the log of steps that did not succeed
• -j, --job <JOB> — Job index within the run (0-based). Omit to log every job (with --log-failed, only the jobs that did not succeed)
• --attempt <ATTEMPT> — Attempt number. Defaults to the latest attempt (follows reruns)
• --json — Emit JSON instead of a table

#fj run watch

Stream a run’s logs live until the job finishes

fj run watch [OPTIONS] <RUN_ID>

Arguments

• <RUN_ID> — Run number, as shown in the # column of fj run list

Options

• -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
• -j, --job <JOB> — Job index within the run (0-based) [default: 0]
• --attempt <ATTEMPT> — Attempt number. Defaults to the latest attempt
• -i, --interval <INTERVAL> — Seconds between polls while the job is running [default: 3]

#fj run download

List or download a run’s artifacts

fj run download [OPTIONS] <RUN_ID>

Arguments

• <RUN_ID> — Run number, as shown in the # column of fj run list

Options

• -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
• -n, --name <NAME> — Download only this artifact (by name). Omit to download all
• -o, --output-dir <OUTPUT_DIR> — Output directory (default: cwd). Each artifact is written as <name>.zip
• --list — List the run’s artifacts instead of downloading
• --json — Emit JSON instead of a table

#fj run rerun

Rerun a workflow run

fj run rerun [OPTIONS] <RUN_ID>

Arguments

• <RUN_ID> — Workflow run id

Options

• -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted

#fj run cancel

Cancel an in-progress workflow run

fj run cancel [OPTIONS] <RUN_ID>

Arguments

• <RUN_ID> — Workflow run id

Options

• -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted