| command | Subcommand to run: run, check, or list. | — | run |
| version | clockpin release to install. Empty (default) installs the release matching the action's own CalVer tag, keeping the binary and action in sync; use "latest" or a tag like v2026.7.0 to override. | — | "" |
| path | Repository root to operate on (--path). Defaults to the checkout root. | — | "" |
| dry-run | Preview changes without writing (--dry-run). | — | false |
| freeze | Tools to freeze to SHA/digest pins (--freeze): actions, pre-commit, docker, or all. | — | "" |
| only | Restrict to these ecosystems (--only), space/comma separated. | — | "" |
| skip | Exclude these ecosystems (--skip), space/comma separated. | — | "" |
| major | Pull held-back major versions (--major). | — | false |
| log-json | Write a JSON run log to this file (--log-json). Embedded in the PR body when set. | — | "" |
| verbose | Verbose output (--verbose). | — | false |
| quiet | Quiet output (--quiet). | — | false |
| no-color | Disable colored output (--no-color). | — | false |
| create-pr | Open a pull request with the changes. Ignored for check/list. | — | true |
| token | GitHub token used to push the branch and open the PR. | — | ${{ github.token }} |
| branch | Head branch for the pull request. | — | clockpin/updates |
| base | Base branch for the pull request. Defaults to the branch the workflow ran on. | — | "" |
| commit-message | Commit message for the update commit. | — | chore(deps): update pinned dependencies via clockpin |
| pr-title | Pull request title. Defaults to the commit message. | — | "" |
| pr-body | Pull request body. Defaults to an auto-generated summary. | — | "" |
| pr-labels | Labels to add to the PR, comma/space separated. Missing labels are skipped with a warning. | — | dependencies |
| pr-draft | Open the pull request as a draft. | — | false |
| commit-user-name | Git author/committer name for the update commit. | — | github-actions[bot] |
| commit-user-email | Git author/committer email for the update commit. | — | 41898282+github-actions[bot]@users.noreply.github.com |