commit
verbmutateMake the commit with the repository's identity and trailers, refusing what must not be committed, after the generated files are checked.
Program repoctl-releaser. Origin repoctl.
Governance: the action
What the verb is and may do, as governance says it. Each annotation is expressed by the surfaces or says why it is not.
| Property | Value |
|---|---|
kind | action |
effect | mutate |
idempotent | false |
audience | both |
tier | contributor |
dryRun | true |
check | false |
reachChannels | local, mcp |
reachReadOnly | false |
reachNeedsTty | false |
reachRunsAs | caller |
reachConfirmation | none |
Operands
| Operand | Meaning |
|---|---|
PATH | Files to stage before the commit; the files already staged are committed in any case. |
Options
| Option | Meaning | Properties |
|---|---|---|
--message | The subject of the commit: one line of at most 100 characters, with no full stop at its end. | type=value, short=m, required=true, standard=false, humanOnly=false, valueName=SUBJECT |
--refs | The issue the commit refers to: its number, written as the line `Refs #N`. | type=value, required=false, standard=false, humanOnly=false, valueName=N |
--impact | How much the release raises the version of a library this commit changes: major (a breaking change; a minor while the major version is 0), minor (a feature) or patch (a fix), written as the line `Impact:`. | type=value, required=false, standard=false, humanOnly=false, valueName=IMPACT |
--session | The address of the session, written as the line `Claude-Session` (else the variable CLAUDE_SESSION_URL). | type=value, required=false, standard=false, humanOnly=false, valueName=URL |
--co-author | The line that credits the agent (else the variable REPOCTL_CO_AUTHOR, else the configuration's). | type=value, required=false, standard=false, humanOnly=false, valueName=LINE |
--json | Write one JSON document and nothing else for a person. | type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false |
--quiet | Show only how it ended. | type=flag, short=q, required=false, standard=true, humanOnly=false, negatable=false, default=false |
--verbose | Show every step as it happens. | type=flag, short=v, required=false, standard=true, humanOnly=false, negatable=false, default=false |
--color | Use colour where the terminal shows it (--no-color turns it off). | type=flag, required=false, standard=true, humanOnly=false, negatable=true, default=true |
--non-interactive | Never ask a question: where one is needed, fail and say so. | type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false |
--dry-run | Show what would change and change nothing. | type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false |
Examples
repoctl commit -m Add the doctor --refs 10 # Commit what is staged, as the repository's identity, with the trailers its configuration lists (`Refs #10`, the co-author, the session).
repoctl commit -m Fix the merge --dry-run commons/repoctl/src # Show the message and the files, and commit nothing.Physical: what it is drawn as
repoctl commit
cli-command. Make the commit with the repository's identity and trailers, refusing what must not be committed, after the generated files are checked.
| Property | Value |
|---|---|
usage | repoctl commit |
words | commit |
tier | contributor |
repoctl_commit
mcp-tool. Make the commit with the repository's identity and trailers, refusing what must not be committed, after the generated files are checked. (action, effect mutate.)
| Property | Value |
|---|---|
title | repoctl commit |
toolName | repoctl_commit |
readOnlyHint | false |
destructiveHint | false |
idempotentHint | false |
inputs | message, refs, impact, session, coAuthor, dryRun, PATH |
required | message, PATH |
tier | contributor |
Not drawn
- rest: its reach policy does not name the rest channel