maton github release create

maton github release create <tag> [flags]

Create a release for an existing or new tag. The tag is created on –target (defaults to the repository’s default branch) if it does not already exist on the remote.

Use –generate-notes to have GitHub auto-fill the release body from the merged PRs since the previous tag.

Options

--connection <string>
Connection ID to route through (Maton-Connection header)
--discussion-category <string>
Start a release discussion in this category
--draft
Save as a draft instead of publishing
--dry-run
Print the request that would be sent without executing it
--format <string>
Output format: 'json' (default) or 'text' on supported commands
--generate-notes
Auto-generate release notes from merged PRs since the previous tag
-q, --jq <expression>
Filter JSON output using a jq expression
--latest <string>
Mark this release as the latest: 'true', 'false', or 'legacy' (defaults to GitHub's auto-detection)
-n, --notes <string>
Release notes (markdown)
--paginate
Follow next_cursor and concatenate all pages (list commands only)
--prerelease
Mark the release as prerelease
-R, --repo <owner/repo>
Target repository in owner/repo form (required)
--target <string>
Target commitish (branch, tag, or sha; defaults to the repo's default branch)
--template <string>
Format JSON output using a Go template; see "maton help formatting"
-F, --text-from-file <file>
Read notes from file (or `-` for stdin)
-t, --title <string>
Release title (defaults to the tag name)

Options inherited from parent commands

-p, --profile <string>
Profile to use for this invocation (overrides the active profile; also reads MATON_PROFILE)

Examples

$ maton github release create v1.0.0 --repo maton-ai/cli --title "v1.0.0" --notes "First stable release"
$ maton github release create v1.1.0 --repo maton-ai/cli --generate-notes --draft
$ maton github release create v1.0.0-rc1 --repo maton-ai/cli --prerelease -F notes.md

See also