CLI Reference

Complete command-line interface reference

Release Rust projects with ease

Global Flags

FlagShortDescription
--config-fPath to config file (overrides auto-detection)
--verbose—Enable verbose output
--debug—Enable debug output
--quiet-qSuppress non-error output
--strict—Strict mode: configured features that silently skip become hard errors

Commands

anodizer release

Run the full release pipeline

FlagShortDefaultDescription
--crate——Release a specific crate (repeatable; --id is accepted as a GoReleaser-compat alias)
--all——Release all crates with unreleased changes
--force——Force release even without unreleased changes
--snapshot——Build without publishing (snapshot mode)
--nightly——Create a nightly release with date-based version
--dry-run——Run full pipeline without side effects
--clean——Remove dist directory before starting
--skip——Skip stages (comma-separated, e.g. docker,announce)
--token——GitHub token (overrides ANODIZER_GITHUB_TOKEN / GITHUB_TOKEN env vars)
--timeout—60mPipeline timeout duration (e.g., 60m, 1h, 5s)
--parallelism-p—Maximum number of parallel build jobs (default: number of CPUs)
--auto-snapshot——Automatically set --snapshot if the git repo is dirty
--single-target——Build only for the host target triple
--targets——Restrict the build to a comma-separated subset of configured target triples (e.g. x86_64-apple-darwin,aarch64-apple-darwin). Used by the Determinism Harness's sharded job matrix; conflicts with --single-target.
--release-notes——Path to a custom release notes file (overrides changelog)
--workspace——Release a specific workspace in a monorepo config
--preflight——Run pre-flight publisher-state check and exit (don't start the pipeline)
--no-preflight——Skip the automatic pre-flight publisher-state check
--strict-preflight——Alias for --strict (also treats Unknown publisher state as a blocker during pre-flight)
--draft——Set the release as a draft
--release-header——Path to a file containing custom release header text
--release-header-tmpl——Path to a template file for release header (rendered with template variables)
--release-footer——Path to a file containing custom release footer text
--release-footer-tmpl——Path to a template file for release footer (rendered with template variables)
--release-notes-tmpl——Path to a template file for release notes (rendered with template variables, overrides --release-notes)
--fail-fast——Abort immediately on first error during publishing
--no-gate-submitter——Disable the Submitter gate: dispatch Submitter publishers even when required Assets/Manager publishers failed
--rollback——Rollback policy after publish stage. Defaults to best-effort when preflight is clean, none otherwise.
--rollback-only——Skip publish; re-attempt rollback from a prior run report. Requires --from-run=.
--from-run——Prior run id whose state to load when running --rollback-only. Loads /run-/rollback.json if present (a prior replay's state), otherwise /run-/report.json. Delete rollback.json to force a full re-roll. Must match the run_id format written by the release pipeline (alphanumeric, dot, dash, underscore; no path separators).
--allow-rerun——DANGEROUS: force publish to proceed even when a prior dist/run-/report.json exists for this tag. PR-based publishers (homebrew, scoop, nix, krew, MCP) will open DUPLICATE pull requests. Recover from partial failures with --rollback-only --from-run= first. Cannot be combined with --rollback-only (which has its own idempotency).
--allow-nondeterministic——Runtime non-determinism opt-out for a specific artifact (repeatable). Mutually exclusive with --strict.
--summary-json——Write the per-publisher run summary JSON to this path.
--split——Run only the build stage for split CI fan-out (outputs artifacts JSON to dist/)
--merge——Merge artifacts from split build jobs and resume the pipeline from post-build stages
--prepare——Run local build + archive + sign + checksum + sbom stages but skip release / publish / announce (GoReleaser Pro parity). Artifacts stay in dist/ for inspection.
--resume-release——Resume into an existing release left over from a prior failed attempt; bypasses the safety check that bails on partial assets.
--replace-existing——Force release.replace_existing_artifacts: true regardless of config (overwrite conflicting assets on retry).
--no-post-publish-poll——Skip post-publish polling for chocolatey moderation / winget PR validation; report NotPolled for affected publishers.

anodizer build

Build binaries only (always runs in snapshot mode)

FlagShortDefaultDescription
--crate——Build a specific crate (repeatable)
--timeout—60mPipeline timeout duration (e.g., 60m, 1h, 5s)
--parallelism-p—Maximum number of parallel build jobs (default: number of CPUs)
--single-target——Build only for the host target triple
--workspace——Build a specific workspace in a monorepo config
--output-o—Copy the built binary to this path (requires --single-target and single crate)
--skip——Skip stages (comma-separated: pre-hooks, post-hooks, validate, before)

anodizer check

Validate configuration and run determinism checks

anodizer check config

Validate the workspace's anodize config

FlagShortDefaultDescription
--workspace——Validate a specific workspace in a monorepo config

anodizer check determinism

Run the determinism harness (build pipeline twice, diff artifacts)

FlagShortDefaultDescription
--runs—2Number of from-clean rebuilds to diff
--stages——Optional stage subset (build,archive,sbom,sign,checksum)
--targets——Restrict the harness to a comma-separated subset of configured target triples. Used by the sharded release workflow so each runner only validates targets it can natively build (Linux runner skips macOS targets, etc.). Forwarded to the child anodize release --snapshot subprocess.
--report——JSON report path; default dist/run-/determinism.json
--snapshot——Seed SDE from snapshot rules instead of HEAD commit

anodizer init

Generate starter config

anodizer changelog

Generate changelog only

FlagShortDefaultDescription
--crate——Generate changelog for a specific crate

anodizer completion

Generate shell completions

FlagShortDefaultDescription
<shell>——Shell to generate completions for

anodizer healthcheck

Check availability of required external tools

anodizer man

Generate man pages to stdout

anodizer jsonschema

Output JSON Schema for .anodizer.yaml

anodizer resolve-tag

Resolve a git tag to its matching crate in the config

FlagShortDefaultDescription
<tag>——Tag to resolve (e.g. 'v1.2.3', 'core-v0.2.3')
--json——Output as JSON

anodizer targets

Emit the configured build targets as a GitHub Actions matrix

FlagShortDefaultDescription
--json——Output as JSON (include-form matrix)
--crate——Restrict to specific crate(s)

anodizer tag

Auto-tag based on commit message directives

FlagShortDefaultDescription
--dry-run——Show what tag would be created without pushing
--custom-tag——Override bump logic with a specific tag value
--default-bump——Override default bump type (patch/minor/major)
--crate——Tag a specific crate in a workspace

anodizer continue

Resume a release after a transient failure or after --prepare/--split

FlagShortDefaultDescription
--merge——Merge artifacts from split build jobs and run post-build stages
--dist——Custom dist directory (overrides config)
--dry-run——Run full pipeline without side effects
--skip——Skip stages (comma-separated, e.g. docker,announce)
--token——GitHub token (overrides ANODIZER_GITHUB_TOKEN / GITHUB_TOKEN env vars)

anodizer publish

Run only the publish stages (release, publish, blob) from a completed dist/

FlagShortDefaultDescription
--dry-run——Run full pipeline without side effects
--token——GitHub token (overrides ANODIZER_GITHUB_TOKEN / GITHUB_TOKEN env vars)
--dist——Custom dist directory (overrides config)

anodizer bump

Bump crate versions (Conventional Commits → semver level)

FlagShortDefaultDescription
<level_or_version>——patch
--package-p—Bump a specific crate (repeatable)
--workspace——Bump every workspace member (excluding publish=false)
--exclude——Exclude a crate from --workspace (repeatable)
--pre——Append a prerelease identifier (e.g. rc.1)
--exact——Do not rewrite dependents' [dependencies] version specs
--allow-dirty——Proceed even if the working tree has uncommitted changes
--yes-y—Skip confirmation prompt
--dry-run——Print the plan without editing any files
--commit——Stage edits and create a single commit
--sign——GPG-sign the commit (requires --commit)
--commit-message——Override the default commit message template
--output—textOutput format: text

anodizer announce

Run only the announce stage from a completed dist/

FlagShortDefaultDescription
--dry-run——Run full pipeline without side effects
--dist——Custom dist directory (overrides config)
--token——GitHub token (overrides ANODIZER_GITHUB_TOKEN / GITHUB_TOKEN env vars)
--skip——Skip stages (comma-separated)