REPOMATIC-PR-BODY(1) REPOMATIC-PR-BODY(1)

repomatic pr-body - Generate PR body with workflow metadata

repomatic pr-body [OPTIONS]

Generate a PR body with a collapsible workflow metadata block.

Reads GITHUB_* environment variables to produce a <details> block listing the workflow metadata (documentation, trigger, actor, ref, commit, job, workflow, run).

The prefix can be set via --template (built-in templates), --prefix (arbitrary content) or --prefix-file (the same content read from a file). If a template and a prefix are both given, the prefix is prepended before the rendered template content.

Content to prepend before the metadata details block.
Read the prefix from a file instead of --prefix, for a report too large to pass as an argument. Wins over --prefix when both are given.
Built-in template to render the content from.
Template file to render the content from, instead of --template: markdown with optional YAML frontmatter, for project-specific content. Set 'footer: false' in its frontmatter: the metadata block already carries the attribution footer.
Pass an arbitrary key/value pair to the template. Repeat to provide multiple. Use this to feed template variables not covered by the dedicated flags. Example: --template-arg channel=Nix.
Read a template value from a file. Repeat to provide multiple. Use this for a value with no ceiling on its size, like a generated table: a report travels as a path rather than inline. Example: --template-arg-file summary=proposal.md.
Version string passed to the template (like 1.2.0).
Version part passed to the bump-version template.
Write the PR body to this file. github-actions writes the body, title and commit message as step outputs.
Format of the --output file. github-actions writes step outputs, for $GITHUB_OUTPUT.
Show this message and exit.

Content to prepend before the metadata details block.
Read the prefix from a file instead of --prefix, for a report too large to pass as an argument. Wins over --prefix when both are given.
Built-in template to render the content from.
Template file to render the content from, instead of --template: markdown with optional YAML frontmatter, for project-specific content. Set 'footer: false' in its frontmatter: the metadata block already carries the attribution footer.
Pass an arbitrary key/value pair to the template. Repeat to provide multiple. Use this to feed template variables not covered by the dedicated flags. Example: --template-arg channel=Nix.
Read a template value from a file. Repeat to provide multiple. Use this for a value with no ceiling on its size, like a generated table: a report travels as a path rather than inline. Example: --template-arg-file summary=proposal.md.
Version string passed to the template (like 1.2.0).
Version part passed to the bump-version template.
Write the PR body to this file. github-actions writes the body, title and commit message as step outputs.
Format of the --output file. github-actions writes step outputs, for $GITHUB_OUTPUT.
Show this message and exit.

0
Success.
1
A runtime error, an aborted prompt (Ctrl-D), or a declined confirmation.
2
A usage error: unknown option, invalid value, missing operand, or an unparsable configuration file.
130
Interrupted with Ctrl-C: the process ends by SIGINT, reported as 130.

Preview metadata block locally

repomatic pr\-body

CI: write as GitHub Actions step outputs

repomatic pr\-body \-\-output "$GITHUB_OUTPUT" \-\-output\-format github\-actions

Use a built-in template

repomatic pr\-body \-\-template bump\-version \-\-version 1.2.0 \-\-part minor

Use a downstream-shipped template with custom variables

repomatic pr\-body \-\-template\-file path/to/template.md \-\-template\-arg fruit=mango \-\-template\-arg crate=10

With a prefix above the metadata block

repomatic pr\-body \-\-prefix "Fix formatting"

Kevin Deldycke

2026-10-29 8.0.1.dev0