Releases
Generated automatically at build time from the madtea repository - do not edit here. Source: docs/reference/releases.md.
CLI Commands
madtea release assets edit
Rename or edit a release asset
| Flag | Type | Default | Description |
|---|---|---|---|
--name | string | New name for the asset |
madtea release assets get
Get a specific release asset
madtea release assets list
List assets on a release
madtea release by-tag
Get a release by tag name
madtea release create
Create a release from a tag
| Flag | Type | Default | Description |
|---|---|---|---|
--asset | stringSlice | [] | Files to attach (can be repeated, supports globs) |
--draft | bool | false | Create as draft release |
--hide-archive-links | bool | false | Hide auto-generated archive download links |
--notes | string | Release notes (inline text) | |
--notes-file | string | Read release notes from file (use - for stdin) | |
--prerelease | bool | false | Mark as pre-release |
--target | string | Target commit or branch for the tag | |
--title | string | Release title (defaults to tag name) |
madtea release delete
Delete a release (refused — use the forge web UI)
madtea release delete-asset
Delete an asset from a release
madtea release delete-by-tag
Delete a release by tag name (refused — use the forge web UI)
madtea release download
Download release assets to disk
| Flag | Type | Default | Description |
|---|---|---|---|
--dir | string | Directory to download assets into (default: current directory) | |
--pattern | string | Glob pattern to filter assets by name (e.g. ‘*.tar.gz’) |
madtea release edit
Edit release fields
| Flag | Type | Default | Description |
|---|---|---|---|
--draft | string | Set draft status (true|false) | |
--hide-archive-links | string | Hide auto-generated archive links (true|false) | |
--notes | string | Release notes/body | |
--pre-release | string | Set pre-release status (true|false) | |
--tag | string | Rename the underlying git tag | |
--target | string | Target commit SHA or branch name | |
--title | string | Release title |
madtea release get
Get release details by ID or tag name
madtea release latest
Get the latest release
madtea release list
List releases
| Flag | Type | Default | Description |
|---|---|---|---|
--draft | string | Filter by draft status (true/false) | |
--exclude-drafts | bool | false | Exclude draft releases |
--exclude-pre-releases | bool | false | Exclude pre-release releases |
--limit | int | 0 | Maximum number of items to return (0 = server default) |
--page | int | 0 | Page number for pagination (0 = first page) |
--pre-release | string | Filter by pre-release status (true/false) |
madtea release upload
Upload assets to a release
MCP Tools
madt_releases
Manage releases and release assets: list, get, latest, create, edit, upload/download/rename/delete assets. Irreversible release deletion is not a madtea operation on any surface — delete a release in the forge web UI.
Output schema: declared
One tool, action-dispatched. Set action to one of:
action="assets_edit"
Rename a release asset.
Required: id, asset_id, asset_name
action="assets_get"
Get details of a specific release asset.
Required: id, asset_id
action="assets_list"
List assets for a release.
Required: id
action="create"
Create a release from a git tag. The tag need not exist: the server creates it at target_commitish (default: default-branch HEAD); for draft=true the tag is created on publish. No git tag push is needed.
Required: tag
Optional: title, body, target_commitish, draft, prerelease, hide_archive_links
action="delete_asset"
Delete a release asset.
Required: id, asset_id
action="download"
Download release assets to disk by release ID or tag. Downloads all assets by default; use pattern to filter.
One of: id | tag
Optional: pattern, dir
action="edit"
Edit release fields. Pass any of title, body, draft, prerelease, target_commitish, tag (rename), hide_archive_links.
Required: id
Optional: title, body, tag, target_commitish, draft, prerelease, hide_archive_links
action="get"
Get one release (id or tag) or batch (ids). Items in ids beginning with a digit are looked up by ID, others by tag — so a digit-leading tag (e.g. ‘1.2.0’) must be fetched alone via tag=. In a batch, ids that fail to resolve are silently omitted from the output.
One of: id | ids | tag
action="latest"
Get the latest published release.
action="list"
List releases. Supports client-side filter by draft/prerelease status.
Optional: limit, page, draft, prerelease, exclude_drafts, exclude_pre_releases
action="upload"
Upload file(s) as release assets. Accepts file paths with glob patterns.
Required: id, asset_paths
Canonical source: docs/reference/releases.md in the madtea repo.