Commits

Generated automatically at build time from the madtea repository - do not edit here. Source: docs/reference/commits.md.

CLI Commands

madtea commits compare

Compare two refs

madtea commits diff

Get commit as unified diff

madtea commits get

Get full commit details

madtea commits list

List commits

FlagTypeDefaultDescription
--filesboolfalseInclude file change list per commit
--limitint0Maximum number of items to return (0 = server default)
--notstringExclude commits reachable from this ref
--pageint0Page number for pagination (0 = first page)
--pathstringFilter to commits affecting this file path
--shastringBranch, tag, or commit SHA to start from
--sincestringCommits since timestamp (YYYY-MM-DD or RFC3339)
--statboolfalseInclude diff statistics
--untilstringCommits until timestamp (YYYY-MM-DD or RFC3339)
--verificationboolfalseInclude GPG signature verification info

madtea commits pr-for-commit

Get PR for a commit

madtea commits status create

Create a commit status

FlagTypeDefaultDescription
--contextstringUnique context identifier (e.g. ci/build)
--descriptionstringShort description of the status
--statestringStatus state: pending, success, error, failure, warning
--target-urlstringURL to link the status to

madtea commits status list

List commit statuses for a SHA

madtea commits statuses combined

Get combined commit status for a ref

MCP Tools

madt_commits

List, get, diff, compare commits, manage CI commit statuses, and find the PR for a commit.

Output schema: declared

One tool, action-dispatched. Set action to one of:

action="compare"

Compare two refs (branches, tags, or SHAs).

Required: base, head

action="diff"

Get a commit as unified diff (plain text).

Required: sha

action="get"

Get full commit details by SHA. Batch multiple in one call via shas (never loop single get calls).

One of: sha | shas

action="list"

List commits in the current repo. Optionally filter by start sha/ref, path, and time range (since/until: YYYY-MM-DD or RFC3339). Paginated: limit default 30 (max 200), page is 1-based.

Optional: sha, path, limit, page, stat, verification, files, not, since, until

action="pr_for_commit"

Find the pull request associated with a commit SHA or ref.

Required: sha

action="status_create"

Create a commit status (CI check result). States: pending, success, error, failure, warning. Use status_context to name the check (e.g. ‘ci/build’).

Required: sha, status_state

Optional: status_target_url, status_description, status_context

action="status_list"

List commit statuses for a SHA. Shows CI/CD check results: state, context, description.

Required: sha

action="statuses_combined"

Get combined commit status for a ref. Shows overall state plus each check’s state, context, and full description in text output; per-check target URLs are omitted — set raw_json=true to get them (the failure reason often lives there).

Required: sha

Canonical source: docs/reference/commits.md in the madtea repo.