Commits

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

List, inspect, and compare commits, and manage their commit statuses.

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.