ChangelogΒΆ

8.3.1.dev0 (unreleased)ΒΆ

Warning

This version is not released yet and is under active development.

  • The bundled repomatic-ship skill now fetches the tags first, and stops when nothing since the last tag is left to ship.

8.3.0 (2026-11-17)ΒΆ

  • Add the gitleaks-default-rules check to lint-repo, which warns when [tool.gitleaks] leaves gitleaks with no rule to scan with.

  • Add the issue command, which opens, updates or closes one issue from a title and a body file, for a job outside repomatic.

  • A repomatic init that moves the upstream pin now records its run in .git/repomatic/upgrade.json, which the repomatic-upgrade skill reads.

  • repomatic init no longer prints its commit-and-push step after a pin move, and prints its first-push step only on a first adoption.

  • The sync-repomatic pull request now asks to run /repomatic-upgrade once it is merged and pulled.

  • docs.yaml now runs on a push that touches only a Markdown file at the root of .github/, like the contribution guide of an awesome list.

  • The awesome-template contribution guide now asks to replace a 40x link only when a browser gets the error too, and to open a capture before linking it.

  • sync-uv-lock and sync-tool-versions now hold back a release with a file that carries no provenance, after a release attested on every file.

  • The Provenance column of sync-uv-lock and sync-tool-versions now flags a release where only some files carry provenance, and a trusted publisher whose workflow changed.

  • The octicon registry of the title-octicons check and of the bundled sphinx-docs agent now gives the inbox icon to a formats.md page.

  • The bundled babysit-ci skill now names a required job that no runner picked up, or that ran past its timeout, as a failure to re-run.

  • The bundled file-bug-report skill now checks the code at the tip of main for a fix, and matches the depth of the reports its maintainer accepted.

  • The bundled file-bug-report skill now names the posting order of two drafts that link each other, and diffs a posted body against its draft.

  • The bundled probe-workflow skill now tries a local VM before a probe, and runs one on the runner label of the job it stands in for.

  • The bundled repomatic-ship skill now reads the warnings of the cycle’s merged automation pull requests, for an edit their job left to a human.

  • The bundled repomatic-ship skill now resolves the last published release under the cooldown, like every other install.

  • The bundled repomatic-upgrade skill now commits the upgrade, then its own changes, and pushes nothing.

  • The bundled typos template now says that the sync drops a reason written beside extend-words or extend-identifiers, and where to keep it instead.

  • The bundled upstream-audit skill now keeps a closed issue under β€œOpen upstream” until a release ships its fix.

  • Bump the repomatic run pins of Biome to 2.6.6, npm to 12.2.2, Nuitka to 4.3.5, pyproject-fmt to 2.30.6, Ruff to 0.17.4 and Wrangler to 4.158.0.

  • Fix repomatic apply-labels, which failed the labels job on a pull request from a fork instead of skipping the labels with a warning.

  • Fix repomatic ci-status, which reported a required job that no runner picked up as a workflow-level error, and one past its timeout as a superseded run.

  • Fix repomatic ci-status, which failed with an HTTP 404 on the branch of a pull request from a fork.

  • Fix repomatic init, which rewrote or deleted managed files while the cooldown held its pin, and named a pin it never wrote.

  • Fix repomatic sync-uv-lock, which gave a held-back release capped by another held-back package an Eligible date already past.

  • Fix the bundled babysit-ci skill, which cancelled the runs on the first failure while it also said to keep them alive until a fix.

8.2.0 (2026-11-12)ΒΆ

Note

8.2.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Add the lint-shell job to lint.yaml, and make a bare repomatic run shellcheck lint the shell scripts that format-shell formats.

  • Add the title-octicons check to lint-repo, which warns when a docs page title strays from the octicon registry of the sphinx-docs agent.

  • lint-changelog now warns about an entry the newest released section gained after its release tag, which a rebase across a release files there.

  • repomatic run now warns when mdformat or shfmt targets a file outside the working directory, which the config it writes there does not reach.

  • Add the shfmt_changed metadata key, which says whether the commit range touches a file of shfmt_files.

  • repomatic init now warns when it overwrites local edits in a skill or agent copy.

  • A repomatic init that moves the upstream pin now names each tool pin of the new release still inside the cooldown, like lint-repo does.

  • update-docs now refreshes a page whose only self-updating block is a click-extra <!-- envelope --> region.

  • The default gitignore.extra-content now keeps the scripts/ folder of an agent skill, which the virtualenv template’s [Ss]cripts rule ignored.

  • The bundled babysit-ci skill, sphinx-docs agent and pytest template now say that pytest 9.2.0 with pytest-xdist 3.8.0 ignores xdist_group, and the first two how to lock the shared resource.

  • The bundled benchmark-update skill now drops an excluded project from the metrics subjects and store, and follows a transferred one in both.

  • The bundled benchmark-update skill now marks incomplete support πŸͺ« in place of 🟑, and leaves a cell blank in place of N/A.

  • The bundled file-bug-report skill now covers a reply on an existing issue, and paces its gh search calls under the search API rate limit.

  • The bundled repomatic-upgrade skill now passes lint-repo the --has-* flag of each secret the repository holds, which a local run cannot read.

  • The bundled repomatic-upgrade skill no longer ports the local edits of a synced copy that upstream main already holds.

  • The bundled repomatic-upgrade skill now reads the annotations of a cancelled CI job, where GitHub names a runner image it is retiring.

  • The bundled repomatic-upgrade skill now reports a repomatic run tool pinned inside the cooldown as a breaking row.

  • The bundled repomatic-deps skill now takes modernize --no-bump, which adopts only what the declared floors provide, and the repomatic-ship skill runs it in its code pass.

  • The bundled repomatic-deps skill now checks each {todo} naming an upgraded package against its new floor, and ranks a removal candidate by the packages it frees.

  • The bundled repomatic-deps skill now passes --exclude-newer-package to a floor test install when [tool.uv] exempts a release still inside the cooldown.

  • The bundled repomatic-ship skill now takes --deep, which refactors the whole repository before the reconciliation sweep.

  • The bundled repomatic-ship skill now says which installs a cooldown-blocked fresh resolution also breaks: those exempting the release itself, like a downstream repomatic pin.

  • The bundled repomatic-ship skill now also fixes an in-cycle defect that a cycle test states, and requires a regression test that CI runs.

  • The bundled repomatic-ship skill now resolves the last published release fresh, and reports a crash there for the maintainer to yank or patch.

  • The bundled repomatic-ship skill now reports a {todo} that schedules its work for the version the release cuts.

  • The bundled repomatic-ship skill now checks that each {click:run} block renders output, since an empty render exits 0 and passes the error scan.

  • The bundled brand-assets skill now covers a mark that exists only as a raster illustration, and reads its alpha channel before calling a background opaque.

  • The bundled sphinx-docs agent now lists click_extra.todo_unrendered among its strictness flags.

  • The bundled sphinx-docs agent now covers hiding the readme banner on the docs front page.

  • The bundled sphinx-docs agent now covers copybutton_exclude, sitemap_excludes per builder, sidebar icon selectors under dirhtml, and the doctree and viewcode hooks click-extra 10.2.0 registers.

  • The bundled sphinx-docs agent now keeps the linkcheck_ignore entry of a host that timed out until several runs pass, and the default ^! of linkcheck_anchors_ignore.

  • The bundled sphinx-docs agent now puts each link exclude in the list of the checker that meets the link: lychee reads the doc files, Sphinx linkcheck the built pages.

  • The bundled sphinx-docs agent now registers icons for agents.md, design.md, performance.md and nine click-extra pages, and gives the history, operation-contracts, parameters, todolist and types pages new icons.

  • The bundled sphinx-docs agent now lists click-extra’s marker regions and text-only docs tests, and links the upstream dependencies, nuitka and commit-messages pages.

  • The bundled sphinx-docs agent now enables a MyST extension only once the docs use its syntax, and no longer recommends ogp_image_alt or a myst.domains suppression.

  • The bundled sphinx-docs agent now keys its icon registry by octicon, with one row per icon listing the pages that take it.

  • The bundled sphinx-docs agent now takes each octicon name from the icon set of the locked sphinx-design version.

  • The bundled sphinx-docs agent now leaves its icon uniqueness rules to the title-octicons check of lint-repo.

  • The bundled sphinx-docs agent now warns against a conf.py helper named after a config value, like today.

  • The bundled sphinx-docs-sync skill now tests the removal of a setting with sphinx-build -D, without an edit to a shared conf.py.

  • The bundled github-housekeeping skill now gives a branch-sync PR the milestone of the PRs it carries, in place of its live milestone.

  • Raise the click-extra floor to 10.0, which drops the boltons and deepmerge dependencies, and the extra-platforms floor to the 14.0 it requires.

  • Bump the repomatic run pins of Biome to 2.6.4, bump-my-version to 1.8.1, gh to 2.103.3, mypy to 2.4.1, Nuitka to 4.3.4, Ruff to 0.17.3, typos to 1.52.0, Wrangler to 4.157.0 and zizmor to 1.32.0.

  • Download a pinned binary of a GitHub release through the REST API when a token is set, and keep the token off the redirect to the asset host.

  • Fix lint-deps --fatal and the release PR verdict passing a floor below the locked release when every release it admits is inside the cooldown.

  • Fix a CI job leaving a duplicate of its issue, like Broken links, open when GitHub’s search index misses that duplicate.

  • Fix a re-run of the docs.yaml GitHub Pages deploy failing on the github-pages artifact its first attempt left in the run.

  • Fix lint-repo warning about a young nuitka pin in a repository that compiles no binary, where nothing installs it.

  • Fix sync-runner-images never retiring an image that only a repository’s own matrix names: it moves a [tool.repomatic.test-matrix] entry and reports a workflow one.

  • Fix a Sigstore server error failing the build-package job: it now tries the PEP 740 signing three times, a minute apart.

  • Fix prune-caches failing the build job of a container that ships no gh, like the manylinux one, when the pinned gh cannot be downloaded.

  • Fix ci-status --wait ending on one GitHub 5xx or rate limit: it skips that poll, and ends after three failed polls in a row.

  • Fix ci-status warning about a matrix job whose if: skipped it, like a release stage on an ordinary push: it now prints a notice.

  • Fix ci-status --failed-logs keeping the terminal hyperlinks and other escape sequences that are not colors in the logs it writes.

  • Fix the docs/binaries.md page sync-binaries creates claiming every push compiles all binaries, where a push builds the nuitka.dev-targets canary alone. An existing page keeps its prose: edit it by hand.

  • Fix the build-finished hook of the docs and of the bundled sphinx-docs agent deleting .buildinfo locally, which hid html-only setting changes from incremental builds.

  • Fix the bundled sphinx-docs agent advising against asserting result.exit_code in {click:run} blocks.

  • Fix the bundled sphinx-docs agent naming click-extra modules and helpers that its 10.0 release renamed or removed, like sphinx/click.py and _run_mirror.

  • Fix the bundled sphinx-docs agent claiming a :mirror: block cannot import a module beside its page, and that the subagents page runs {click:run}.

  • Fix the bundled sphinx-docs agent and repomatic-ship skill treating a downstream install page as carrying versioned download URLs, which only repomatic’s freeze pins.

  • Fix the bundled brand-assets skill naming the social banner after its style, where its own docs/conf.py wiring reads banner-social.

  • Regrade the benchmark with βœ…, πŸͺ« and ❌ marks, each linked to its evidence, in place of plain βœ“ and ~.

  • Move cruft, which has had no commit since December 2024, from the benchmark tables to its excluded projects.

  • Add a support envelope section to the install page, which lists the Python versions repomatic no longer supports.

  • Document the .staging/ folder of the claude.ai skill sync, which a symlinked user skills directory also needs in .gitignore.

  • Document the typos trap of a bracket glob like [Ss]cripts, which reports cripts as a typo.

  • Render each bundled subagent on a docs page of its own, where the sphinx-docs icon registry shows its icons.

  • Fix the show-metadata sample of the test matrix page, which rendered no output.

8.1.0 (2026-11-03)ΒΆ

Note

8.1.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: Retire the repomatic-audit skill, folded into repomatic-upgrade as its second pass. repomatic init deletes an unmodified copy, and fails on an exclude or include entry naming skills/repomatic-audit until the entry is dropped.

  • Breaking: Generated workflows and the bundled agents and skills now name AGENTS.md as the instructions file in place of claude.md. Rename a downstream claude.md to match.

  • Add the instructions-file-name check to lint-repo: it warns about a root claude.md, or an agents.md in another case, in place of AGENTS.md.

  • Add the sphinx.fail-on-warning setting, which makes the Sphinx build of docs.yaml fail on any warning.

  • The Sphinx build of docs.yaml now reads in parallel with --jobs auto. Under sphinx.fail-on-warning, an extension that does not declare itself safe for a parallel read fails the build.

  • Add the source = "sdist" matrix key: its cell runs the suite from the unpacked sdist, outside a git checkout, on the newest dependencies. A downstream tests.yaml needs the steps that read matrix.source.

  • lint-deps now warns about a dependency extra that uv.lock resolves to no package, like coverage[toml] since coverage 7.17.0.

  • lint-deps now warns about a lint-deps.allow entry that matches no finding, and gives the normalized spelling when that would match.

  • The bundled repomatic-upgrade skill now compares the test matrix at both pins, dispatches release.yaml to self-test every binary, and counts each old finding of a new gating job.

  • The bundled repomatic-upgrade skill now ends with two numbered lists: the applied rows, and the remaining actions, each labelled Decide:, Implement:, Commit:, Push: or Report:.

  • The bundled awesome-template contributing guide and awesome-triage skill now reject a link to a temporary, development or preproduction address, like a pages.dev default domain.

  • The bundled grunt-qa agent and the babysit-ci, repomatic-changelog and repomatic-deps skills now run repomatic at the version the workflows pin, like repomatic-ship.

  • The bundled repomatic-ship skill now waits out a long CI cycle with a background ci-status --wait, and reads the newest schedule or workflow_dispatch build of release.yaml.

  • In a repository repomatic depends on, like click-extra, the bundled repomatic-ship skill now checks that the pinned repomatic imports against the release tree.

  • The bundled babysit-ci skill now passes ci-status --wait one --workflow per workflow a push started, when an older red run would end the wait at once.

  • The bundled babysit-ci skill now leaves for the next release a πŸ“¦ Package install red that only a release can heal, and watches the other jobs past it.

  • Bump Nuitka from 4.3.1 to 4.3.3, which guards the --main-entry-point launcher itself, and drop the plugin repomatic run nuitka loaded for it.

  • Bump the repomatic run pins of Biome to 2.6.3, bump-my-version to 1.6.7, gh to 2.103.2, labelmaker to 0.6.5, Ruff to 0.17.2 and Wrangler to 4.152.0.

  • The default cache directory follows an absolute XDG_CACHE_HOME on macOS too, and ignores a relative one on Linux.

  • Fix 18 commands, like changelog, lint-changelog and prepare-release, failing with ModuleNotFoundError under click-extra 10.0.0, which moved click_extra.blocks, and the bundled sphinx-docs agent naming that module.

  • Fix lint-repo asking to remove a lint-repo.declined entry that names a list, where the entry needs the key of the missing member.

  • Fix lint-repo and init passing a workflow step that calls show-metadata --format, which 8.0.0 renamed to --output-format.

  • Fix lint-repo passing a [tool.lychee] exclude entry that the bundled template dropped, like the star-history.com pattern 8.0.0 removed.

  • Fix lint-deps blocking a release on a dependency group floor inside the cooldown, which never ships, and naming every such floor a project dependency.

  • Fix ci-status --wait --timeout sleeping up to one --interval past its deadline.

  • Fix ci-status reading a run GitHub has yet to give a job as green: it now reads not started, and --wait waits for it.

  • Fix ci-status --wait --until-change returning at once, on every re-armed watch, on a failed required job it already reported.

  • Fix pr-sync failing its job when a concurrent run pushed the same branch first: it keeps a push built on its base or a newer one, and pushes again over an older one.

  • Fix update-dep-graph labelling the edge of a main dependency with the floor that a dependency group or an extra declares for the same package.

  • Fix repomatic run ruff with the bundled config targeting ruff’s default Python, whose safe UP fixes broke a project with an older requires-python floor.

  • Fix PyPI lookups that read a released package as missing when the CDN served a cut-off body: every request now asks for gzip.

  • Fix the Windows binary builds failing on UnicodeEncodeError when prune-caches prints its table to the cp1252 console.

  • Fix the bundled babysit-ci skill running ruff over folders only this repository has, sending a downstream checksum mismatch to update-checksums, and starting the local tests with a & that ignores SIGINT.

  • Document three tool traps: the **/ prefix a [tool.biome] files.includes pattern needs, silencing half a hyphenated typos word, and the .gitignore entries a symlinked user skills directory needs.

  • Document that cloud sessions skip the plugin repomatic init plugin declares, but load the skills and agents committed to the repository.

  • Fix two docs samples: the lint.yaml thin caller now has its workflow_dispatch trigger and secrets, and gitignore.extra-content its .wrangler/ entry.

8.0.0 (2026-10-29)ΒΆ

Note

8.0.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: Drop Python 3.10, past its end of life: repomatic needs Python 3.11, and the default test matrix starts at 3.11 on every runner.

  • Breaking: Remove the metadata alias of show-metadata and the hidden workflow lint command, as their deprecation warnings announced. lint-repo and init flag a workflow step that still calls metadata.

  • Breaking: Remove lint-workflows: lint-repo runs its checks as workflow-dispatch, thin-caller-pins, thin-caller-triggers and thin-caller-secrets.

  • Breaking: Remove git-commit-push, which no bundled workflow calls since 7.14.0.

  • Breaking: Rename show-metadata --format to --output-format, like every other command. A workflow step passing --format needs the new name.

  • Breaking: changelog now writes in place at changelog.location, and its --source option becomes --changelog. Pass - to print instead.

  • Breaking: Remove sync-binaries --backfill-records, the show-metadata --force and --replace aliases, and the GHA_PR_* environment variables.

  • Breaking: pr-body and pr-sync read the diff table and the upgrade report only from REPOMATIC_DIFF_TABLE_FILE and REPOMATIC_UPGRADE_REPORT_FILE.

  • Breaking: Remove the [tool.repomatic.flavor] table and the metrics.skip and cache.github-release-ttl keys. A config that sets them gets an unknown-key warning.

  • Breaking: Remove the new_commits, release_commits, release_notes, release_notes_with_admonition, minor_bump_allowed, major_bump_allowed, skip_binary_build and nuitka_extras keys of show-metadata, which no workflow reads.

  • Breaking: Replace the unsubscribe-phase1 and unsubscribe-phase2 templates with one unsubscribe-report template.

  • Breaking: lint-repo drops the pat-stale-statuses-permission check, so it no longer posts a commit status on each run.

  • Breaking: init no longer deletes the files of assets removed before 7.0.0. A repository upgrading from 6.x deletes them by hand.

  • Breaking: scan-virustotal and sync-binaries refuse a scan history kept only in the pre-7.13.0 JSON file, and no longer migrate old binaries page markers.

  • Breaking: cloudflare-r2 --offload writes its report through the new --output option instead of $GITHUB_STEP_SUMMARY, and needs a project name like the other modes.

  • Breaking: Remove the close-stale-bump-pr command and the pr-body --pr-ref option. bump-version and squashed-release do their work.

  • Breaking: broken-links now runs lychee itself and drops --lychee-exit-code and --body-file. Pass --no-lychee to skip the crawl.

  • Breaking: show-metadata replaces site_cloudflare_project with cloudflare_project, which falls back to the repository name.

  • Breaking: The github-json format of show-metadata now writes a list of objects, like build_targets, as a JSON array. Drop the fromJSON that decoded it.

  • Breaking: The _release-engine.yaml reusable workflow takes the metadata of the build lane as a required metadata input, and loses its 🧬 Project metadata job.

  • Breaking: labels.yaml merges its sponsor-label job into apply-labels. A required check that names the old job needs the new name.

  • Breaking: Rename the detect-squash-merge job of _release-build.yaml to squashed-release, and title its issue 🚨 Squashed release.

  • Breaking: repomatic run pyproject-fmt now exits 0 after a rewrite it verified, instead of 1.

  • Breaking: The bundled zizmor.yaml now requires hash pins for third-party actions.

  • Breaking: The bundled labels.toml no longer renames the 🎁 feature request label, and lychee.toml no longer skips star-history.com links.

  • Breaking: The bundled uv.toml floors uv at 0.12.22, the first release writing the committed uv.lock format. Move a setup-uv pin below it before syncing.

  • Drop the boltons dependency: the test matrix model, sync-mailmap and the Cloudflare Pages drift check use the standard library instead.

  • Drop the arrow dependency: relative times like in 4 days and the unsubscribe month cutoff are computed in-house, with the same wording.

  • Drop the pyelftools dependency: verify-binary reads ELF headers with its own parser, as it already did for Mach-O and PE.

  • Drop the vt-py dependency and the aiohttp stack beneath it: scan-virustotal calls the VirusTotal REST API through the standard library.

  • Enable the D205, D209, E501, PLC0415, RUF100, RUF102, RUF103, RUF104 and TC ruff rules in the bundled ruff.toml.

  • The bundled pytest.toml schedules with --dist=loadgroup, so an xdist_group marker keeps its tests on one worker, and sets strict_config and strict_markers.

  • The bundled pytest.toml runs one xdist worker per logical CPU with --numprocesses=logical: auto counted physical cores and halved the workers on the x86 runners.

  • Add prune-caches, which deletes the GitHub Actions caches a newer save superseded. The compile-binaries, sync-deps and sync-tool-versions jobs run it after their restore, and gain the actions: write scope.

  • Add the tool_versions key to show-metadata, the pinned version of every repomatic run tool. Each tool cache is now keyed on it, so a cache rotates with the pin instead of with every registry edit.

  • Raise the click-extra floor to 9.5, which keeps the lazy command modules unloaded when a configuration file is read, and py-walk to 0.3.3.

  • Raise the test and docs dependency floors to the releases the suite and the Sphinx build rely on, pytest 9.0.3 among them for CVE-2025-71176.

  • repomatic run nuitka spells the macOS ccache opt-out --disable-cache=ccache, the documented form of the hidden --disable-ccache alias.

  • repomatic run gitleaks prints each finding with its file, line, commit and rule, and redacts the secret, so a red lint-secrets run names what it found.

  • repomatic run typos now installs on Windows ARM64, and repomatic run lychee on x86_64 macOS.

  • repomatic run --verify prints the unified diff of each file it would rewrite, below its Would rewrite: line.

  • An npm tool install now ends with npm audit signatures, which verifies the registry signature and the provenance of every installed package.

  • repomatic run manages wrangler, and the deploy-docs-cloudflare job deploys through it instead of an npx call.

  • update-checksums and sync-tool-versions verify the upstream attestation of each actionlint, Biome, gh, shfmt and typos download before recording its checksum.

  • sync-uv-lock and sync-tool-versions hold back a PyPI release that lost the PEP 740 provenance its predecessor had, and show each release’s trusted publisher.

  • The updates table of a dependency PR moves its Provenance column next to Change, ahead of Released.

  • The documentation’s copy button skips the prompt and output lines of a shell session, and its sitemap drops the search and index pages.

  • Set wrap = "no" in the bundled mdformat.toml, so format-markdown joins the lines of a hard-wrapped paragraph.

  • The bundled zizmor.yaml ignores the unpinned-images audit of _release-engine.yaml, whose container: value the build matrix supplies.

  • lint-changelog warns on an entry filed out of the Breaking, then Deprecated, then ordinary order and on a #N naming no issue, and --fix strips a v tag prefix off a heading.

  • The prepare-release job waits until the unreleased changelog section holds an entry, read from the new changelog_has_entries metadata key.

  • Add ci-status --wait, which polls in-process until a required job fails or every run settled, with --until-change and --state-file for a re-armed watch.

  • Add ci-status --failed-logs, --automation-prs and --release-pr, and report a matrix job GitHub never expanded.

  • Add a lint-python job to lint.yaml, which fails on the ruff findings no safe fix clears, where format-python only annotates them.

  • Add lint-coverage, which flags a [tool.coverage] report.fail_under floor more than two points under the coverage total. The tests job of tests.yaml runs it after the unit tests.

  • repomatic now imports only the module of the command it runs: repomatic --version starts in 0.3 s instead of 0.45 s.

  • Add the sync-runner-images.sync and github-releases.sync keys to turn off these two syncs.

  • Add the bump-version, create-release, pack-manpages, squashed-release and wait-pypi commands, which replace the shell steps of the release workflows.

  • Add prepare-release --commit and --output, --upload-to on pack-attestation and pack-binaries, and pack-attestation --require-declared and --verify.

  • Add sync-deps --pr-sync, which syncs each updater from a clean tree, opens or refreshes its own pull request, and refuses uncommitted changes.

  • Add the show-metadata keys is_awesome, builds_sphinx, main_cli_script, import_name, latest_stable_python, is_release_push and release_commit.

  • nuitka_matrix is now empty when the binary build is skipped, and each entry gains a nuitka_cache flag.

  • manpages_asset_name now gives its <package>-manpages default instead of an empty value.

  • The help screen gains β€œSite & docs” and β€œTools” sections, and lists every sync-* command under β€œSync”.

  • Every --output option now accepts -o, and - for stdout.

  • apply-labels, lock-threads, sync-labels, sponsor-label and sync-binaries fall back to the repository of the git remote when --repo is missing.

  • Library helpers now read the configuration the CLI resolved, so --config reaches the tool cooldown, the cache settings and the init pins.

  • lint-repo and setup-guide now read the repository once and probe each setup step once, which saves API calls on every run.

  • lint-repo now warns when a repomatic run tool pin is still inside the cooldown, and names the exclude-newer-package entry that admits it.

  • lint-repo now warns when a MyST Sphinx build does not fail on myst.xref_missing, the dead fragment links lint-anchors caught until 7.18.0.

  • lint-repo no longer warns that a REPOMATIC_PAT limited to its own repository likely has access to all repositories.

  • lint-repo no longer warns about a runner image outside the test matrix axes when [tool.repomatic.sync-runner-images] ignore names it.

  • immutable-releases now applies to every repository with a changelog, not only to Python packages.

  • description-matches and website-for-sphinx skip when no repository is named, instead of failing.

  • ci-status and the workflow checks of lint-repo now read .yml workflow files too.

  • The setup guide issue now stays open while REPOMATIC_PAT also has access to another repository of its owner, and the token step names it.

  • run --list and the tool reference now find the bump-my-version configuration in [tool.bumpversion].

  • sync-tool-versions now downloads only the artifacts of the tools it bumps, and fetches release data in parallel, like sync-action-pins.

  • sync-workflow-pins now realigns the inline repomatic pin in every shape lint-repo checks, extras included.

  • Add the workflow-pins.ignore key: sync-workflow-pins leaves the pins of each package it lists as written.

  • sync-workflow-pins now bumps the tag of a gh release download vX.Y.Z --repo owner/repo command, and --release-notes collects that release’s notes.

  • Generated tool configs are cached under a content digest, so two checkouts no longer overwrite each other’s config.

  • A bare repomatic run gitleaks now scans the git history, and a bare repomatic run lychee checks the documentation files.

  • Add repomatic run shellcheck and repomatic run npm. repomatic run actionlint puts shellcheck on PATH and annotates its findings in CI.

  • repomatic run nuitka now installs nuitka.extras, prepares the compile cache, and adds the macOS deployment flags.

  • npm tools now always install through the pinned npm, so the cooldown holds whatever npm the runner provides.

  • update-docs now reformats the pyproject.toml files it changes.

  • cancel-runs now spares the runs of a release push.

  • Tool downloads stop at once on an HTTP 4xx and send the repomatic/{version} User-Agent. An install failure prints an error, not a traceback.

  • audit --fix links each version change to its GitHub comparison.

  • Dependency pull requests fetch release notes with one listing per repository, show GitHub-only releases, and leave out pre-releases inside the range.

  • lint-deps policy warnings name locations as TOML paths, like project.dependencies.

  • The output of uv no longer interleaves with the progress display of sync-deps, audit --fix and update-dep-graph.

  • init reports a merged pyproject.toml once under β€œUpdated”, and a new changelog starts with a section that lint-changelog can parse.

  • include = ["awesome-template"] now writes the template in any repository, like other include entries.

  • The github format of show-metadata trims a value over the step-output limit with a warning, instead of failing the step.

  • Outside CI, the repository slug now comes from the origin remote before gh.

  • sync-labels picks the awesome-list label profile from --repo instead of the checkout.

  • sample-metrics refuses a metrics store holding an unknown source.

  • The metrics.yaml schedule moves from weekly to quarterly, which thin callers mirror at their next sync.

  • The unsubscribe-threads report warns when its first phase cannot fetch notifications, and shows dates beside relative times.

  • The fix-typos pull request title and commit message now read β€œFix typos”.

  • Release lookups leave out draft releases, and sync-github-releases --live reads fresh release bodies and continues past a failed edit.

  • sync-dev-release fails instead of creating a duplicate draft when it cannot edit the listed draft.

  • scan-virustotal counts two API calls per upload and shares one rate budget with polling.

  • The scan-virustotal job now times out after 30 minutes instead of 15, and passes with its steps skipped when no API key is set.

  • The squashed release issue now carries the πŸ€– ci label, updates on a re-run instead of opening a duplicate, and reopens when a squash merge recurs.

  • Freeze and post-release commits are now authored by github-actions[bot] instead of the actor who triggered the run.

  • The generated autofix caller now grants security-events: read, so fix-vulnerable-deps reads Dependabot alerts with the workflow token.

  • The release workflows now pin pypi-attestations, and call the pinned gh of the tool registry instead of the runner’s.

  • git-tag errors now include the output of git.

  • lint-changelog tolerates release versions that are not PEP 440.

  • Binary builds now count the workflow.source-paths directories, so a source-only push to a src-layout project builds its binaries.

  • The bundled tests.yaml drops its step that forced a native Python on Windows ARM64, since uv 0.13.0 picks it unaided. A downstream copy can drop the same step.

  • The Windows binaries now build on uv’s managed Python, like the binaries of the other platforms.

  • The test matrix now runs Python 3.15 as the stable release and 3.16 as the development one, and smoke-tests the free-threaded 3.15t.

  • The managed setup-uv pin moves to 0.13.4, the first uv release that ships the Python 3.16 alpha, so the development cell installs its interpreter again.

  • Bump Nuitka from 4.3 to 4.3.1, which stops a new kind of local variable from recompiling every C file of the binary.

  • The bundled benchmark-update skill now grades each cell βœ…, 🟑 or ❌, links it to its evidence, and audits blank cells against quoted sources.

  • The bundled repomatic-audit skill now reads the CI state of the default branch, and checks that [tool.gitleaks] keeps the built-in rules.

  • The bundled repomatic-deps skill now flags, in its explore mode, thin dependencies that in-house code could replace.

  • The bundled repomatic-upgrade skill now runs the newly pinned mypy and ruff on the untouched tree, since the changelog often leaves a tool bump out.

  • The bundled repomatic-upgrade skill now tells a local edit that upstream already holds from one the upgrade drops, with a three-way merge.

  • The bundled repomatic-upgrade skill now reads the binary self-test of Build & release when an upgrade changes how binaries build.

  • The bundled repomatic-upgrade skill now runs repomatic run actionlint after a row that touches a workflow.

  • The bundled skills and the sphinx-docs agent read the cooldown window from the repository’s workflows instead of assuming 1 week.

  • The bundled repomatic-test-matrix skill now replays a lowest-direct cell, judges each run by its exit code, and needs --frozen on every later uv run. The skill and the test matrix guide now say that full-include drops the python-version axis.

  • The bundled repomatic-ship skill now watches CI itself after a cycle under 10 minutes, and spawns the babysitter only on a red required job.

  • The bundled repomatic-ship skill now reads a --version banner captured from a checkout as the dev version, not as a sample lagging the released tag.

  • Fix the YAML and workflow lint jobs running on every push: yaml_changed, workflows_changed and zsh_changed now read the commit range, shallow clones included.

  • Fix a later push cancelling the tests of a release push: they now run in a concurrency group of their own.

  • Fix a failed lychee run, or a run where no link checker ran, closing the β€œBroken links” issue.

  • Fix audit running uv audit when the configured sources leave it out.

  • Fix repomatic run mypy on projects whose Python floor is 3.8 or 3.9.

  • Fix exclude-newer = "0 days" and a false entry in exclude-newer-package, which sync-uv-lock could not read.

  • Fix the generated release.yaml and tests.yaml header exporting the default cooldown instead of the repository’s minimum-release-age.

  • Fix init --upstream-repo exempting repomatic from the cooldown instead of the package of the named repository.

  • Fix lint-deps --pyproject reading the pyproject.toml next to the file it names.

  • Fix show-metadata and update-docs crashing on a conf.py with a tuple or subscript assignment.

  • Fix current_version, which reported the oldest commit of a multi-commit push instead of the newest.

  • Fix the draft GitHub release of a first release, which lacked the β€œfirst version” wording of its changelog entry.

  • Fix the malformed table of the release-sync-report template, and the doubled footer of sync-runner-images pull requests.

  • Fix cloudflare-pages and cloudflare-r2 printing a traceback on a timeout or a dropped connection.

  • Fix GraphQL queries for a repository named like a number or a boolean, such as 2048.

  • Fix init reporting four phantom updates in awesome-list repositories, and missing the #readme link of their template.

  • Fix init --output-dir building paths: filters from the working directory instead of the target project.

  • Fix cancel-runs matching the wrong runs for a branch name holding +, & or #.

  • Fix the thin-caller secrets check reading the first job with secrets instead of the job that calls the reusable workflow.

  • Fix the binaries leaving out the prepare-release and release-sync-report templates.

  • Fix the Linux binaries baking no git field: the build job now trusts the checkout inside the manylinux container.

  • Fix the binary of a CLI that starts worker processes, which ran the whole CLI again in each worker since 7.18.0.

  • Fix the file lists of repomatic commands including the files that .git/info/exclude ignores, like an agent worktree under .claude/worktrees/.

  • Fix stale claims of the bundled babysit-ci, repomatic-ship and repomatic-test-matrix skills on release runs, binary skips and format-python pull requests.

  • Fix the bundled repomatic-ship skill testing with repomatic’s own dependency groups, including a typing group that downstream repositories may not define.

  • Fix a dependency pull request picking up the staged changes of an updater whose commit failed.

  • Fix the sync-gitignore help naming gitignore-extra-content and gitignore-location instead of the gitignore.extra-content and gitignore.location keys.

  • Fix lint-repo’s pypi-trusted-publisher check showing the raw [project] name, not the normalized one PyPI uses, in its messages and settings link.

  • Fix audit, lint-changelog, pack-plugin, prepare-release, sync-gitignore, sync-uv-lock, update-dep-graph and verify-binary printing a traceback on a missing file, a failed fetch or a failed uv call.

  • Fix a command printing a traceback when uv or uvx is missing from PATH.

  • Fix lint-deps passing in a directory with no pyproject.toml, which it read as a project with no dependency.

  • Fix show-metadata crashing on nuitka_matrix for a project with a CLI but no bump-my-version configuration.

  • Fix the help of sync-workflow-pins, which named two of the five pin shapes it rewrites, and the unsubscribe-threads examples, which lacked --live.

  • Fix the note init prints for a removed codecov file, which named --cov-fail-under instead of [tool.coverage] report.fail_under.

  • Fix init dropping the downstream jobs of a thin caller that indents its jobs by four spaces.

  • Fix the commands that read GitHub releases crashing on a corrupt release cache holding a JSON list.

  • Fix sync-deps reporting all dependencies up to date when an updater failed to resolve.

  • Fix show-metadata --no-overwrite announcing that it overwrites the target file it then keeps.

7.18.0 (2026-10-13)ΒΆ

Note

7.18.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: Remove the lint-anchors command and the Docs workflow step running it. A Sphinx build reports the same broken fragment links as myst.xref_missing warnings.

  • Breaking: nuitka_matrix replaces the module_path and nuitka_python_flags keys with main_entry_point, the value of Nuitka’s --main-entry-point. A workflow reading either key needs the new one.

  • The update-dep-graph job moves from the release workflow to Autofix: it refreshes the graph on every push, for uv virtual projects too.

  • Add dependency-graph.update to turn off the dependency graph updates.

  • Add lint-repo.declined to record why a seeded tool config leaves out a bundled template entry, which lint-repo then stops warning about.

  • lint-repo now names a table that a seeded list lacks by the inline TOML that writes it, which is also its lint-repo.declined key.

  • lint-repo now fails on a _redirects rule that Cloudflare Pages can never apply: a source it cannot compile, a destination token it never replaces, or an exact rule that a pattern above it answers first.

  • The bundled tests.yaml now resolves again any matrix cell that carries a resolution key, so a lowest-direct cell runs every declared dependency floor.

  • A src-layout project now gets its binaries: each entry point compiles by name, through Nuitka’s --main-entry-point. Set nuitka.enabled = false to build none.

  • sync-uv-lock now prunes the fixed exclude-newer-package cutoff of a package the lockfile does not hold, once the cooldown has passed it, and reports it as not locked.

  • Bump Nuitka from 4.2.2 to 4.3, which ships the content of each symlink in an --include-data-dir tree: repomatic run nuitka no longer stages a symlink-free copy.

  • repomatic run nuitka now turns off Nuitka’s update check, which warned on each build made while a release newer than the pinned one existed.

  • repomatic run nuitka now installs Nuitka into the project virtualenv, so its compile cache survives a change of pyproject.toml or uv.lock.

  • Relax the arrow, boltons and pyyaml floors to >=1, >=19 and >=6.0.1.

  • The bundled mypy config now sets check_untyped_defs, which also type-checks the functions without annotations.

  • The bundled mypy config now skips imports into sphinx.*: Sphinx 9.1.0 syntax stopped the check of a project below Python 3.12.

  • The bundled lychee config now excludes claude.ai links, which a Cloudflare challenge hides from some crawlers.

  • Every setup guide step now reads like the token step: one lead sentence, numbered actions, form fields in a table, and the long explanations left in docs/.

  • job-timings, cancel-runs and the ci-status fallback now list runs with a date filter, so a stale run listing no longer feeds them weeks-old runs.

  • cloudflare-r2 --offload now writes why it dropped a file as Markdown in the step summary, with code-formatted names and a docs link.

  • The bundled babysit-ci and repomatic-ship skills now run their local tests with the test dependency group, which repositories without default groups need.

  • The bundled babysit-ci skill now says to dispatch tests.yaml when a version-bump commit cancels the runs of the commit under it.

  • The bundled benchmark-update skill now assesses every competitor cell of a row added since the last pass, and re-anchors pinned evidence links by content after a release.

  • The bundled file-bug-report skill now searches pull requests, recent threads, development branches and release notes before it calls a report new.

  • The bundled file-bug-report skill now says to run the reproducer in a second implementation, and to read each code of conduct to its end.

  • The bundled file-bug-report skill now says not to offer a comment on an issue that a maintainer already answered as in progress.

  • The bundled repomatic-audit and repomatic-upgrade skills now read a lint-repo.declined entry as a decision, and record there a template entry left out on purpose.

  • The bundled repomatic-audit skill now runs the adopted release’s init in a throwaway worktree first, which compares every managed file at once.

  • The bundled repomatic-deps skill now checks for a dependency floor set too low, and says how to relock after a floor change.

  • The bundled repomatic-deps skill now reads the whole modernize range off the lockfile when several sync-uv-lock pull requests merged since the last release.

  • The bundled repomatic-ship skill now says how to take over a sweep lane after its agent dies mid-edit.

  • The bundled repomatic-ship skill now says how to watch CI past the 30-minute Monitor deadline, and to watch a dispatched run by its ID.

  • The bundled repomatic-ship skill now limits its docs build fixes to the warnings the cycle added, and runs its tool smoke checks in a throwaway worktree.

  • The bundled repomatic-test-matrix skill now says how to run every declared dependency floor in one lowest-direct cell.

  • The bundled upstream-audit skill now assigns each item to the project that produced it, and lists every issue the maintainer reported.

  • The bundled sphinx-docs agent now runs sphinx-build with the command sandbox off: sphinx_sitemap fails inside it.

  • The bundled sphinx-docs agent now says to fail a build on myst.xref_missing warnings with click_extra_fail_on_warnings, and never to suppress them.

  • Fix lint-repo reporting every bundled key missing from a [tool.pytest] section kept under ini_options, and asking for native keys pytest refuses beside that table.

  • Fix lint-repo advising to drop a bare [tool.lychee] exclude entry that no anchored form sits beside: it now names the anchored form to write instead.

  • Fix lint-repo skipping its PAT repository-scope check on every run: the probe of another repository of the same owner now runs.

  • Fix repomatic init dropping the comments beside a local key it keeps when re-syncing a tool config.

  • Fix repomatic init re-syncing a multi-line tool config array at a four-space indent, which format-pyproject then rewrote to two in its own pull request.

  • Fix the setup guide’s R2 keys step describing a dashboard route the R2 page does not have: it now links the account token form.

  • Fix fix-typos failing on certifi in a dependency graph that includes requests: the bundled typos config now accepts it.

  • Fix repomatic run ruff and repomatic run typos ignoring the tool’s exclude list for a file named on the command line.

  • Fix repomatic run mdformat skipping its MyST directive repairs for the files below a directory argument.

  • Fix repomatic run --verify ending in a traceback when it cannot copy a target: it now names the path and exits with code 2.

  • Fix a .gitignore pattern with a non-ASCII character missing its files on a machine whose locale is not UTF-8.

  • Fix update-docs not reading a MyST toctree fence in an API index, and filing a package page that has no submodule pages under Submodules.

  • Fix sync-workflow-pins bumping the uv pin when it cannot read the setup-uv checksum table: it now holds the pin until the table reads again.

  • Fix update-checksums and sync-tool-versions stopping at the first failed download: each download is now retried, like a tool install.

  • Fix sync-uv-lock never freezing or pruning an exclude-newer-package entry whose key spells its package name differently from the lockfile.

  • Fix sync-runner-images failing to push its pull request: its checkout now passes REPOMATIC_PAT, which GitHub requires to update a workflow file.

  • Fix the packaging and vt-py floors, which allowed releases the code cannot run on: they are now >=20 and >=0.18.3.

  • Fix the two CLI self-test steps of the bundled tests.yaml, which every run skipped: they indexed cli_scripts, a space-separated string. A downstream copy of the workflow needs the same edit.

  • Fix ci-status reporting a cancelled run, or a run that ran no job, as green, and reading a workflow on a tip commit where it ran no job.

  • Fix ci-status counting a matrix job that GitHub never expanded as an allowed-failure probe: it is now a required job.

  • Fix the Docs workflow skipping a push that only changes claude.md, license or .github/code-of-conduct.md, which the documentation includes.

  • Fix the bundled babysit-ci skill pointing at a matrix exclude section that the bundled tests.yaml does not have: it now names repomatic show-test-matrix.

  • Fix the bundled repomatic-deps skill saying that a same-maintainer package keeps its exclude-newer-package span: only a git or path source does.

  • Fix four statements of the bundled sphinx-docs agent: what nitpicky does, how to enable autosectionlabel, which page holds the dependency graph, and a uvx command with no cooldown.

  • New upstream page tracks the pull requests and issues repomatic sends to the projects it depends on.

  • Give each release of the changelog and changelog archive pages a stable anchor made from its version, like https://repomatic.net/changelog#v7-17-1. The numbered #id1 anchors, which moved with each release, are removed.

  • The workflows reference now lists every lint-repo check, rendered from the check roster like lint-repo --help.

  • Document that mdformat also deletes backslash escapes and entities from a Markdown image’s alt-text.

  • Document in the bundled uv config that CI installs the uv each setup-uv step pins, not the newest release above the floor.

  • Document that a tool the registry pins before its release clears the cooldown needs an exclude-newer-package entry, in a downstream repository too.

7.17.1 (2026-09-30)ΒΆ

Note

7.17.1 is available on 🐍 PyPI and πŸ™ GitHub.

  • fix-typos now checks hidden files and directories like .github/ and .claude/, through the bundled [tool.typos] config.

  • lint-repo --help now lists every check the command runs, rendered from the check roster.

  • The setup guide’s R2 keys step now mirrors the Cloudflare Pages step, with the wrangler and dashboard routes and a dated token name.

  • ci-status now reads runs back from the branch tip, commit by commit, so a stale run listing no longer reports months-old runs as the latest.

  • Fix the setup guide’s notes showing a literal [!NOTE] or [!IMPORTANT] marker: GitHub renders no alert inside a step’s collapsible block.

  • lint-repo no longer flags a PR template that opts out of the footer with the quoted footer: 'false', which pr-body honors.

  • Fix repomatic init dropping the comments on the local array items it keeps when re-syncing a tool config, like each [tool.typos] extend-ignore-re entry’s.

  • The bundled repomatic-test-matrix skill now says lint-repo warns about a runner outside the test matrices, rather than rejecting it.

  • The bundled babysit-ci and repomatic-test-matrix skills and the grunt-qa agent no longer read runs through gh run list, which can list weeks-old runs as the newest.

  • The bundled repomatic-ship skill now keeps a parallel session’s edits out of its release commit, and runs its checks on that exact commit.

7.17.0 (2026-09-30)ΒΆ

Note

7.17.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: The Docs workflow’s Cloudflare deploy now fails when it has to drop a file over 25 MiB, once the rest of the site is published. Declare site.cloudflare-r2-bucket to serve such files instead.

  • Add cloudflare-r2 and the site.cloudflare-r2-bucket and site.cloudflare-r2-domain keys: the Docs workflow’s Cloudflare deploy now serves files over 25 MiB from that R2 bucket.

  • lint-repo now warns about a tracked file over the 25 MiB Cloudflare Pages limit when no R2 bucket is declared.

  • lint-repo and the setup guide now ask for CLOUDFLARE_R2_ACCESS_KEY_ID and CLOUDFLARE_R2_SECRET_ACCESS_KEY when site.cloudflare-r2-bucket is declared.

  • The bundled repomatic-deps skill now bisects a floor that rests on a behavior rather than an API, and reads deprecated calls off the test suite’s warnings summary.

  • The bundled awesome-triage skill now closes a declined commercial submission with one fixed sponsorship phrase, and orders draft comments shortest first.

  • The bundled awesome-triage skill now traces a candidate to its primary source, and verifies every row of a small factual table.

  • The bundled repomatic-ship skill now keeps signed commits inside the sandbox when the sandbox settings allow the signing agent’s socket and files.

  • The bundled babysit-ci skill now fetches run logs inside the sandbox first, and leaves it only when the gh cache write fails.

  • The bundled babysit-ci skill now reports a Cloudflare deploy that dropped a file over 25 MiB, and re-runs it only when the upload failed.

  • The bundled babysit-ci and repomatic-ship skills now keep their failure catalog and two rare procedures in references/ pages, read on demand.

  • Raise the tomlrt floor to 2.2.4.

7.16.3 (2026-09-30)ΒΆ

Note

7.16.3 is available on 🐍 PyPI and πŸ™ GitHub.

  • lint-repo now warns when a seeded tool config (ruff, pytest, coverage, mypy, mdformat) lacks an entry its bundled template gained after the seeding.

  • lint-repo now warns when a [tool.lychee] exclude entry is the bare form of one the bundled template has since anchored, which an ongoing sync grafts back beside its own replacement.

  • update-docs now lists each generated API page in its parent toctree, so a new module no longer needs a hand edit.

  • scan-virustotal gains --download and --repo, fetching the tag’s versioned binaries once its release lists them.

  • The bundled [tool.repomatic.gitignore] extra-content default now ignores .wrangler/, the local state wrangler writes in a checkout.

  • The bundled lychee.toml now excludes medium.com, which returns 403 to anonymous crawlers but serves the full article to a browser.

  • The bundled awesome-template contributing guide and awesome-triage skill now separate a crawler-blocked 403, which keeps its live URL behind a [tool.lychee] exclude, from a 404, which gets archived.

  • The bundled sphinx-docs agent now warns that an incremental build’s warning count covers only the pages it re-read.

  • The bundled sphinx-docs agent and sphinx-docs-sync skill now place developer setup on the contributing page, and flag a copy kept in readme.md or claude.md.

  • The bundled sphinx-docs agent now compares two builds only under equal dependency groups, and requires a fully qualified reference in a base-class docstring.

  • The bundled qa-engineer agent now moves a CLAUDE.md rule about one function, test or page beside that code.

  • The bundled repomatic-ship skill now names the transient empty run page a watcher must poll through rather than read as a finished suite.

  • The bundled repomatic-ship skill now classifies a version derived from a checked-in spec, whose bump breaks the recipe invoking it, and points a reading agent at git show HEAD:<path> instead of git stash.

  • The bundled repomatic-ship skill now re-reads the tree after the last gate command, which can re-create a mutation already reverted.

  • The bundled repomatic-ship skill now builds the docs with --fresh-env, so a reference broken in an unchanged page still surfaces.

  • The bundled file-bug-report skill now carries the evidence rules for an upstream report and the numbering behind a GitHub Actions log anchor.

  • The bundled babysit-ci skill now notes that gh run rerun --failed also re-runs the jobs skipped behind a failed or cancelled dependency.

  • Generated workflows, the lint-changelog annotations and the bundled typos, uv and zizmor configurations now cite the published documentation in place of claude.md, which downstream repositories no longer receive.

  • Raise the click-extra floor to 9.3.

  • Fix scan-virustotal failing when the freshly published release still lists no asset, which skipped the whole scan for that version.

  • Fix repomatic run --verify exiting 0 when it had no path to verify, like a bare typos run.

  • The bundled πŸ€– ci content rules no longer match .github, which pre-labelled every issue filed through an awesome list’s own new-link form.

  • Fix the bundled repomatic-audit skill claiming init refreshes a seeded mypy, pytest or coverage section, which it never revisits.

  • Fix the bundled repomatic-ship skill claiming CI resolves the project’s dependencies fresh, when its jobs install from uv.lock.

  • Fix the bundled sphinx-docs agent pointing a rule at a claude.md section, which downstream repositories do not receive.

  • The metrics and metric_chart docstrings now state that a star gained on a repository’s creation day replaces its created anchor, so not every series carries one.

  • The plugin page now warns that an account-enabled plugin also loads in the CLI, so pairing it with init skills registers every skill twice.

  • The plugin page now names the Desktop panel that takes the archive, the supported marketplace hosts, and where the off-by-default Sync automatically switch lives.

  • The plugin page now records that the CLI compares plugin.json rather than the catalog entry to detect an update, and that the Desktop app updates with no version change, both measured.

  • The contributing page now carries the conventions for developing repomatic itself: operation naming and contracts, and the rules for bundled agents and skills.

  • The workflows page now explains the over-long entry and empty release warnings that the lint-changelog annotations link to.

  • Fix the plugin page’s file-install command, which named an agents component instead of subagents.

  • Fix stale statements on the workflows, security, test matrix, operation contracts and upstream development pages.

7.16.2 (2026-09-20)ΒΆ

Note

7.16.2 is available on 🐍 PyPI and πŸ™ GitHub.

  • The bundled babysit-ci skill now recognizes a runner that died mid-step, which ignores a cancel and leaves no log, and re-runs its job.

  • The bundled ruff.toml now ignores D301, whose raw-docstring prefix breaks the \b marker Click reads in a command’s help text.

  • Fix verify-binary crashing on a Linux binary linked with packed relocations, which requires the GLIBC_ABI_DT_RELR symbol version.

  • Fix lint-changelog calling a release gap confirmed live when the GitHub lookup failed, and calling a gap on PyPI alone unconfirmed.

  • Fix the bundled babysit-ci skill waiting for a whole run to end before reading a failed job’s log, and fetching it without --allow-escape-sequences.

  • Fix an init test that queried GitHub and failed for a distribution building a release inside the cooldown window.

7.16.1 (2026-09-19)ΒΆ

Note

7.16.1 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: the bundled repomatic-upgrade skill drops its review and fix modes. It now always applies its changes, uncommitted.

  • Ship the test suite, and the repository files it reads, in the PyPI sdist, where tests needing a git checkout skip themselves.

  • sync-workflow-pins pull requests now label a uv pin stepped back onto the setup-uv checksum table βͺ stepped back.

  • sync-uv-lock pull requests now warn when the comment above exclude-newer-package still names an entry they cleared.

  • The bundled probe-workflow skill now keeps findings out of the retirement commit, gives a side-branch probe a push trigger, and records two hosted macos-26 traps.

  • The bundled repomatic-upgrade skill now catches local edits to synced skills and subagents that the upgrade reverts, and passes --repo to lint-repo so its API-backed checks run.

  • The bundled repomatic-upgrade skill now runs a changed job’s released code on the repository’s own inputs, and regenerates a committed upgrade in a scratch clone to check it.

  • The bundled sphinx-docs-sync skill now builds the documentation and counts its warnings before auditing, and re-locks uv.lock when it adds a docs dependency.

  • The bundled upstream-audit skill now sweeps an author’s issues and pull requests across GitHub, and resolves their states in one GraphQL query.

  • Remove anecdotes naming past releases or other projects’ threads from the bundled skills and the sphinx-docs agent.

  • Pause before retrying a truncated HTTP response, and retry it twice instead of once.

  • Fix lint-repo asking for GitHub topics that multi-word keywords already declare: Weather forecast now matches the weather-forecast topic.

  • Fix lint-changelog reporting a release newer than its day-old cache as missing, and --fix marking it unavailable, when the release’s section has no availability note yet.

  • Fix sync-workflow-pins and lint-repo for astral-sh/setup-uv v10.1.0 and newer: read its moved checksum table, and stop warning that an off-table uv installs unverified.

  • Fix concurrent repomatic run mdformat or shfmt calls in one directory losing the temporary config another call wrote.

  • Fix the bundled sphinx-docs agent asking for a robots.txt on a GitHub Pages project site, where crawlers never read it.

7.16.0 (2026-09-18)ΒΆ

Note

7.16.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: sample-metrics drops --backfill-wayback and --import-csv, since GitHub’s star-history endpoint now rebuilds every curve. Readings they already wrote stay in the store.

  • Breaking: unsubscribe-threads replaces --batch-size with --max-unsubscribes, which caps unsubscribes instead of inspections. The unsubscribe workflow’s batch-size input is renamed max-unsubscribes to match.

  • Add repomatic init --upgrade, which runs as the newest release past the minimum-release-age cooldown, so the upstream pin and every managed file move together.

  • The sync-repomatic job now opens an Upgrade repomatic to vX.Y.Z pull request once a newer release clears the cooldown, listing the breaking changes it crosses. Opt out with [tool.repomatic] upstream-pin.sync = false.

  • Add the repomatic-upgrade skill, which reviews what a newer repomatic release lets a downstream repository adopt, reuse or drop, then applies it.

  • repomatic init and the sync-workflow-pins and sync-repomatic pull requests now suggest the upgrade review after they move the repomatic pin.

  • sample-metrics now rebuilds every GitHub subject’s weekly star curve from GitHub’s star-history endpoint, back to its first star, for any public repository rather than only administered ones.

  • lint-repo now warns about labels a repository carries that no configured source declares, which sync-labels never deletes on its own.

  • Add [tool.repomatic] notification.max-unsubscribes and notification.months, which repomatic init bakes into the generated unsubscribe caller.

  • unsubscribe-threads now fetches only notifications last updated before the cutoff, unsubscribes the oldest first, and resolves their states in GraphQL batches of 50.

  • sync-workflow-pins now steps a uv pin back onto the checksum table of the pinned astral-sh/setup-uv, so every job installs a verified uv.

  • Raise the click-extra floor to 9.1.

  • Relative dates in the dependency tables and the cloudflare-pages token-expiry warning now count hours within the same day, instead of reading just now or 0 days away.

  • Fix the unsubscribe report’s phase-1 tables, whose first row carried an empty leading cell and last row two trailing ones.

  • The unsubscribe backlog warning now links the workflow’s manual-run page, and no longer breaks its prose into short lines in the job summary.

  • The bundled repomatic-ship skill now runs a downstream repository’s local checks on the repomatic version its workflows pin, so their tool versions match CI.

  • The bundled repomatic-ship skill now also checks hand-maintained registry blocks and the canary build’s binary self-test, and filters run listings by creation date.

  • The bundled repomatic-ship skill now recommends ruff -- check --no-fix for a read-only pass, smoke-tests the oxipng pin with --version, and takes :mirror: blocks from the update-docs pull request.

  • The bundled repomatic-ship skill now reads a sub-agent’s report from its idle notification when the agent cannot send one.

  • The bundled repomatic-ship skill now runs pyproject-fmt before uv lock when a release touches pyproject.toml.

  • The bundled babysit-ci skill now caps a commit body at two lines and 25 words, and filters per-workflow run listings by creation date.

  • Fix stale claims in the bundled benchmark-update, brand-assets, github-housekeeping and sphinx-docs-sync skills and the sphinx-docs agent about star-history curves, undeclared labels, and logo and ogp_image wiring.

  • Add a man-page index to the documentation, and cover --man, the release tarball and regeneration on the installation page.

  • Rename the installation page’s Try it, Install methods and Executables sections to Try it now, Installation methods and Binaries. Their old anchors no longer resolve.

  • Publish a sitemap, a robots.txt and a custom 404 page, and stop publishing a copy of every documentation source under _sources/.

  • Split the Development sidebar section into Contributing, API reference, Release and hosting and Project.

7.15.0 (2026-09-07)ΒΆ

Note

7.15.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: the manpages release job now renders through click-extra wrap --help-format man. The --man flag it used no longer writes roff.

  • Breaking: show-test-matrix now lists one row per job by default, and --flat is gone. Pass the new --grid for the compact two-axis pivot the command used to print.

  • Breaking: .claude/package-skills.sh is gone. It packaged one ZIP per skill for the Claude Desktop Customize > Skills panel, which a plugin supersedes by carrying every skill and agent at once.

  • Deprecated: repomatic metadata prints a deprecation warning and will be removed in 8.0.0. Use show-metadata, which joins show-config and show-test-matrix.

  • Deprecated: repomatic workflow lint prints a deprecation warning and will be removed in 8.0.0. Use lint-workflows, a flat command replacing the workflow group.

  • Add the probe-workflow skill: validate a claim about real-host behavior with a temporary GitHub Actions workflow, then retire it with its findings recorded in the retirement commit.

  • lint-repo gains a manpages-toolchain check, warning when a project opting into man pages locks a click-extra its release job cannot render with.

  • Add a runner_arch metadata key, mapping every runner label in the full test matrix to its CPU architecture.

  • Render each command’s worked examples in a dedicated Examples section of its help screen and man page, with the command lines highlighted.

  • Options taking a project-specific value now validate it, list the choices in --help and complete them in the shell: show-test-matrix, pr-body, pr-sync, update-dep-graph, ci-status and job-timings.

  • Help-screen sections regroup around a new β€œCI & runners” section, and each section now lists its subcommands alphabetically.

  • Sharpen the one-line help descriptions of show-metadata, prepare-release, lint-repo, run, fix-awesome-toc and cloudflare-pages.

  • sync-runner-images now rewrites a literal runs-on: as soon as a newer image supersedes it, instead of waiting for the old one to be deprecated.

  • The scan-virustotal pull request is now titled Update released binaries database, with a one-line body replacing its scan-records commentary.

  • Release blockers now carry a Clears countdown, in both the release pull request’s alert and a new lint-deps column, each linking the pull request of the job that lifts it.

  • The release pull request’s Squash and merge alert drops from caution to warning, leaving caution for the blocker banner the release lane cannot catch in time.

  • Trim the prose of the bump-version, detect-squash-merge, prepare-release, sample-metrics, setup-guide-cloudflare-pages, setup-guide-token, sync-dep-sources and sync-runner-images pull request templates.

  • The Claude Code plugin marketplace now installs .claude/ through a git-subdir source, which Claude Desktop and Cowork accept, and tracks the default branch so skill fixes land between releases. Adding the catalog at a tag still installs that release.

  • The plugin manifest moved to .claude/.claude-plugin/plugin.json, so claude --plugin-dir .claude loads the plugin straight from a checkout.

  • Document the Intel macOS support policy: macos-x64 binaries ship for as long as GitHub Actions offers an Intel runner image to build them.

  • Illustrate the readme and docs with live captures: the CLI help screen, an animated sync-deps --dry-run session, the test-matrix grid and a configuration example.

  • Raise the click-extra floor to 9, required by the new Examples help sections and the manpages release job.

  • Bump Nuitka from 4.1.3 to 4.2.

  • Fix uv’s resolution summary scribbling over the sync-deps progress trail.

  • Fix repomatic run printing a Python traceback for an unknown tool name. It is now a usage error listing every registered tool.

  • Fix the plugin component rewriting a settings file format-json had already settled, which kept sync-repomatic and the autofix lane undoing each other. The wiring now compares the parsed document, not its text.

  • Fix the generated release.yaml ending on a stray blank line, alone among the workflow callers.

  • Fix lint-repo asking for GitHub topics a project already declares: topics now match [project] keywords case-insensitively, since GitHub lowercases every topic it stores.

  • Fix sync-runner-images proposing a probe for a runner image the repository already runs, which marked every test-matrix cell on that image continue-on-error.

  • Fix run {tool} --verify crashing with a FileExistsError on a path resolving to the working directory, which now verifies the tool’s own default file set.

  • The bundled babysit-ci, probe-workflow and repomatic-ship skills now read CI runs through the GitHub API, after gh run list reported month-old runs as the newest.

  • Fix stale references in the bundled babysit-ci, repomatic-audit, repomatic-changelog, repomatic-ship and repomatic-test-matrix skills: dangling claude.md pointers, a retired lychee.toml path, an inverted binary-build condition and stale workflow names.

  • The bundled file-bug-report skill now states when a GitHub permalink renders as a code snippet, and how to read a line range off the commit it pins.

  • The bundled babysit-ci and repomatic-ship skills now treat a wall-clock budget failing on a shared runner as a test defect to fix, not transient infra to re-run.

  • The bundled repomatic-ship skill now warns that actionlint and zizmor can contradict each other, and says how to settle a conflict between them.

  • Document the mdformat defect that silently deletes a backtick code span inside a Markdown image’s alt-text.

7.14.0 (2026-08-27)ΒΆ

Note

7.14.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: the agent component is gone, with the agent.location config key and the bundled claude.md reference document. repomatic init no longer writes to a repository’s instructions file, which each repository now owns outright.

  • Breaking: CLOUDFLARE_ACCOUNT_ID is gone: the account derives from CLOUDFLARE_API_TOKEN alone. cloudflare-pages --account-id and lint-repo --has-cloudflare-account-id are removed with it.

  • Breaking: the debug.yaml workflow is now opt-in, gated by a new [tool.repomatic] debug.sync key. A repository already carrying it keeps it by setting debug.sync = true.

  • Breaking: the arch field of repomatic metadata’s build_targets and nuitka_matrix output now reads x86_64 and aarch64, not x64 and arm64. Update any workflow branching on matrix.arch.

  • Breaking: build_targets and nuitka_matrix replace the glibc_floor and min_os keys with a single floor, holding the same versions. A workflow reading matrix.min_os needs matrix.floor.

  • lint-repo gains two checks: setup-uv-checksum-coverage, warning when CI installs the pinned uv unverified, and classic-branch-protection, reporting a branch protection rule left beside a ruleset.

  • show-test-matrix gains --row-axis, --col-axis and --flat, laying the grid out on any job key the matrix carries or listing one row per job.

  • show-test-matrix states how many jobs a cell stands for (βœ… stable Γ—5), and sorts its Python rows by release instead of job order.

  • scan-virustotal and sample-metrics publish through one long-lived pull request that each run appends to, instead of committing to the default branch. No file-modifying job pushes there any more.

  • Both gain --carry-from, restoring the store from a remote branch first, so records pending in an open pull request are appended to rather than dropped.

  • sample-metrics names the phase (forward, reconstruct, import or wayback) in a new column of its report table, so one subject reads as one outcome per phase.

  • cloudflare-pages --create is now idempotent: an existing Pages project is reused and reconciled against the declared settings, instead of failing on the API’s 409 duplicate-name refusal.

  • The Todo list documentation page lists the project’s pending work: each deferred change is written as a todo admonition beside the code or prose it acts on.

  • The repomatic-ship skill now sweeps those admonitions: pending work the cycle introduced is written as one, and a todo whose upstream trigger fired is retired with the shim it guards.

  • metadata and every glob-driven check now walk the repository tree once and skip .git/, instead of re-walking it on every lookup.

  • ci-status locates every workflow’s newest run through one branch-wide listing instead of one query per workflow.

  • Every HTTP fetch now identifies itself with a repomatic/{version} user agent.

  • sync-workflow-pins no longer bumps the uv pin past what the pinned astral-sh/setup-uv can checksum-verify: the action silently skips validation for a version its bundled table does not list.

  • show-config wraps its widest columns instead of running past 240 characters. A format unable to hold a wrapped cell, like github or csv, stays unwrapped.

  • list-skills renders a table honoring --table-format, replacing the hand-padded lines that ran to 500 characters.

  • sync-runner-images takes --live like every other command with a dry-run mode, replacing its odd --no-dry-run spelling.

  • Dependency-update pull requests no longer list yanked or pre-release versions in their intermediate release notes.

  • The bundled [tool.typos] config no longer checks SVG content: a terminal capture splits words across <text> runs, so correcting a fragment corrupts the image.

  • The lint-repo stale gh-pages check now passes only on a confirmed 404: any other API failure reports as skipped instead of green.

  • Fix lint-repo flagging every test-matrix.exclude entry as stale on a full-include matrix, and the finding now names the missing axis values.

  • Fix lint-deps missing a dependency floor declared with > when checking floors against the cooldown window.

  • Fix lint-deps asking an aggregate extra selecting the project’s own extras for a version floor, which a project can never declare on itself.

  • Fix metadata leaving the checkout on a past commit with changes stashed when a mid-scan git command fails.

  • Fix the sample-metrics chart crashing on a series whose peak is 0 or 1.

  • Fix sample-metrics abandoning the tail of a sampling pass to GitHub’s secondary rate limit: the gh plumbing now retries the refusal on a bounded backoff.

  • sample-metrics --backfill-wayback gives up after ten consecutive refusals and reports to retry later, instead of spending every remaining capture’s retry schedule against an exhausted per-IP budget.

  • Fix show-test-matrix leaving a cell bare when several jobs share it: every state of a stable, unstable cell now carries its own glyph.

  • Fix the plugin component writing tab-indented settings into a repository whose Biome config asks for spaces, which had sync-repomatic and format-json fighting each other. The indent now follows that config.

  • Fix init leaving behind the folder of a removed skill whose SKILL.md was already gone: the tombstone addresses the file, so an empty folder outlived every later run.

  • Fix format-images dropping its optimization summary table from the PR body, lost in 7.11.0 when its two PR-publishing steps collapsed into one.

  • The skills, subagents and plugin documentation pages group under an Agent tooling section and move to /agent-skills, /subagents and /claude-code-plugin, with the old URLs redirecting.

  • The generated API reference moves off the guide pages and splits one page per module (/repomatic.awesome_toc), instead of stacking a whole package onto one page. The guide pages keep their prose and link to it.

  • The Python compatibility table of the install page marks a version a release neither declared nor excluded with –, instead of counting it as unsupported.

  • The commit-messages page and the bundled skills now hold a commit body to three cases: bundled orthogonal work, a link to a public record, or a Closes #N pointer.

  • Fix the exclude example of the configuration page naming zizmor, which is not a component: copying it made repomatic init fail.

  • Fix stale guidance in the bundled skills: two module pointers the regroup broke, the scan history now published through a pull request, and a retired upstream contribution target.

  • Fix the dead claude.md section cross-references the bundled skills and subagents carried, and guard against new ones.

  • Sphinx linkcheck no longer reports every release-asset download URL as broken: conf.py withholds its github.com credential from those URLs, which GitHub redirects to a host that answers 401.

  • Fix the dead links on the install and operation-contracts pages, and the API reference documenting every regrouped module twice.

7.13.0 (2026-08-17)ΒΆ

Note

7.13.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: the agents component is renamed subagents, its config key agents.location becoming subagents.location. Naming the old component in [tool.repomatic] include or exclude fails the init; the old config key is ignored with a warning.

  • Breaking: repomatic init claude is renamed repomatic init agent, and its destination follows [tool.repomatic] agent.location (defaulting per [tool.repomatic.flavor] agent) rather than a fixed root-level claude.md, reaching instructions kept as AGENTS.md or outside the root.

  • Breaking: the runner-images command, its workflow job and its [tool.repomatic] runner-images config key are gone, along with the issue they maintained; sync-runner-images closes that issue on its first run.

  • Breaking: the Cloudflare Pages deploy needs only CLOUDFLARE_API_TOKEN: a token scoped to Cloudflare Pages: Edit resolves its own account, so CLOUDFLARE_ACCOUNT_ID becomes an override for a credential spanning several accounts; cloudflare-pages --account-id prints the identifier for that case.

  • Breaking: the VirusTotal scan history moves from docs/assets/virustotal-scans.json to virustotal-scans.csv. The first scan-virustotal run after upgrading converts the old JSON on its own; delete the stale .json afterwards.

  • New [tool.repomatic] site.deploy config choosing where the built site publishes: github-pages, the default, or cloudflare-pages through wrangler pages deploy, with site.cloudflare-project naming a Pages project that predates the repository.

  • New cloudflare-pages command reconciling the live Pages project against the declared site.* state: --check, --apply, --dump, and --create for rebuilding from nothing. Warns a month before the API token expires, which Cloudflare never signals.

  • New cloudflare-pages --attach-domain serving a project at a custom domain, creating the proxied CNAME record the bare API leaves missing.

  • New cloudflare-config-drift job in the Docs workflow running that check apart from the deploy, so drift is loud without holding up publishing.

  • lint-repo now fails a committed _redirects file that would lose rules to the Cloudflare Pages engine’s silent budget accounting, naming each URL a dropped rule leaves dead or silently misredirected.

  • lint-repo now warns when wrangler.toml contradicts the declared Cloudflare Pages project name or compatibility date, and checks a migrated site keeps its GitHub Pages custom domain pointing at the new host so published github.io URLs keep redirecting.

  • The Cloudflare deploy job now drops files over Direct Upload’s 25 MiB per-file limit, naming each in the log, instead of failing the whole upload on the first one.

  • The Docs workflow now runs monthly, mirrored into downstream callers: a lapsed Cloudflare token becomes a red run, and link rot surfaces between pushes.

  • The Docs workflow no longer publishes Sphinx’s parse cache: doctrees now build in the runner’s temp directory instead of riding the Pages upload, 118 MB of a 182 MB artifact on an autodoc-heavy project.

  • Every setup guide step is rewritten to the actions it asks for; the guide and lint-repo now ask about whichever host site.deploy names, and the Cloudflare step hands out a pre-filled account-owned token form.

  • New sample-metrics command recording what forges say about the repositories a project tracks into one committed CSV: star count, newest release or tag, and newest commit, read from GitHub, GitLab and Forgejo instances.

  • sample-metrics renders the accumulated history as themeable SVG charts, replacing the star-history embeds GitHub’s 2026 stargazer restriction broke. Star history recovers from per-star timestamps, archived pages with --backfill-wayback, or a star-history.com export with --import-csv.

  • New [tool.repomatic.metrics] charts option scale = "logarithmic", measuring the vertical axis in powers of ten so series orders of magnitude apart stay legible on one chart.

  • New opt-in metrics.yaml workflow running the sampler weekly and committing its store. Enable with [tool.repomatic] metrics.sync = true and declare the repositories to follow in [tool.repomatic.metrics] subjects.

  • New sync-runner-images command and weekly job opening a pull request that moves a deprecated runner image onto its successor, or probes a strictly newer one as continue-on-error. Decline a proposal for good with [tool.repomatic.sync-runner-images] ignore.

  • New job-timings command reporting median whole-job wall-clock per runner image, read from recent successful runs.

  • lint-deps now warns about a dependency floor comment running past [tool.repomatic] lint-deps.comment-word-threshold words, 40 by default.

  • New lint-anchors command checking every authored same-page fragment link against the anchors the built site actually carries, run by the Docs workflow before each deploy.

  • New pr-body and pr-sync option --template-arg-file KEY=PATH, reading a template value from a file for a value with no ceiling on its size.

  • New git-commit-push option --all-changes, staging everything the working tree carries instead of a named path list.

  • New bundled repomatic-test-matrix skill deciding which Python versions, operating systems and runner images earn a test-matrix cell.

  • Bundled guidance moves its release-repair, label-retirement and test-matrix procedures out of claude.md and into the skills that run them, leaving the always-loaded file carrying rules rather than checklists.

  • The bundled repomatic-ship skill now names all three shapes an unanswered hardware-key signing prompt produces, treating a silent hang as a missed prompt rather than a slow command.

  • The bundled sphinx-docs agent’s page roster gains the plugin, commit-messages and history pages.

  • The release PR’s unshippable-dependency warning is now a single line naming each package, each linked to the line declaring it, instead of a paragraph and a four-column table.

  • The binaries catalog now leaves the VirusTotal cell empty unless a scan record backs it, instead of linking every binary to an analysis page that was never created.

  • The bundled [tool.typos] config now accepts PNGs and PATCHed, which typos otherwise splits and rewrites to ONGs and PATCHead.

  • repomatic init no longer drops the comment documenting a bundled template’s first key: six of the nine templates were losing their opening comment, the [tool.typos] proper-noun map among them.

  • Fix ci-status --help collapsing everything after its first example into one garbled line.

  • update-dep-graph now reads the root’s direct dependencies from uv.lock: uv’s SBOM export promoted a dependency-group package to a primary dependency whenever an extra pulled it in transitively.

  • New Cloudflare Pages documentation page covering Direct Upload, token scoping and rotation, the drift check, and the redirects engine’s undocumented accounting. It opens on a runbook taking a bare domain name to a published site in seven commands.

  • This project’s documentation moves to repomatic.net, and its links move with it: every reference now names the extensionless URL Cloudflare Pages serves. The old kdeldycke.github.io/repomatic addresses keep redirecting.

7.12.1 (2026-08-15)ΒΆ

Note

7.12.1 is available on 🐍 PyPI and πŸ™ GitHub.

  • New [tool.repomatic] sphinx.builder config choosing the Sphinx builder the Docs workflow deploys, so a project can publish extension-less URLs with dirhtml.

  • The bundled repomatic-ship skill now reads a green CI run as stale when supersession cancelled every run between it and HEAD, and ships a release’s own reflection findings in that same release.

  • Bundled guidance now requires a duration baseline and per-job timestamps before calling a CI run hung, and repomatic-ship no longer holds a green release waiting for a binary build.

  • Fix stale guidance in the bundled agents and skills: the update-docs job credited to the wrong workflow, Furo logo and OpenGraph settings contradicting a working configuration, and a repomatic invocation that fails outside the canonical repository.

  • New repomatic init claude component projecting the audience-tagged sections of the bundled claude.md into a repository, leaving every section that repository wrote for itself untouched.

  • Bundled guidance now declares which repositories each claude.md section applies to, and documents what a repository consuming repomatic owns: its workflow content, its pin, and its configuration.

  • The bundled repomatic-audit skill now reads those tags to tell a synced section from a repository’s own, instead of classifying each one by hand.

  • Fix two stale claims in the bundled guidance: the workflow permissions contract is generated rather than hand-written, and PAT-gated lint-repo checks report as skipped rather than failing the job.

7.12.0 (2026-08-14)ΒΆ

Note

7.12.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • New ci-status command reporting each workflow’s latest run and which of its failing jobs gate a merge, read from jobs rather than run conclusions.

  • New repomatic run <tool> --verify reporting which files a formatter would rewrite, without touching the working tree.

  • repomatic run now resolves a tool’s targets itself when given no arguments, and skips a tool with no matching file instead of invoking it pathless.

  • New repeatable pr-sync --add-path option limiting what the pull request commits to a git pathspec list.

  • lint-deps now warns about declarations departing from version policy: upper bounds, missing floors, unsorted lists, misplaced type stubs, uncommented floors. Disabled with --no-policy.

  • lint-deps now names the lint-deps.allow exemption in the remedy it prints for a git source.

  • sync-workflow-pins now backfills a missing --exclude-newer-package exemption on a run that moves no version, instead of computing the splice and discarding it.

  • lint-repo now fails when an inline upstream pin resolving under a cooldown carries no --exclude-newer-package exemption, which takes every needs: metadata job down with it.

  • lint-repo now warns when an astral-sh/setup-uv step declares no version: input, or when steps across the repository pin more than one uv version.

  • lint-repo now fails, and repomatic init now warns, when a workflow asks repomatic metadata for a key that no longer exists.

  • lint-repo now warns when a Sphinx project’s GitHub website field differs from the documentation URL declared in [project.urls].

  • lint-changelog now warns about a released section holding no entry.

  • runner-images now watches every image the workflows name literally, not just the curated test axes.

  • A bare repomatic init now re-syncs a tool config the repository already carries, so [tool.typos], [tool.uv] and [tool.bumpversion] follow the bundled template once adopted.

  • Every job now caps its runtime with timeout-minutes, so a hung job frees its runner in minutes instead of the platform’s 6-hour ceiling. Downstream callers inherit the caps.

  • The Docs workflow now triggers on readme.*.md, so a push touching only a translated readme no longer skips link checking.

  • repomatic run actionlint now ships a bundled config declaring the ubuntu-26.04 runner labels actionlint 1.7.12 predates.

  • The bundled lychee.toml now excludes bitdefender.com, npmjs.com, star-history.com and githubstatus.com, which answer bots with 403, 405 or JavaScript rather than a link.

  • cancel-runs now spares a run whose head commit carries [changelog] Release, so a sweep of the default branch cannot kill a release matrix.

  • Fix gh re-downloading on every command instead of once per version: a binary nested in an archive subdirectory was stored under one cache key and looked up under another.

  • Fix repomatic init realigning a workflow’s inline repomatic==X.Y.Z pin without the cooldown exemption beside it, leaving a command that cannot resolve the version just written.

  • Fix audit --fix dirtying uv.lock with a cooldown-override record when no upgrade was reachable, which opened a fix-vulnerable-deps pull request carrying no fix.

  • Fix repomatic init restyling a locally added array item when it re-syncs a tool config, which had sync-repomatic and format-pyproject endlessly opening pull requests undoing each other.

  • A formatter exiting with its rewrite status while leaving every target unchanged is now reported as a crash, instead of passing for a successful reformat that never happened.

  • Fix stale guidance across the bundled skills: wrong [tool.repomatic.workflow] key names, wrong workflow and job names for lint-deps and lint-changelog, which tools a bundled default actually covers, and downstream audits comparing against main rather than the adopted release.

  • Fix the bundled babysit-ci skill classifying a CI job by a leading βœ…, which dropped every required job whose name carries no stability glyph from the failures it collects.

7.11.0 (2026-08-13)ΒΆ

Note

7.11.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: labels.content-rules and labels.file-rules are now tables mapping each label to its patterns, like "πŸ“š docs" = ["docs/**"]. The array-of-tables form and its actions/labeler v5 matcher schema are gone; an un-migrated config is ignored with a warning.

  • Breaking: the file-labeller and content-labeller jobs merged into a single apply-labels job. Update any required check or needs: edge naming them.

  • Breaking: repomatic init and repomatic workflow lint take --upstream-repo for the upstream toolkit; --repo now means the owner/name slug everywhere, including on sync-labels.

  • New pr-sync command replacing peter-evans/create-pull-request in every job: opens, refreshes or retires an automation PR from one --template flag. Its PR closes even when the job’s if: gate skips the rest of the step.

  • New lock-threads command replacing dessant/lock-threads in the autolock job. It skips threads carrying the πŸ€– ci label, so an issue repomatic maintains is no longer locked out of reopening when its condition recurs.

  • New apply-labels command replacing actions/labeler and github/issue-labeler in the labeller job. A rule’s entry overrides the bundled default for that label, and an empty list disables it.

  • The debug job’s context dump no longer runs crazy-max/ghaction-dump-context, and no longer installs cgroup-tools and cpuid to read them. It now reports the kernel, disk, CPU and memory of every runner using only what the image already ships.

  • A bare content pattern is now a keyword, matched case-insensitively on word boundaries, so "πŸ› bug" = ["bug", "error"] works as written; the /…/flags form passes a regex through. Keyword lists used to be AND-joined and never fired.

  • repomatic init labels no longer writes .github/labeller-content-based.yaml or .github/labeller-file-based.yaml: the default rules live in the package, and repomatic init now prunes an unmodified committed copy automatically. Move customizations to [tool.repomatic.labels]; a hand-edited copy is left for review instead of deleted.

  • The sponsor-label command now applies the πŸ’– sponsor label the registry defines, instead of a plural variant that exists in no repository and failed every labelling attempt.

  • pr-sync now clears a conversation lock standing in the way of retiring a stale automation PR, instead of dying on the refused close comment.

  • sync-labels now hands labelmaker the canonical token (REPOMATIC_PAT, then GH_TOKEN, then GITHUB_TOKEN), so an environment carrying only the PAT syncs authenticated.

  • Every re-lock (sync-dep-sources, audit --fix) now passes the project’s own [tool.uv] exclude-newer explicitly, so CI’s ambient UV_EXCLUDE_NEWER can no longer retime the lock.

  • lint-repo now runs the branch-ruleset and immutable-releases checks it already defined but never invoked.

  • apply-labels no longer applies πŸ’– sponsor from the words β€œfunding” or β€œsponsor”, or from a pull request touching .github/funding.yml: only sponsor-label sets it, from actual sponsorship.

  • Every gh call now runs the registry-pinned, checksum-verified binary, falling back to $PATH with a warning when it cannot be installed.

  • Test jobs running an unreleased Python are now titled py3.15-dev, so a continue-on-error cell states why it is allowed to fail.

7.10.0 (2026-08-12)ΒΆ

Note

7.10.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: the update-dep-graph job moved from autofix.yaml into the release engine, its only firing moment being a release push. A required check or needs: edge naming it under Autofix must follow.

  • Breaking: manual version-bump commits now read [changelog] Bump minor version to `vX.Y.0`: every version-machinery commit carries the [changelog] prefix, and anything matching the old unprefixed titles must follow.

  • Breaking: the default test matrix moved to ubuntu-26.04-arm and ubuntu-26.04, retiring ubuntu-slim: every job now runs on a test-matrix runner. Pin the old images back with test-matrix.replace.os = { "ubuntu-26.04-arm" = "ubuntu-24.04-arm" }.

  • Breaking: a report emitted with --output-format github-actions now travels as a file: the step output is named <key>_file and holds a path, so a large report reaches a PR body intact. A workflow reading steps.<id>.outputs.diff_table must read .diff_table_file instead.

  • New lint-deps command and release-lane job, blocking a release whose dependencies do not all resolve from PyPI: git branches, forks, local paths, direct URLs and private indexes. Exempt a package with [tool.repomatic] lint-deps.allow.

  • New runner-images job and CLI command, opening an issue that lists GitHub’s open runner-image announcements and flags the ones retiring an image the repo runs on. Opt out with runner-images = false.

  • New is_python_package metadata key. sync-bumpversion now gates on it instead of is_python_project, so the job no longer opens [tool.bumpversion] PRs against a uv virtual project ([tool.uv] package = false).

  • New --prefix-file option on pr-body, and a matching GHA_PR_BODY_PREFIX_FILE variable, reading the body prefix from a file.

  • Autofix jobs no longer run on version-bump pushes, which only re-checked machine-generated commits; drift stays covered by the next push and the weekly sweep.

  • repomatic init no longer writes the running version’s workflow content beside a pin the cooldown held back: a repository that already carries workflows keeps them untouched until the release is adopted.

  • The repomatic-ship skill now reconciles bundled skills and agents as a third pass, judges a false-positive autofix PR against current main, and distinguishes a superseded intra-cycle measurement from a genuine contradiction.

  • macOS Nuitka builds now hit their compile cache: ccache hashes paths relative to the runner root (base_dir), so uv’s randomly-named cache path no longer changes the hashed compiler arguments every run.

  • The tool runner now retries a download up to 3 times on transient network failures, instead of failing the job on a one-off TLS or truncation error.

  • Standalone binary tests now run for every healthy target when a sibling build fails, instead of being skipped wholesale.

  • Oversized step outputs are trimmed instead of killing the step that reads them with Argument list too long.

  • The setup guide issue now reopens when Actions SHA pinning is turned off, instead of closing while reporting every repository setting complete.

7.9.0 (2026-08-10)ΒΆ

Warning

The windows-x64 binary shipped without its .attestation.json sidecar: a transient TLS failure on the runner skipped the upload, and immutable releases lock the asset list. The attestation itself is registered, so gh attestation verify repomatic-7.9.0-windows-x64.exe --repo kdeldycke/repomatic still verifies against GitHub’s attestation service.

Note

7.9.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: REPOMATIC_PAT now requires Administration: Read-only, and lint-repo fails without it. Regenerate the token with the setup guide’s pre-filled link; steps that cannot be verified now say so instead of vanishing.

  • New [tool.repomatic] nuitka.dev-targets option: an ordinary push now compiles binaries only for a canary subset, ["linux-arm64"] by default. Release commits, a new weekly schedule and manual dispatches build the full 6-target fleet.

  • lint-repo now also verifies versionless releases/latest/download URLs in docs/install.md, catching a renamed asset that leaves the guide pointing at a 404.

  • sync-workflow-pins now walks npx pkg@1.2.3 version literals forward, not just npm install and uvx pins.

  • repomatic init now realigns a workflow’s inline repomatic==X.Y.Z literal onto the pin it writes into the uses: refs, in either direction.

  • Nuitka compile caches now persist across runs, so a warm build skips most of the C compilation. Release commits and macOS builds opt out, so no published binary is influenced by cached objects.

  • Compile, binary-test and VirusTotal-scan jobs now carry execution timeouts, so a hung job frees its runner slot instead of squatting it for 6 hours.

  • Scheduled and manually dispatched release runs get their own concurrency group, so a later push no longer cancels them mid-build.

  • Binary self-tests on non-release pushes now run inside the compile job; the standalone per-target test jobs run on release commits only.

  • sync-gitignore no longer discards rules added by hand to the committed .gitignore: it refuses to write when the rebuild would lose one, naming the rules. New --drop-orphans flag confirms an intended loss.

  • The setup guide no longer asks a uv virtual project to register a PyPI Trusted Publisher, and lint-repo no longer checks one: both now gate on whether the project builds a distributable.

  • Fix the broken-links issue never being filed: docs.yaml ran lychee through xargs, which reported its β€œbroken links found” exit status as a crash.

  • A Bad credentials 401 now fails immediately instead of retrying a token that cannot recover, so a revoked REPOMATIC_PAT reports itself plainly rather than as a chain of unrelated check failures.

  • New Nuitka compilation guide covering build targets, fleet cadence, compile caching, the LTO stance, and upstream workarounds.

  • New Build backends section in the packaging guide, covering the [tool.setuptools] package-discovery shim a distribution needs when it builds a uv-build project with setuptools.

  • The documentation sidebar logo now follows Furo’s light and dark toggle, so the wordmark no longer renders near-black against the dark theme.

7.8.0 (2026-08-09)ΒΆ

Note

7.8.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: the Codecov integration is removed, along with the codecov component, its .github/codecov.yaml, and the coverage_cells metadata key. repomatic init prunes an untouched orphaned config; delete the CODECOV_TOKEN secret and coverage badge by hand.

  • Breaking: attestation bundles now carry the full filename of the asset they attest, so repomatic-manpages.attestation.json becomes repomatic-manpages.tar.gz.attestation.json. A repository declaring one extra asset gets <filename>.attestation.json in place of <package-name>-extra-assets.attestation.json.

  • New pack-attestation command names an attestation bundle after the asset it attests and prints the release upload list.

  • New coverage component: repomatic init coverage writes a [tool.coverage] section carrying branch coverage, report precision and a report.fail_under ratchet, shipped disabled.

  • lint-repo now warns when a release download URL in docs/install.md names a file its release does not carry.

  • The bundled pytest config drops --cov-branch and --cov-precision from addopts, now carried by the coverage component. Existing [tool.pytest] sections are left alone; run repomatic init coverage to pick the settings back up.

  • The release lane’s publish-release job now checks out the repository, so uploading binaries to the release no longer fails with Failed to spawn: repomatic. 7.7.0 shipped with no standalone executables because of it.

  • lint-changelog re-confirms a release live before dropping its availability admonition, so a day-old cache no longer reports a just-published version as missing.

  • The readme’s logo is now an absolute URL, so it renders on the PyPI project page instead of 404ing.

  • The install guide’s executable table points at the last release that carries binaries, instead of a version whose upload lane failed.

7.7.0 (2026-08-09)ΒΆ

Note

7.7.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: drop the check-version command: nothing invoked it, and workflows read the minor_bump_allowed and major_bump_allowed metadata keys instead.

  • Breaking: drop the clean-unmodified-configs command, superseded by repomatic init --delete-unmodified.

  • Breaking: repomatic metadata no longer emits the toml_files, changelog_bullet_word_threshold, nuitka_enabled and nuitka_nofollow_imports keys. No workflow consumed them; the three config fields are read directly by their subcommands.

  • New github-housekeeping skill backfills and curates labels and milestones across a repository’s full issue and PR history: taxonomy design, cache-backed bulk classification with review gates, AI-slop detection from closed-without-comment signals, and milestone assignment by changelog, git-tag, and release-date archaeology.

  • New pack-binaries command materializes the versionless binary aliases and prints the release upload list, replacing the release engine’s shell loop: the asset naming convention now has one Python definition, shared with the install-guide freeze.

  • New --default-branch option on the changelog command, so a repository whose default branch is not main gets a comparison URL that round-trips through the release freeze.

  • init no longer writes the release lane (changelog.md, changelog.yaml, release.yaml, the PyPI publish action) into a uv virtual project ([tool.uv] package = false). Dependency locking, coverage and test tooling still apply.

  • init now lists each awesome-template file it writes instead of one summary line, and init labels no longer reports its regenerated files as unmodified configs to clean up.

  • Rename the Claude Code plugin release asset to repomatic-claude-plugin.zip, as repomatic-plugin.zip read as a plugin for repomatic. /plugin install is unaffected.

  • Attestation bundles are now named after the asset they cover (repomatic-manpages.attestation.json) rather than the job that produced them, so the eight binary bundles no longer overwrite each other down to a single file.

  • The VirusTotal detections chart now pins its CDN script with a Subresource Integrity digest, so a tampered copy is refused by the browser.

  • sync-workflow-pins now splices the --exclude-newer-package cooldown exemption beside the inline repomatic==X.Y.Z pin it realigns, in the single spelling the release freeze writes and the post-release unfreeze recognizes.

  • The changelog’s [!CAUTION] admonition for a yanked release now quotes the reason PyPI recorded for the yank, when there is one.

  • Changelog links are discovered under any capitalization of the PyPI project_urls key, matching how source URLs were already resolved.

  • PyPI release lookups order same-day publications by PEP 440, so 1.10.0 is no longer ranked below 1.9.0.

  • Dependency-update PR bodies omit the version comparison link when the upstream repository publishes no matching tags, instead of linking to a 404.

  • format-images now installs and verifies its oxipng binary once per run instead of once per optimized image.

  • Registry binary downloads and update-checksums now carry a stall timeout, and update-checksums rejects truncated bodies instead of recording their digest as the new canonical checksum.

  • GitHub token validation now times out instead of hanging forever when the API is unreachable.

  • The zsh_files metadata key now lists only shell scripts whose shebang names zsh, so a bash .sh file is no longer linted as Zsh.

  • repomatic metadata no longer aborts on a src-layout project: a Nuitka entry point with no module file at the repository root is skipped with a warning.

  • lint-repo now reports an unreadable rulesets API as a skipped branch-protection check rather than a failed one.

  • The broken-links issue no longer claims broken links when lychee itself failed to run.

  • The release freeze now warns when it finds no changelog section for the version being released, instead of silently doing nothing.

  • lint-changelog --fix now exits non-zero when it could not repair every problem it reported, instead of reporting success as soon as any one fix landed.

  • lint-changelog --fix no longer stamps an undatable orphaned version with a 0000-00-00 placeholder date, and files a datable one in order even when every existing heading is a .devN development section.

  • sync-uv-lock parses uv.lock once per phase instead of once per lookup, cutting several hundred milliseconds off each run.

  • Fix downstream tool caches frozen at their first write: the reusable workflows’ cache keys hashed a file that only exists upstream. Keys now rotate with the reusable workflow’s own commit SHA.

  • Fix init misreading a thin caller’s trailing comment or odd-indented job line as extra downstream jobs, which silently flipped the file onto the explicit-permissions contract or duplicated the managed job’s tail below the regenerated lanes.

  • Fix init mishandling a consumer’s extra release jobs: the extra needs: edges declared on the release lane were dropped, and a blank line accumulated above the jobs on every sync.

  • Fix init --output-dir scanning the current directory for unmodified configs, which made --delete-unmodified act on the wrong tree.

  • Fix the generated release.yaml emitting a bare needs: (which GitHub rejects at startup) when every canonical edge is filtered out.

  • Fix a [tool.repomatic.workflow] paths override emitting entries like **/*.py unquoted when the canonical block held no quoted entry to copy, which parsed as a YAML alias and left the workflow silently ignored.

  • Fix repomatic metadata crashing on a repository carrying a tag the version parser refuses, like v1.2.3_hotfix.

  • Fix sync-action-pins and sync-workflow-pins silently reverting each other’s edits when one sync-deps run bumps both kinds of pin in the same workflow file.

  • Fix a mid-resolve failure of sync-uv-lock leaving synced policy pins beside a stale lockfile for the CI job to commit: the project is now restored to its pre-run state on any error.

  • Fix sync-mailmap crashing with UnboundLocalError on a repository that has no .mailmap yet, the exact bootstrap its default --create-if-missing advertises.

  • Fix the sponsor labeller treating an empty pull_request event payload as a pull request.

  • Fix issue-filing jobs failing to record a new issue when gh prints a notice above the issue URL.

  • Fix update-dep-graph failing on Windows when a dependency’s SBOM metadata contains non-ASCII characters.

  • Fix cache clean scoping: --namespace no longer wipes binaries and tool configs, --tool no longer wipes HTTP responses, and --max-age now applies to cached configs instead of deleting them all.

  • Fix repomatic run mypy aborting with Unable to find lockfile in a repository without a uv.lock: the tool now runs in an isolated, cooldown-gated environment when there is no lockfile to freeze.

  • Fix binary tools executing a just-deleted staging copy when the cache write is lost (Docker overlay runners) or the cache root is unwritable: the fallback copy now survives for the whole process.

  • Fix the published plugin manifest declaring the post-release .devN version rather than the release it ships with.

  • Fix image optimization leaving a .bak file in the working tree when interrupted.

7.6.0 (2026-08-08)ΒΆ

Note

7.6.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: the labels component is now ephemeral: labels.toml and the two labeller YAMLs are staged only when named explicitly (repomatic init labels). A repository that committed them sees them reported as excluded files on disk, removable with init --delete-excluded.

  • New fix-awesome-toc command deletes the table-of-contents entries awesome-lint forbids from readme.md and every readme.{lang}.md beside it, matching translated sections by position rather than by their English name.

  • The bundled skills and agents are now published as a Claude Code plugin: /plugin marketplace add kdeldycke/repomatic then /plugin install repomatic@kdeldycke. Needs Claude Code 2.1.224 or later. Addresses #2378.

  • New pack-plugin command builds the attested repomatic-plugin.zip asset every GitHub release now carries, with the marketplace URL pinned to the release tag.

  • New init plugin component merges the plugin’s marketplace and enablement keys into a repository’s .claude/settings.json, leaving every other setting untouched. New [tool.repomatic] settings.location moves the destination.

  • lint-repo now checks a repository’s own pr-body --template-file templates: they belong in .github/pr-templates/, must exist, and must carry a title and a bare footer: false.

  • A failed extra-assets job now leaves the GitHub release as a draft instead of publishing it without the declared assets. A skipped job still publishes, so repositories declaring no extra assets are unaffected.

  • sync-labels now exports to a scratch directory instead of the repository root, so it no longer leaves three untracked files behind. Both committed and downloaded extra-labels/ files are applied, a download shadowing a committed file of the same name.

  • The generated downstream release.yaml now carries the canonical deny-by-default permissions: {}, so a consumer job appended below the managed lanes no longer runs with the repository’s default token scopes.

  • The generated release.yaml keeps the extra needs: edges a consumer declares on its release lane, so a caller-side asset build can gate the engine. Edges naming a managed lane, a vanished job, or an upstream-only job are still dropped.

  • Fix init downgrading the upstream uses: pins of a repository that adopted a release still inside the minimum-release-age window. The cooldown now gates adoptions only, and a rollback to an older repomatic is honored.

  • init no longer closes with β€œcommit the generated files and push” on a run that produced nothing but ephemeral output.

  • Fix the broken-links and setup-guide jobs dying on a recurring issue that the autolock workflow had locked. A conversation lock blocking a close or reopen comment is now cleared and the write retried.

  • Fix repomatic run finding no binary on a Linux distribution extra-platforms cannot name, which broke every registry tool inside the AlmaLinux-based manylinux build container.

  • Fix a crash when pyproject.toml is removed while being read, which now falls back to an empty configuration as documented.

  • Re-lock uv.lock in the release freeze commit, so a release no longer ships with its version ahead of its own lock entry. The desync made the Windows binary builds fail.

7.5.0 (2026-08-07)ΒΆ

Note

7.5.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: bundled skills drop model and disable-model-invocation, so every skill is now model-invocable and runs on the session model. The recommended model moved to the spec’s compatibility field.

  • Breaking: workflows now run the CLI from uv.lock with uv run --frozen instead of uvx --from ., so installs are hash-verified. The release freeze still pins downstream to uvx 'repomatic==X.Y.Z'.

  • minimum-release-age now defaults to 1 week (was 8 days) and [tool.uv] exclude-newer tracks it, closing the band where uv.lock could pin a version CI then refused to install.

  • Reject a dependency floor naming a release still inside the cooldown window, which would ship a package that downstream repos and uvx users cannot resolve.

  • Fix the sync-* updaters adopting a release published on the cutoff day itself, which uv then refused to resolve because it applies the window to the hour rather than the day.

  • sync-workflow-pins now warns when a pin already in the tree sits inside the cooldown, instead of only judging the version it is about to write.

  • A lint-repo check that cannot read its GitHub API response now reports one β€œcould not query API” outcome instead of separate unreachable-API and unparsable-JSON messages.

  • Fix prepare-release and sync-github-releases reading ./changelog.md instead of the configured changelog.location.

  • Fix a PR body template’s footer: false being ignored, appending the attribution footer to a template that opted out of it.

  • Fix template and skill frontmatter truncating at a value that embeds ---, dropping every field below it.

  • Trim the hand-maintained example dumps from metadata’s module and nuitka_matrix docstrings, which had drifted from the values they claimed to show.

  • Fix docstrings where a brace placeholder against a closing backtick rendered as a spurious role, swallowing the prose after it.

  • Every workflow now gates package installs behind the minimum-release-age cooldown, so no uvx, uv pip install, npm install or npx resolves a release published inside the window.

  • A thin caller carrying extra downstream jobs now gets a top-level permissions: {}, and on its managed job the union of the scopes the reusable workflow’s jobs declare. Callers with no extra jobs are untouched.

  • astral-sh/setup-uv steps now pin the uv version, bumped by sync-workflow-pins once a release clears the cooldown, instead of installing the newest build satisfying required-version.

  • repomatic run mdformat provisions its own shfmt at the registry-pinned version, so formatting shell blocks in Markdown no longer needs a system shfmt.

  • New path_tools field on a tool spec, naming registry tools whose binary must be on PATH while it runs.

  • Fix repomatic run mdformat aborting on Windows ARM64, where shfmt publishes no binary: a companion missing for the platform is now skipped with a warning.

  • Fix the macOS binary builds, which crashed in code signing once skills joined the bundled data: an --include-data-dir source holding symlinks is now staged symlink-free. Reported upstream as Nuitka/Nuitka#3994.

  • The format-markdown job drops back to the lean ubuntu-slim runner, and its awesome-list fixup uses sed instead of gawk.

  • apt-get replaces apt in every workflow step, with --no-install-recommends throughout.

  • Add gh to the repomatic run registry. The release engine’s attestation check now uses it instead of adding GitHub’s RPM repository to the build container and installing an unpinned gh.

  • A tool’s strip_components accepts a per-platform mapping, like archive_format already did.

  • Add oxipng to the repomatic run registry, bumped to 10.1.1. format-images now uses the pinned, checksum-verified build instead of a hand-fetched .deb installed with dpkg.

  • Dependency-updater reports now close on the Held back by cooldown section, below Cooldown bypasses, so a PR opens on what the run changed instead of what it left alone.

  • sync-tool-versions leaves autofix.yaml for a new upstream-only self-maintenance.yaml, and polls daily instead of weekly. Downstream autofix.yaml loses the four steps it could never run.

  • sync-tool-versions now also bumps the packages pinned alongside a tool in its uvx environment, like mdformat’s plugin set, reporting them like every other row.

  • Fix get_source_url returning a bug-tracker or changelog sub-path instead of the repository root, and matching project_urls keys case-sensitively.

  • The bundled ruff config sets output-prefer-rule-codes, so diagnostics report ISC004 instead of implicit-string-concatenation-in-collection-literal. Requires ruff 0.16.1.

  • repomatic init holds the derived upstream workflow pin back to the newest release past the minimum-release-age cooldown; --no-cooldown pins the running version immediately.

  • Commands honoring --output now log their destination uniformly, always naming what is written instead of mixing Save updated results to and a subject-less Write to.

  • Align bundled skills with the Agent Skills specification: babysit-ci gains its required name field, and allowed-tools moves to the spec’s space-separated form.

  • Skills are now installed as whole folders, so one can ship the spec’s optional scripts/, references/ and assets/ directories alongside its SKILL.md.

  • Add [tool.repomatic.flavor] with agent and ci keys, declaring the ecosystems a repository targets. Values are extra-platforms trait IDs.

  • [tool.repomatic.labels.extra] entries now carry labelmaker’s full per-label specification, adding rename-from in-place renames, multi-color lists, and the create, update, enforce-case and on-rename-clash knobs. An unknown field now warns instead of being dropped silently.

  • New release-assets filename list in [tool.repomatic]: each named asset is built by a caller-side job, attested like the compiled binaries, and attached to the release draft before publication locks it.

  • The man-page tarball is now attested like the compiled binaries, with its sigstore bundle attached as a manpages.attestation.json release asset.

  • skills.location and agents.location now default to the layout of the configured flavor.agent, and still win when set explicitly.

  • repomatic run mdformat drops the mdformat-ruff plugin and its separate ruff pin, and the bundled ruff config drops extend-include: ruff formats fenced Python blocks in Markdown on its own.

  • Teach the repomatic-ship and babysit-ci skills to act on the first failing CI job instead of waiting out full matrices, pay down pre-existing and ⁉️-probe test debt before the first push, and hold prose-only pushes while binary matrices drain.

  • Chart the /repomatic-ship convergence loop (first-failing-job fixes, push timing, debt paydown) on the skills docs page.

  • Re-base the release PR onto the current main HEAD after every build by also running prepare-release on workflow_run, so a reconciliation commit that misses changelog.yaml’s paths: filter no longer leaves the PR stale.

  • /repomatic-topics pre-approves the Agent tool instead of the retired Task name.

  • Add a history documentation page retracing the project from its 2021 reusable-workflow origins through the gha-utils CLI to the repomatic rename.

  • Recenter the readme and the workflows page on the CLI-first design: workflows only trigger CLI commands, with local-run examples and links to the standalone binaries and history pages.

  • Document Agent Skills spec conformance, and argument-hint as the single accepted deviation, on the skills documentation page.

  • Correct the readme and benchmark page: both carried stale reusable-workflow counts, and listed jpegoptim among the tools repomatic run manages when it never was.

7.4.1 (2026-08-01)ΒΆ

Note

7.4.1 is available on 🐍 PyPI and πŸ™ GitHub.

  • Add two review links to the release PR’s How-to release checklist: the draft dev pre-release and the full changes against main.

  • Teach the repomatic-ship pre-push gate to read the latest conclusive ancestor CI run when HEAD’s own runs are still in-flight, catching a pre-existing platform-gated failure before the first push.

  • Lower the uv required-version floor from >=0.12 to >=0.11.15, the actual resolver minimum.

  • Extend the uvx script-equals-package guard to the pipx run <script> install check, so πŸ“¦ Package install no longer fails permanently for projects whose CLI script differs from their package name.

7.4.0 (2026-07-31)ΒΆ

Note

7.4.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: Rename update-deps-graph to update-dep-graph across the CLI command, autofix job, PR branch, and body template, aligning with the dependency-graph config key. Close any open update-deps-graph pull request; the next run reopens it on the new branch.

  • Breaking: repomatic init component selectors are now case-sensitive, validated by the same code path as the exclude and include configuration entries.

  • Lower the compiled-binary OS floors: Linux glibc 2.28, built and self-tested in manylinux_2_28 containers (RHEL 8, Debian 10, Ubuntu 20.04 and later), and macOS 11.0 (Apple silicon) / 10.15 (Intel) via uv’s embedded python-build-standalone interpreter.

  • Enforce each binary’s OS floor at build time: verify-binary parses ELF, Mach-O and PE headers natively and no longer needs exiftool.

  • Keep tkinter and its Tcl/Tk stack out of compiled binaries via the new [tool.repomatic] nuitka.nofollow-imports setting (default ["tkinter"], set to [] to bundle it).

  • Emit man pages for repomatic’s own CLI on docs builds and attach a repomatic-manpages.tar.gz asset to each release.

  • Add update-docs --check to report out-of-date self-updating content and exit non-zero without writing, for CI drift detection. The docs update script must accept its own --check flag to participate.

  • Add a check_sha_pinning_required lint check and setup-guide step for GitHub’s sha_pinning_required Actions setting, the platform-enforced backstop for action SHA pinning.

  • Unify the lint-repo checks on one tri-state result protocol: skipped checks now print β„Ή instead of a misleading βœ“.

  • Key the CI tool-binary caches on tool_registry.py instead of the whole runner module, so engine-only changes stop invalidating cached tools.

  • Report sync-deps and update-checksums progress as a βœ“/✘ trail with a running tally and a timed summary.

  • Warn about unknown [tool.repomatic] keys once per project and process, instead of on every configuration re-load.

  • Loosen the uv required-version pin to a lower bound (>=0.12), dropping the per-minor upper cap so uv can update across minors without a manual bump.

  • Move the docs link checker from ubuntu-slim to ubuntu-24.04-arm: the crawl outgrew the slim runner’s 15-minute job cap.

  • Extend the bundled lychee configuration with generic excludes: GitHub issue-comment fragments, release binary downloads, and DOI-to-Zenodo redirects.

  • Declare least-privilege permissions on the canonical release.yaml, clearing the workflow check_workflow_permissions lint.

  • Extend the check_workflow_permissions lint to flag a reusable-workflow call inheriting an empty top-level permissions: {} without its own grants: the misconfiguration that aborts a run at startup.

  • Block install-time scripts and apply the minimum-release-age cooldown on every npm install of awesome-lint, hardening both the runtime and CI-provisioning paths against supply-chain attacks.

  • Surface uv audit’s stderr when it exits without emitting JSON, replacing the bare produced no output error.

  • Keep metadata from crashing when git refuses the repository (dubious ownership, unresolvable range): it now logs git’s stderr and continues.

  • Accept sur (macOS Big Sur, Homebrew’s big_sur bottle tag) as a valid word in the bundled typos configuration, so fix-typos stops correcting it to sure.

  • Document the minimum OS requirement of each binary target, and the distributions it opens execution to, in a new Minimum OS requirements section that downstream binaries pages link to.

  • Document how to verify a downloaded binary’s build-provenance attestation with gh attestation verify on the installation page.

  • Order the installation docs’ Python-compatibility table newest-first, so the latest release and Python version read from the upper-left.

  • Rename the binaries page chart markers to binaries-chart/binaries-chart-end, aligning on click-extra’s <!-- name --> / <!-- name-end --> marker grammar; pages carrying older markers are migrated on their next refresh.

  • Fix the click-extra {matrix} directive link on the installation page, and realign page octicons with the sphinx-docs agent’s extended icon registry.

  • Emit an absolute og:image URL for social previews: ogp_site_url now backs ogp_image in the docs configuration.

  • Pin the install guide’s versioned CLI examples (pkg@X.Y.Z, pkg==X.Y.Z) to the release in the prepare-release freeze step.

  • Direct the babysit-ci skill to announce its early exit and name the still-unverified release.yaml binary run, instead of stopping on a silent idle.

  • Harden the repomatic-ship skill: forbid detached Monitor polling, read the whole unreleased changelog section at invocation, and align every convention description its docs pass corrects.

  • Extend the sphinx-docs agent and sphinx-docs-sync skill: the {click:run} --version trap, thin-schema combined CLI page, Cloudflare-blocked intersphinx probes, mdformat seed-block collapse, plus release-asset, self-healing-marker, and linkcheck audit guards.

  • Note in the repomatic-ship skill that changelog released sections are immutable, and that a workflow cache-key line-length fix cannot lift hashFiles() into a workflow-level env:.

7.3.1 (2026-07-28)ΒΆ

Note

7.3.1 is available on 🐍 PyPI and πŸ™ GitHub.

  • Refresh the bundled pytest defaults to the canonical configuration: importlib import mode, tests/-restricted collection, the once marker, parallel runs via pytest-xdist, and --cov-report=xml left to the test workflow’s command line.

  • Mark the validate-arch job of tests.yaml as canonical-repository-only: downstream repos drop the job and its build_targets metadata field when adapting the workflow.

  • Point the lint-changelog not found on PyPI warning at its remedy: list intentionally-unpublished releases under [tool.repomatic] abandoned-versions.

  • Fix the post-release re-trigger of changelog.yaml: its workflow_run filter still watched the pre-emoji Build & release workflow name and never fired.

  • Fix lint-changelog --fix treating a published pre-release (X.Y.Z.dev0, rc, alpha, beta) as a missing changelog entry, which inserted a spurious section and rewrote the adjacent release’s comparison URL.

  • Fix the update-docs autofix job opening a duplicate of the format-pyproject pull request: it now reformats pyproject.toml only when update-docs changed it.

  • Skip the bare uvx <script> invocation of the package-install smoke job when the CLI script is not named after its package.

  • Restructure the repomatic-ship skill: rules shared by every spawned agent move to a single section, and accumulated incident notes compress into their operative rules.

  • Harden the repomatic-ship release checks: dispatch release.yaml past a content-skipped binary matrix, revert formatter moves whole, read the freeze scope from the regenerated release PR, and verify {click:run} blocks against the live CLI.

  • Direct the repomatic-ship docs pass to advance version samples lagging the released tag up to it.

  • Note in the repomatic-ship and babysit-ci skills that CI log fetches write under ~/.cache/gh and need the sandbox off.

7.3.0 (2026-07-23)ΒΆ

Note

7.3.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: Move the MyST docstring toolchain upstream to click-extra, now floored at 8.5: the repomatic.myst_docstrings Sphinx extension becomes click_extra.sphinx.myst_docstrings (point conf.py at the new module path), and the convert-to-myst command becomes click-extra convert-to-myst.

  • Warn on unknown [tool.repomatic] keys through click-extra’s schema layer, covering nested tables too; the warning now names keys in snake_case.

  • Upload each release binary under a versionless alias, so the stable releases/latest/download URLs keep resolving across releases.

  • Mark the upstream toolkit’s lockstep-aligned pin with a ⛓️ lockstep docs link in the sync-workflow-pins PR table, instead of an empty Released cell.

  • Add a βš™οΈ emoji to the Configuration section heading of PR bodies, and swap the Held back by cooldown section’s πŸ”œ emoji for ⏸️.

  • Disable ruff’s unsafe-fixes in the bundled defaults, so --fix and the autofix workflow only apply semantics-preserving fixes.

  • Expose GITHUB_TOKEN to the Sphinx linkcheck step of the docs workflow, so a repo’s conf.py can authenticate its github.com checks via linkcheck_request_headers.

  • Space out the Windows exiftool install with step-level retries, absorbing Chocolatey community-feed outages that punch through choco’s own --retry-count.

  • Fix the exclude and include configuration reference to list agents among the default-excluded components.

  • Exclude once-marked tests from every test-matrix cell and run them in a dedicated single-runner once-tests job with its own coverage upload.

  • Teach the repomatic-ship and babysit-ci skills that the Nuitka binary matrix only exists on projects enabling [tool.repomatic] nuitka.enabled, and how to verify binary-less releases.

  • Fix the repomatic-ship local-gate tool recipes: pass biome and shfmt their args forms, and smoke checksum-pinned tools with no matching files via --version only.

  • Broaden the repomatic-ship review scopes: version samples are audited against the last freeze commit’s file list, and platform-gated tests are reviewed with the inputs they consume.

  • Require the repomatic-ship sweep agents to message their final reports to the orchestrator, with one chase on a silent idle.

  • Point the changelog over-length warning and the repomatic-changelog skill at the canonical entry-length guideline URL, which downstream CLAUDE.md copies lack.

7.2.0 (2026-07-16)ΒΆ

Note

7.2.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: the release-prep command is renamed prepare-release, matching the job, template, and PR branch it drives.

  • Breaking: the version-check command is renamed check-version.

  • Add cancel-runs: cancels a branch’s in-progress and queued workflow runs, replacing the bash block in cancel-runs.yaml; run listings now paginate past the first page.

  • Add [tool.repomatic] binaries.sync: set to false to stop the release pipeline from committing the binaries catalog and scan records to the default branch.

  • Add sync-dep-sources, a fifth sync-deps updater: once the release named by a git-tracked dependency’s .dev floor ships on PyPI, it drops the [tool.uv.sources] override, tightens the floor, and freezes the adopted release through the cooldown. Disable with [tool.repomatic] dep-sources.sync.

  • Dialect, ArchiveFormat, and WorkflowFormat now carry their dispatch as enum methods (serialize, extract, write_workflow).

  • Rename cross-module internals to public names: COMPONENTS_BY_NAME, is_source_repo, format_released, format_upload_date, date_to_utc_cutoff.

  • The sponsor-labeller job in labels.yaml is renamed sponsor-label, matching the CLI command it runs.

  • Remove the dead get_default_repo and list_open_issues helpers and the unused REQUIRED_PAT_PERMISSIONS constant.

  • update-deps-graph now keeps only directly-declared dependencies inside the --group and --extra boxes, renders transitive dependencies as plain ovals, and counts an extra’s transitives as depth 2 under --level.

  • The unsubscribe workflow’s GraphQL phase now re-validates each item’s staleness client-side and reports the items it holds back.

  • The unsubscribe.yaml workflow now streams per-thread progress to the job log.

  • Generated PR and issue bodies now use ## section headings, with Release notes nested as a ### subsection; release bodies embedded in dropdowns get their headings demoted below the per-version heading.

  • Generated PR bodies drop the boilerplate Description section, and the Workflow metadata block becomes a compact list led by a Documentation link to the job’s section of the workflows reference.

  • The Cooldown bypasses PR section is now a single table: 🧹 cleared:, πŸ“Œ frozen:, and 🚧 unreleased: rows with a Held until expiry column.

  • Diff tables label added and removed packages with πŸ†• new: and πŸ—‘οΈ removed: prefixes ahead of the version.

  • sync-action-pins and sync-workflow-pins PR bodies now report an action or package pinned at several versions as a single row spanning from the oldest pin.

  • The update-docs job now re-formats pyproject.toml files with pyproject-fmt after running the project’s update script.

  • GitHub Releases API reads now resolve their token like every other GitHub access (REPOMATIC_PAT first), instead of hitting the anonymous rate limit.

  • PyPI, npm, and GitHub API lookups now retry once on a truncated response instead of crashing with IncompleteRead.

  • The release freeze and unfreeze steps now cover .yml workflow files alongside .yaml.

  • The gitignore.io template download now times out after 10 seconds instead of hanging on a stalled connection.

  • Version bumps no longer overwrite the cff-version: schema field in citation.cff when it coincides with the package version.

  • sync-action-pins no longer rewrites uses: pins inside files repomatic init deploys verbatim, like the publish-pypi composite action.

  • The run typos guidance now recommends extend-ignore-re guards for encoded hashes and intentional-typo examples.

  • Document the scan job contract and the release-lane direct-commit exception.

7.1.0 (2026-07-08)ΒΆ

Note

7.1.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: scan-virustotal no longer writes scan tables into GitHub release notes; the --update-release and --repo options are removed, and --binaries-dir is now required.

  • Add sync-binaries: regenerates docs/assets/binaries.csv and its docs/binaries.md page, a catalog of every released binary with download links, VirusTotal analyses, and a detection trend chart.

  • sync-binaries --backfill-records recovers detection snapshots from the VirusTotal tables of legacy release notes into the scan history file.

  • The release pipeline now records each binary’s flagged / total snapshot in docs/assets/virustotal-scans.json and refreshes the binaries page instead of editing release notes.

  • The documentation build gains sphinx-datatables, rendering the binaries catalog as a searchable, sortable table; downstream repos can opt in with the same extension.

  • Add git-commit-push: commits files and pushes them, rebasing and retrying on rejection, for release jobs publishing generated files to the default branch.

  • Add a global --jobs option controlling how many parallel workers commands may use, defaulting to one fewer than the host’s logical CPUs.

  • update-checksums, sync-tool-versions, and sync-deps now download artifacts and resolve updates concurrently, sized by --jobs; Ctrl+C aborts the fan-out promptly and --verbosity DEBUG collapses it to sequential.

  • sync-uv-lock PR bodies gain a Cooldown bypasses section: each active exclude-newer-package freeze with the date it expires and is cleared from pyproject.toml, plus the entries the run froze or pruned.

  • The Held back by cooldown table now also lists releases blocked by an exclude-newer-package freeze, not only those inside the global exclude-newer window.

  • update-docs gains a fourth phase refreshing self-updating {matrix} directive blocks in docs/ and readme.md; the Python compatibility matrix in the installation docs now renders from those markers instead of an in-repo generator.

  • The CLI, configuration, and tool-runner references in the docs render live through the click:tree, click:config, and {python:render} directives; the checked-in generated tables and docs/docs_update.py are removed.

  • Each tool section in the tool-runner reference shows Stars and Last release badges; the separate Comparison table is removed.

  • Require click-extra >= 8.3, adding the --export-config option, --theme auto terminal-background detection, and the click:config Sphinx directive.

  • Label added and removed packages in dependency report tables consistently after the version, with πŸ†• and πŸ—‘οΈ status emoji.

  • sync-workflow-pins now aligns the inline repomatic pin to the newest uses: ref version, bypassing the release-age cooldown.

  • sync-action-pins now converges actions pinned at several versions onto the highest pin, even when no newer release clears the cooldown.

  • Trim oversized PR and issue bodies to GitHub’s 65536-character limit, preserving the refresh tip, metadata block, and attribution footer.

  • Add the humanized age next to Released dates in fix-vulnerable-deps reports, matching the other dependency updaters.

  • update-deps-graph now places a package declared by several groups or extras in the box where most of its dependents live, drawing the duplicates with a dashed border and a dotted identity link to the real node.

  • The setup guide and lint-repo now flag a missing REPOMATIC_NOTIFICATIONS_PAT secret when notification.unsubscribe is enabled.

  • Exclude VirusTotal analysis links from lychee broken-link checks.

  • Update the av-false-positive skill to start from the scan history file and to record post-submission re-scans into it.

  • The babysit-ci and repomatic-ship skills now mandate sleeps between CI polls and document GitHub API rate-limit exhaustion, whose symptoms masquerade as PAT permission errors.

  • Fix sync-uv-lock reporting No dependency changes and writing no PR body when a run only prunes or freezes cooldown bypasses in pyproject.toml.

  • Fix downstream manual dispatches of the unsubscribe workflow ignoring their inputs and always running live: generated thin callers now forward workflow_dispatch inputs to the reusable workflow.

  • The publish-pypi composite action and the unsubscribe workflow no longer trigger setup-uv’s cache-invalidation and Empty workdir detected warnings on downstream runs, which execute without a checkout.

  • The PR-creation steps of the changelog workflow now time out after 10 minutes instead of hanging when the GitHub API is rate-limit starved.

  • Fix the binary cache purging fresh entries whose release archive carries an old build date: cached binaries are now aged by their store time, not the archive’s mtime.

  • repomatic run now reports a truncated tool download as got X of Y bytes instead of a SHA-256 mismatch, which read as a stale checksum or a tampered artifact.

  • Rebuild binaries on pushes that only touch .github/workflows/_release-engine.yaml: the release workflow split left the engine lane outside the binary-affecting paths.

  • Disable mouse zoom on the class inheritance diagrams of the documentation’s API sections, so they no longer hijack page scrolling; the fullscreen viewer keeps zoom.

7.0.0 (2026-07-02)ΒΆ

Note

7.0.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: Remove the Renovate integration: the renovate.yaml workflow, the bundled renovate.json5, the check-renovate command, and the Dependabot-to-Renovate migration are gone, replaced by self-hosted dependency updates (below). Downstream repos prune the orphaned files on their next repomatic init.

  • Breaking: repomatic update-checksums is now registry-only: the workflow-file argument and the --registry flag are removed, so it only refreshes the binary tool checksums.

  • Add sync-deps, the single entry point for dependency updates: runs every enabled updater or a named subset in parallel and applies them in order, with a --dry-run preview.

  • Add sync-tool-versions: bumps each repomatic run tool to its latest release past the cooldown and refreshes the binary tool checksums in the same pass.

  • Add sync-action-pins: bumps SHA-pinned GitHub Actions to their latest release past the cooldown, resolving each release tag to its commit SHA.

  • Add sync-workflow-pins: bumps the npm and PyPI version literals embedded in workflow YAML past the cooldown.

  • Add [tool.repomatic] minimum-release-age (default 8 days), the shared stabilization cooldown for the sync updaters, plus per-updater tool-versions.sync, action-pins.sync, and workflow-pins.sync toggles.

  • repomatic run now runs npm-backed tools, starting with awesome-lint, installed from the npm registry with per-tarball integrity and the minimum-release-age cooldown; the lint-awesome job now calls repomatic run awesome-lint.

  • Add a [tool.repomatic] changelog.archive-location option pointing at an archive file for older release sections, so lint-changelog treats archived versions as documented instead of flagging them as orphans.

  • Dependency-updater PR bodies now share sync-uv-lock’s format: a cooldown cutoff date, a Held back by cooldown section, and a Release notes dropdown between them.

  • repomatic run now applies the minimum-release-age cooldown to the transitive dependencies of its uvx-installed tools; binary and uv run tools stay pinned as before.

  • The autofix workflow now runs the dependency updaters weekly on a schedule, so quiet repositories still pick up dependency, tool, and action-pin updates.

  • REPOMATIC_PAT no longer requires the Commit statuses permission; lint-repo now warns when a token still grants it so it can be tightened.

  • Drop the pydriller dependency: Git history operations now invoke the git CLI directly, shrinking the install and compiled-binary footprint.

  • repomatic run now animates a spinner while downloading a tool whose server omits a Content-Length, where it previously showed nothing.

  • The generated Python compatibility matrix in install.md now covers pre-classifier releases, falling back to requires-python, Poetry, or setup.py metadata to infer supported versions.

  • Fix update-deps-graph rendering only one of several extras or dependency groups that share a directly-declared dependency; each now gets its own subgraph.

  • Fix broken documentation links: the standalone-binary downloads (versionless 404s), the pipx installation guide, and the GitHub matrix-strategy reference.

6.31.0 (2026-06-27)ΒΆ

Note

6.31.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • sync-uv-lock PRs now list newer releases held back by the exclude-newer cooldown, with the date each ages out of the window.

  • sync-uv-lock package tables now annotate each release date with a relative hint (2 days ago, in 3 days).

  • Autofix PR bodies now document every relevant [tool.repomatic] option in their Configuration section.

  • The test workflow uploads coverage to Codecov from one runner per OS, not from every matrix cell.

  • Drop the Codecov Test Analytics (test results) upload and the junit.xml file it generated.

  • update-checksums --registry now maintains binary tool checksums in a dedicated repomatic/tool_checksums.py module.

  • Update pyproject-fmt to 2.25.1, which keeps comments inside inline tables when format-pyproject reorders their keys.

  • Fix the PyPI availability admonition missing from GitHub release notes.

  • Fix repomatic run biome failing with a SHA-256 mismatch: Biome 2.5.0’s binary checksums were stale, breaking JSON, JavaScript, and TypeScript format jobs.

  • Fix [tool.repomatic] workflow.sync = false being ignored: it now skips workflow sync like the other *.sync toggles.

6.30.0 (2026-06-24)ΒΆ

Note

6.30.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: The test and release workflows now run click-extra test-suite (the test-plan engine renamed in click-extra 8.1), reading the suite from ./tests/cli-test-suite.toml. Requires click-extra >= 8.1.

  • repomatic lint-repo now fails when a workflow’s inline repomatic==X.Y.Z pin lags the version of its uses: ref.

  • The test workflow skips the Codecov upload on free-threaded Python (3.14t), where codecov-cli cannot build its test-results-parser extension.

  • In generated dependency graphs, thick arrows now mark only the root package’s direct dependencies; a transitive edge that points at a primary dependency stays thin, so optional extras no longer read as a primary dependency chain.

  • The release workflow now cancels superseded runs on rapid non-release pushes to main, so intermediate commits no longer pile up redundant binary builds; release commits still run to completion.

6.29.0 (2026-06-22)ΒΆ

Note

6.29.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: Remove the repomatic test-plan command and [tool.repomatic] test-plan config. The declarative test-plan engine moved upstream to click-extra; run click-extra test-plan instead, configured via [tool.click-extra.test-plan].

  • Add repomatic show-test-matrix to render the CI test matrix as a Python-version by OS grid in any --table-format.

  • Add repomatic init uv to sync the canonical [tool.uv] pins (required-version, exclude-newer) into pyproject.toml; sync-uv-lock applies the same sync, so every machine resolves uv.lock with the same uv.

  • Require click-extra >= 8; the manpages release job now uses click-extra wrap --man to generate man pages.

  • The binary download progress bar now respects --no-progress and --accessible, hiding it when progress output is turned off.

  • Move the Sphinx linkcheck output to docs/_linkcheck/ (mirroring docs/_build/); broken-links --output-json now defaults there and the generated .gitignore excludes it.

  • repomatic run now warns when --check targets a post-processed formatter (currently mdformat): check mode bypasses the fixup, so its exit status can mislead.

  • sync-uv-lock now reverts a re-lock that changed no package versions, so uv’s machine-dependent re-spelling of equivalent uv.lock environment markers no longer opens empty sync PRs that ping-pong between contributors and CI.

  • Documentation pages that cover a Python module now end with that module’s API reference.

  • Test the free-threaded 3.14t build as a stable single-runner smoke test instead of across the full cross-platform matrix; 3.15 stays continue-on-error.

6.28.1 (2026-06-19)ΒΆ

Note

6.28.1 is available on 🐍 PyPI and πŸ™ GitHub.

  • Fix test-matrix.full-include matrices emitting combinations that exclude should have removed; they now follow GitHub’s documented include/exclude algorithm.

6.28.0 (2026-06-19)ΒΆ

Note

6.28.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • repomatic test-plan runs its cases in parallel by default (one fewer than the CPU count); pass --jobs 1 for sequential execution.

  • Add [tool.repomatic] test-matrix.full-include config: declare full-matrix-only job rows as explicit combinations (each merged onto the shipped-config defaults), a readable alternative to a long test-matrix.exclude list.

  • Run the pull-request test matrix on ubuntu-24.04-arm for faster Linux CI; the full test matrix still covers x86 Linux.

  • repomatic metadata no longer prints spurious --overwrite or $GITHUB_OUTPUT warnings when writing to stdout.

  • Add a test-matrix guide to the docs: choosing matrix targets, a GitHub-runner speed inventory, and a worked example.

6.27.0 (2026-06-18)ΒΆ

Note

6.27.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: Replace fix-vulnerable-deps with audit. repomatic audit reports vulnerable dependencies read-only; repomatic audit --fix performs the previous upgrade behavior.

  • Stop forcing pyproject-fmt table expansion: project.urls, project.scripts, and similar sections now use its default compact (dotted-key) form.

  • Recognize each bundled tool’s native config files more accurately (biome, gitleaks, ruff, typos, zizmor, and others) and their config-file CLI flags.

  • Preserve comments when materializing a [tool.X] section from pyproject.toml to a tool’s native TOML config file (like .gitleaks.toml), instead of dropping them.

  • Update pyproject-fmt to 2.25.0, fixing the format-pyproject job writing invalid TOML when it reformats [tool.repomatic.labels] rule tables.

  • Align the bundled [tool.bumpversion] and [tool.lychee] templates with pyproject-fmt’s canonical output, ending the reformatting pull-request loops they triggered.

  • Fix cooldown bypasses ([tool.uv] exclude-newer-package) never expiring: sync-uv-lock now freezes each one at its locked version instead of a latest-tracking "0 day" span, and prunes it once that version ages past exclude-newer.

  • Fix uv.lock ping-ponging on every sync-uv-lock run: exclude-newer-package freezes are now explicit UTC timestamps, not bare dates that uv re-expands in the locking machine’s timezone.

  • Fix the repomatic.myst_docstrings Sphinx extension corrupting two adjacent inline-code spans in a docstring when the second span starts with an underscore.

  • Fix the manpages release job: attach the man-page tarball to the release draft before publishing, so it no longer fails under GitHub immutable releases.

6.26.0 (2026-06-17)ΒΆ

Note

6.26.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Add [tool.repomatic] nuitka.extras config to sync listed [project.optional-dependencies] extras into the venv before the Nuitka build, so optional features land in the binary.

  • Add [tool.repomatic.labels] extra, file-rules, and content-rules config for inline label definitions and labeller rules, replacing the silently-ignored extra-file-rules and extra-content-rules fields.

  • Stop version-bump PRs from upgrading dependencies: the bump and release jobs now run plain uv lock, leaving dependency refreshes to the sync-uv-lock job.

  • Add a [tool.repomatic] changelog.bullet-word-threshold config: lint-changelog warns (non-fatally) about unreleased changelog bullets longer than the threshold (40 words by default).

6.25.1 (2026-06-13)ΒΆ

Note

6.25.1 is available on 🐍 PyPI and πŸ™ GitHub.

  • Fix uvx repomatic@X.Y.Z failing for end users with No solution found by dropping the bump-my-version dependency and reading the current version natively from .bumpversion.toml or [tool.bumpversion].

  • Remove the uv-overrides.txt file and all UV_OVERRIDE workflow env blocks.

  • Render the Mermaid dependency graph in docs/install.md under a new Default dependencies section.

6.25.0 (2026-06-13)ΒΆ

Note

6.25.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Add man page generation to the release and docs pipelines via a manpages job, activated by [tool.repomatic.manpages] config keys (script, asset-name); requires click-extra>=7.19.

  • Validate [project.scripts] entries when building the Nuitka matrix, rejecting path-shaped, empty, or malformed script names up front with a clear error.

  • Replace the tomlkit and tomli dependencies with tomlrt for all TOML reads and comment-preserving writes.

  • Annotate gh and PAT permission check failures with the current githubstatus.com summary, and surface raw stderr on non-403 failures instead of misreporting missing scopes.

  • Recognize friendly durations (24 hours, 30 minutes) and ISO 8601 durations (PT24H, P7D) in [tool.uv].exclude-newer when computing the repomatic sync-uv-lock cooldown.

  • Fix UV_OVERRIDE not reaching Renovate’s child processes during update-checksums.

  • Add [tool.repomatic] abandoned-versions to lint-changelog, reporting listed versions as skipped instead of warning that they are missing from PyPI.

  • Tighten /repomatic-ship’s pre-push gate with ruff format --check and a repomatic --version dependency-resolution smoke run.

6.24.0 (2026-05-28)ΒΆ

Note

6.24.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Publish to PyPI right after the wheel builds instead of waiting for the full release engine, by splitting the build into a _release-build.yaml lane that release.yaml’s publish-pypi job depends on.

6.23.0 (2026-05-28)ΒΆ

Note

6.23.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Split release.yaml into a thin entry workflow and a new reusable _release-engine.yaml engine; the entry keeps publish-pypi so PyPI Trusted Publisher OIDC resolves to each repo’s own release.yaml.

  • Remove the release-publish-pypi-job.yaml data fragment; release.yaml is now the single source for the publish-pypi job.

  • Require uv >= 0.11.15 for the vulnerability scan and parse uv audit --output-format json directly, raising a clear error on unsupported uv versions and deduplicating advisories across sources by alias.

  • Refine /repomatic-ship to re-consolidate the changelog after the babysit phase and re-dispatch changelog.yaml after a code-only fix push so the release PR stays current.

  • Extend /babysit-ci to also monitor autofix.yaml, diagnosing and fixing crashed mechanical-fix jobs instead of leaving them red on main.

  • Fix release.yaml’s compile-binaries and test-binaries jobs aborting every non-release run with Unexpected value '' on projects with nuitka.enabled = false.

6.22.0 (2026-05-25)ΒΆ

Note

6.22.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • repomatic init now prunes downstream orphans of renamed or removed skills, agents, and workflows; locally modified copies are reported for manual review, never deleted. Pass --keep-removed to report without deleting, or --delete-removed-modified to also delete modified ones.

  • /repomatic-ship now closes with a reflect step that reviews the session for friction and proposes fixes to the upstream repomatic source.

  • Fix the downstream caller’s publish-pypi job aborting every non-release release.yaml run with Unexpected value '' when its strategy.matrix is empty.

  • Fix /repomatic-ship and /babysit-ci dropping the Co-Authored-By: Claude trailer on their autonomous commits; both skills now require it self-containedly.

  • /babysit-ci now treats a workflow run that fails with no individual job failure as a real workflow-level error to investigate.

  • Fix the documentation site’s live CLI-help and example blocks rendering empty since click-extra 7.15.0 made execution directives opt-in.

  • Seed each tool section in the tool-runner docs with a runnable repomatic run example and a minimal [tool.X] snippet.

6.21.0 (2026-05-25)ΒΆ

Note

6.21.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Replace the repomatic-release skill with repomatic-ship, a release orchestrator that reconciles changelog, code, and docs, then commits, pushes, and babysits CI until the release PR is ready. Review-gated by default, fully autonomous under --dangerously-skip-permissions.

  • Add a modernize mode to the repomatic-deps skill that reads upgraded dependencies’ changelogs and refactors code to adopt their new features, gating each change on the test suite.

  • Extend the babysit-ci skill to also monitor and triage the Nuitka compile-binaries job in release.yaml.

  • Decouple the downstream caller’s publish-pypi job from the run’s overall result: it now runs under always() and gates on a new package_built output, so a cleanly built wheel publishes even when an unrelated job fails.

  • Remove the repomatic-sync, repomatic-lint, and repomatic-test skills, which only wrapped CLI commands CI already runs on every push.

  • Fix the bump-version job in changelog.yaml leaving an orphan version-bump PR open after a competing bump merged into main.

  • Enable myst-parser’s alert extension so GitHub-style alerts (> [!NOTE], > [!IMPORTANT]) render as admonitions on the documentation site.

  • Give each tool section in the tool-runner docs a hand-maintained extra-docs region preserved across regenerations, seeded for Nuitka, and add Nuitka to the page’s [tool.X]-support table.

6.20.0 (2026-05-24)ΒΆ

Note

6.20.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: remove [tool.repomatic] nuitka.extra-args. Configure Nuitka flags through [tool.nuitka] in pyproject.toml instead (--include-data-files=SRC=DEST becomes include-data-files = ["SRC=DEST"]).

  • repomatic run nuitka now installs the pinned Nuitka, reads [tool.nuitka] from pyproject.toml, and passes the section as CLI flags; Nuitka appears in repomatic run --list.

  • Build Nuitka binaries on Python 3.14.

  • Switch [tool.typos] sync to ONGOING: canonical proper-noun identifiers merge into a pre-existing [tool.typos] section instead of skipping it, preserving local keys and entries.

  • Add [[tool.bumpversion.files]] rules to the bundled template so downstream Python repos sync [tool.nuitka]’s numeric version keys without rewriting them on [project] bumps.

  • Add test-matrix.unstable config: matrix-key dicts (like {click-version = "main"}) that mark matching full-matrix combinations continue-on-error in CI.

  • Add a lint-repo check warning when a [tool.repomatic.test-matrix] exclude entry references a runner or Python version absent from the live matrix axes.

  • Add workflow_dispatch triggers to release.yaml and update-checksums.yaml for manual re-runs.

6.19.0 (2026-05-21)ΒΆ

Note

6.19.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Add repomatic close-stale-bump-pr --part minor|major to close orphan version-bump PRs left by races between the changelog.yaml schedule and a competing push.

  • Expand sponsor benefits in the awesome template’s contributing.md: sponsors get a dedicated entry in the matching section and a waiver on the licensing-marker requirement.

  • Switch the Sync uv.lock steps in changelog.yaml from uv sync to uv lock --upgrade, folding pending transitive refreshes into the bump commit.

  • Make lint-changelog --fix refuse to rewrite admonitions when an upstream GitHub or PyPI lookup looks unhealthy, instead of applying a corrupted view.

  • Skip CI for automated version-bump operations across tests.yaml, lint.yaml, labels.yaml, and release.yaml via a unified metadata gate.

  • Reduce CI scheduling with paths-ignore/paths: filters and per-job gates that skip lint jobs when no relevant files changed.

  • Bump Biome from 2.4.14 to 2.4.15.

6.18.4 (2026-05-14)ΒΆ

Note

6.18.4 is available on 🐍 PyPI and πŸ™ GitHub.

  • Replace RepoScope.NON_AWESOME with PYTHON_ONLY, gating Python-flavored components on a PEP 621 [project].name so dotfiles repos carrying pyproject.toml only for [tool.*] config skip them by default.

  • The bundled release-publish-pypi-job.yaml fragment now participates in the @main to @vX.Y.Z rewrite, so wheels built from a freeze commit ship with the pinned action ref.

  • Bump Biome from 2.4.13 to 2.4.14 and Lychee from 0.24.1 to 0.24.2.

  • Fix fix-vulnerable-deps placing exclude-newer-package at the end of [tool.uv], which triggered a spurious format-pyproject PR on the next run.

6.18.3 (2026-05-11)ΒΆ

Note

6.18.3 is available on 🐍 PyPI and πŸ™ GitHub.

  • Fix autofix.yaml’s setup-guide job being skipped on workflow_dispatch re-runs.

  • Fix release.yaml’s publish-pypi job running against downstream callers and failing PyPI trusted publishing with a job_workflow_ref mismatch.

  • Switch the compile-binaries job from --onefile to --mode=onefile, the documented spelling since Nuitka 4.0.

6.18.2 (2026-05-08)ΒΆ

Note

6.18.2 is available on 🐍 PyPI and πŸ™ GitHub.

  • Fix release.yaml uploading distributions to PyPI without PEP 740 attestations; the build job now signs each dist file and ships the .publish.attestation sidecars alongside it.

6.18.1 (2026-05-08)ΒΆ

Note

6.18.1 is available on 🐍 PyPI and πŸ™ GitHub.

  • Fix the publish-pypi composite action verifying build attestations on every workspace file instead of just the downloaded distribution artifacts.

6.18.0 (2026-05-07)ΒΆ

Note

6.18.0 is available on πŸ™ GitHub.

Warning

6.18.0 is not available on 🐍 PyPI.

  • Breaking: drop PYPI_TOKEN from the release.yaml workflow_call.secrets: interface. Regenerate the thin-caller workflow with repomatic init workflows and register a PyPI Trusted Publisher for your own release.yaml.

  • Add the publish-pypi composite action that publishes via OIDC Trusted Publishing with build-attestation verification; each downstream thin-caller now runs a generated publish-pypi job.

  • Add a check_pypi_trusted_publisher probe to lint-repo and a setup-guide-pypi-trusted-publisher step that points to a pre-filled PyPI publisher settings URL and stays open until the first OIDC-attested upload.

  • Add release_commits_matrix and package_name outputs to the reusable release.yaml so callers can drive their own matrix and gate jobs on a release commit.

  • New composite actions under .github/actions/ now participate in @main ↔ @vX.Y.Z ref freeze/unfreeze without code changes.

  • Fix sync-repomatic proposing to delete .github/actions/publish-pypi/action.yaml when it matched the bundled default; the file must stay on disk for GitHub Actions to resolve the uses: path.

6.17.0 (2026-05-04)ΒΆ

Note

6.17.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Add --template-file <path> and --template-arg KEY=VALUE flags to repomatic pr-body so downstream repos can render project-specific PR templates without forking. --template and --template-file are mutually exclusive.

  • Fix backslash-escaped brackets rendering literally in docs/configuration.md **Type:** lines (like list\[dict[str, str]\]).

  • Fix doubled heading anchors on docs/configuration.html and docs/workflows.html (like #dev-release-sync-dev-release-sync).

  • Collapse the most recent Python compatibility matrix row in docs/install.md to a major-version wildcard (like 6.x) so the table stays stable across minor releases.

6.16.0 (2026-04-29)ΒΆ

Note

6.16.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Add the sphinx-docs agent to the agents component, deployed by repomatic init agents or via [tool.repomatic] include = ["agents"].

  • Add three [tool.repomatic.workflow] knobs for customizing paths: filters in generated thin callers: extra-paths appends repo-specific entries, ignore-paths strips canonical entries absent downstream, and paths replaces a filter wholesale per workflow.

  • Add a Python compatibility matrix to docs/install.md, auto-generated from the Programming Language :: Python classifiers declared at every release tag.

  • Render each command’s --help live in docs/cli.md via {click:run} directives instead of captured plain-text help blocks.

  • Replace the Type column in the docs/configuration.md summary table with a one-line description derived from each option’s docstring, and lead each per-option section with that one-liner.

  • Detect vulnerable dependencies from the GitHub Advisory Database alongside the PyPA database: fix-vulnerable-deps now unions uv audit with Dependabot alerts and credits each entry’s source. Configurable via [tool.repomatic] vulnerable-deps.sources.

  • Fix generated thin-caller fidelity: triggers mirror the canonical workflow verbatim instead of always injecting workflow_dispatch, universal path entries are preserved, and repomatic workflow lint now flags extra triggers absent upstream.

  • Fix sync-uv-lock and fix-vulnerable-deps PR bodies showing 1-01-01 as the exclude-newer cutoff when pyproject.toml configures a relative span like "1 week".

  • Fix broken documentation links in all 18 PR body templates, now pointing at the published configuration.html and workflows.html anchors with each option name linked to its own anchor.

  • Fix release.yaml discarding healthy binaries when one matrix cell crashed: the compile-binaries matrix sets fail-fast: false and publish-release uploads whatever built.

  • Fix update-docs ↔ format-markdown ping-pong on docs/cli.md and docs/configuration.md.

  • Bump pinned uv to 0.11.8 and mdformat-pelican to 1.0.0, fixing non-ASCII anchor links being percent-encoded on every format-markdown run.

6.15.0 (2026-04-27)ΒΆ

Note

6.15.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Decode percent-encoded non-ASCII characters in Markdown link destinations back to their original form, so non-ASCII anchors no longer get rewritten to %XX on every format-markdown run.

  • Add πŸ’Έ/πŸ†“ licensing markers to the awesome-list contributing guide, issue template, and PR template (English and Chinese mirrors): πŸ’Έ for a paid version atop an OSS core, πŸ†“ for fully open-source.

  • Add the agents component to repomatic init for deploying Claude Code agents (grunt-qa, qa-engineer) downstream. Excluded by default; opt in via [tool.repomatic] include = ["agents"]. Destination set by [tool.repomatic] agents.location.

  • Add docs/benchmark.md comparing repomatic against ten alternatives across template sync, repo governance, release automation, and changelog lifecycle.

  • Switch MyST admonitions to backtick fences (```{note}) instead of colon fences project-wide so mdformat preserves them; the convert-to-myst command now emits backtick fences.

  • Expand the myst_docstrings Sphinx extension: convert plain triple-backtick code fences and footnotes to reST, and run MyST-to-reST conversion before sphinx_autodoc_typehints.

  • Upgrade lychee to 0.24.1, which reads its [tool.lychee] config directly from pyproject.toml so repomatic drops the TOML translation bridge.

  • Fix repomatic init reporting unchanged files as updated; re-running against an unchanged tree is now a true no-op.

  • Fix update-docs ↔ format-markdown ping-pong on docs/tool-runner.md.

6.14.0 (2026-04-20)ΒΆ

Note

6.14.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Add a Sphinx documentation site (Furo theme, MyST-Parser) splitting the monolithic readme.md into focused pages: installation, configuration, CLI parameters, reusable workflows, security, skills, and a tool runner tutorial. Deployed via docs.yaml.

  • Add the repomatic.myst_docstrings Sphinx extension and repomatic.myst_converter utility, converting MyST markdown in docstrings to reST at build time so sphinx.ext.autodoc works unmodified. convert-to-myst rewrites source files in place.

  • Add a --sort-by option to the show-config, metadata --list-keys, run --list, and cache show commands; each defaults to a natural sort column and accepts any column name.

  • Add an incremental mode to the brand-assets skill: when base SVGs already exist, skip the design menu and fill gaps directly.

  • Add a check_stale_gh_pages_branch lint check and setup-guide instructions for deleting leftover gh-pages branches after switching to GitHub Actions deployment.

  • Fix Matrix.prune() keeping exclude directives that reference keys absent from the matrix axes, which GitHub Actions rejects.

  • Fix the setup-guide Pages step for Sphinx projects: reopen the issue when Pages is unconfigured, and offer both first-time-enable and update commands.

  • Fix the sponsor-label job in labels.yaml missing an actions/checkout step, which caused it to fail.

6.13.0 (2026-04-15)ΒΆ

Note

6.13.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Add nuitka.entry-points config option to select which [project.scripts] entries produce Nuitka binaries; aliases pointing to the same callable are deduplicated by default.

  • Add two-phase VirusTotal scanning: an initial table with scan links, then a --poll pass that fills in a Detections column of flagged / total engine counts.

  • Add av-false-positive skill to scan release binaries on VirusTotal and generate per-vendor false-positive submission files for flagged artifacts.

  • Add update-checksums.yaml workflow that recomputes SHA-256 checksums for binary tools bumped by Renovate and commits the fix to the PR branch.

  • Include release notes for every intermediate version in sync-uv-lock PR bodies, not just the target version.

  • Config include entries now bypass RepoScope filtering, matching explicit CLI component naming; qualified entries like skills/awesome-triage implicitly select their parent component.

  • Add baseline criteria for GitHub repositories in awesome list contributing guidelines: minimum 50 stars, not archived, and updated within 3 years.

  • Add --min-savings-bytes option to format-images (default 1024) to skip images whose absolute byte savings are negligible.

  • Add cross-platform binary support (macOS arm64/x64, Linux arm64/x64, Windows x64) for actionlint, biome, gitleaks, labelmaker, lychee, shfmt, and typos, plus ZIP archive extraction.

  • Show a progress bar during binary tool downloads when the server reports Content-Length; interactive terminals only, silent in CI.

  • Verify cached binaries with a two-layer integrity model: the registry checksum at download time and a .sha256 sidecar on every cache hit.

  • Enable [tool.actionlint] config support, translating it to .github/actionlint.yaml at invocation time.

  • Cache downloaded tool binaries across CI runs with actions/cache, keyed per tool, OS, and architecture.

  • Replace peaceiris/actions-gh-pages with GitHub’s native actions/upload-pages-artifact and actions/deploy-pages for documentation deployment, plus a lint-repo check that the Pages source is set to GitHub Actions.

  • Add benchmark-update skill to create and maintain competitive benchmark pages (docs/benchmark.md) with audit, init, add, and refresh-badges modes.

  • Add upstream-audit skill to create and maintain upstream contribution tracking pages (docs/upstream.md) with audit, init, refresh, and sync-git modes.

  • Upgrade the macOS Intel runner from macos-15-intel to macos-26-intel across binary builds, the test matrix, and Nuitka compilation.

  • Run the lint-repo workflow job on all repositories, not just Python projects, so generic checks apply to awesome lists too.

  • Centralize GitHub token resolution with priority REPOMATIC_PAT > GH_TOKEN > GITHUB_TOKEN and automatic fallback to GITHUB_TOKEN on an expired PAT; --has-pat on setup-guide and lint-repo now auto-detects from REPOMATIC_PAT.

  • Fix exclude-newer-package pruning in pyproject.toml to remove orphaned comments and emit pyproject-fmt-compatible inline tables.

  • Give a clear error when exiftool is not installed instead of a bare FileNotFoundError, and verify it is on PATH after the Windows install step.

  • Create parent directories for --output file paths in repomatic run, fixing lychee write errors when the output directory is missing.

  • Sanitize @mentions, #issue references, and github.com URLs in Lychee and Sphinx linkcheck output before embedding them in the broken-links issue.

6.12.0 (2026-04-13)ΒΆ

Note

6.12.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: rename the shell_files metadata key to shfmt_files, and exclude Zsh files and .sh files with a Zsh shebang from shfmt processing.

  • Add repomatic cache subcommands (show, clean, path) and a global binary cache for downloaded tools; cached binaries are re-verified against their checksum and auto-purged after 30 days (configurable via REPOMATIC_CACHE_MAX_AGE). Add --no-cache to repomatic run to bypass it.

  • Add an HTTP response cache for PyPI metadata and GitHub release bodies to avoid redundant API calls, plus --namespace on repomatic cache clean for targeted cleanup.

  • Route generated tool configs through the cache directory and pass them explicitly via --config, instead of writing to /tmp or the repository root.

  • Add --version, --checksum, and --skip-checksum options to repomatic run to override the pinned tool version and SHA-256 verification at invocation time.

  • Add structured logging to repomatic run: --verbosity INFO reports config precedence, the full command, and exit code; DEBUG adds parsed config details.

  • Add skills.location config option to override the Claude Code skills directory (default ./.claude/skills/).

  • Add changelog.location config option to override the changelog file path (default ./changelog.md), honored by all CLI commands.

  • Add .claude/package-skills.sh to package each Claude Code skill as a ZIP for manual upload to Claude Desktop.

  • Sanitize @mentions, #issue references, and github.com URLs in upstream release notes embedded in sync-uv-lock PR bodies to prevent auto-linking and backlink cross-references.

  • Use the REPOMATIC_PAT token in all peter-evans/create-pull-request steps so created PRs trigger other workflows.

  • Make the uv sync step in lint-types conditional on is_python_project, so repos with Python files but no lockfile can still be type-checked.

  • Fix format-json failing with a --config-path error when a [tool.biome] section exists.

  • Improve the file-bug-report skill to check organization-level community health files before per-repo files.

6.11.3 (2026-04-09)ΒΆ

Note

6.11.3 is available on 🐍 PyPI and πŸ™ GitHub.

  • Add a lint-repo check warning when the GitHub Actions fork PR approval policy is weaker than first_time_contributors, with a setup guide step to fix it.

  • Add a readme.md supply chain security section mapping Astral’s security practices to concrete repomatic implementations.

  • Fix rst_to_myst conversion leaving RST backslash escapes in headings and not wrapping dotted module names in backticks.

  • Fix the format-pyproject autofix job failing with exit code 123.

  • Disable the uv cache in the publish-pypi release job, which has no checkout and emitted spurious cache-miss warnings.

6.11.2 (2026-04-08)ΒΆ

Note

6.11.2 is available on 🐍 PyPI and πŸ™ GitHub.

  • Add the shfmt shell formatter to the tool runner (repomatic run shfmt).

  • Add a format-shell autofix job to auto-format shell scripts with shfmt.

  • Replace the crazy-max/ghaction-virustotal action with a native repomatic scan-virustotal command, fixing the silently skipped release-body update.

  • Deduplicate release attestations: Python packages are now attested once in build-package instead of three times, and .gitignore is no longer accidentally attested.

6.11.1 (2026-04-08)ΒΆ

Note

6.11.1 is available on 🐍 PyPI and πŸ™ GitHub.

  • Parallelize the release workflow: compile-binaries starts right after metadata, and publish-pypi runs concurrently with create-tag and create-release, with binary and attestation uploads deferred to publish-release.

  • Fall back to the PyPI project_urls changelog link when a package has no GitHub Release, so release notes render a [Changelog] link instead of omitting the package.

  • Fix the release workflow uploading the attestation bundle before the GitHub release draft existed.

  • Skip exclude-newer-package exemptions for packages whose fixed version already falls within the exclude-newer cooldown window.

  • Fix --delete-excluded not detecting scope-excluded component files that still exist on disk.

  • Fix awesome-template sync overwriting pyproject.toml instead of merging, which stripped user-managed [tool.*] sections.

  • Fix repomatic init <component> silently ignoring an explicitly requested component when its scope did not match the repo.

  • Fix --delete-excluded removing opt-in workflow files in the source repo by skipping config-key exclusions there.

  • Fix the format-pyproject autofix step running with no input files and masking tool errors.

6.11.0 (2026-04-07)ΒΆ

Note

6.11.0 is available on 🐍 PyPI.

Warning

6.11.0 is not available on πŸ™ GitHub.

  • Preserve extra downstream jobs when syncing thin-caller workflows; the managed job is regenerated in place while project-specific jobs, comments, and blank lines are kept.

  • Add a VirusTotal scanning job to the release workflow that uploads compiled binaries to seed AV databases. Requires the optional VIRUSTOTAL_API_KEY repository secret.

  • Verify each attestation in CI right after actions/attest with gh attestation verify.

  • Upload Sigstore attestation bundles (.jsonl) as GitHub release assets for compiled binaries and Python packages, enabling offline verification.

  • Add a lint-repo warning when VIRUSTOTAL_API_KEY is missing and Nuitka binary compilation is active.

  • Add a VirusTotal API key setup step to the setup guide issue, shown only when Nuitka compilation is active.

  • Remove the one-time bumpversion dev-versioning migration code now that all downstream repos use PEP 440 dev versioning.

6.10.0 (2026-04-03)ΒΆ

Note

6.10.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: Remove the -o short option from pr-body and format-images; use --output.

  • Add brand-assets skill to create and export project logo/banner SVG assets to light/dark PNG variants.

  • Add babysit-ci skill to monitor CI test workflows, diagnose failures, fix code, and loop until stable jobs pass.

  • Add file-bug-report skill to write upstream bug reports from contribution guidelines, issue templates, and community norms.

  • Add test-matrix.replace and test-matrix.remove config to swap or drop axis values in the test matrices.

  • Add sync_mode=ONGOING for tool configs to repeatedly sync while preserving local additions, starting with sync-bumpversion keeping local [[tool.bumpversion.files]] entries.

  • Add --output-format [markdown|github-actions] to sync-uv-lock, fix-vulnerable-deps, pr-body, and format-images, replacing implicit $GITHUB_OUTPUT detection.

  • Add .claude/scheduled_tasks.lock to the default .gitignore extra content.

  • Add a collapsible workflow metadata table (trigger, actor, commit, job, workflow, run link) to issue lifecycle comments.

  • Make the setup-guide issue body a set of collapsible per-step sections with status indicators, and close it only once PAT, permissions, vulnerability alerts, and branch protection are all verified.

  • Add --release-notes/--no-release-notes and --table/--no-table flags to sync-uv-lock, defaulting to a terminal table and reserving markdown for --output.

  • Prune stale exclude-newer-package entries from pyproject.toml before relocking in sync-uv-lock.

  • Make the renovate component opt-in, and exclude renovate and codecov from awesome-list repositories.

  • Remove Python 3.15t (free-threaded) from the default test matrix.

  • Warn instead of crashing on unknown [tool.repomatic] configuration keys.

  • Echo metadata output to stderr when --output targets a file, so computed matrices stay visible in CI logs.

  • Add the repomatic update-docs command to run sphinx-apidoc, RST-to-MyST conversion, and docs/docs_update.py in one step.

  • Add docs.apidoc-extra-args, docs.apidoc-exclude, and docs.update-script configuration options.

  • Move the sync-uv-lock job from renovate.yaml to autofix.yaml so it runs on every push to main.

  • Fix a CLI crash when test-matrix.variations or test-matrix.replace contain nested keys.

6.9.0 (2026-03-31)ΒΆ

Note

6.9.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: Rename the config subcommand to show-config (it now resolves typed [tool.repomatic] config via click-extra).

  • Breaking: Remove the prebake-version and prebake-tag-sha commands; use click-extra prebake instead.

  • Add per-project test matrix configuration via [tool.repomatic.test-matrix], supporting exclude, include, and variations.

  • Replace the audit-deps lint job with a fix-vulnerable-deps autofix job that opens PRs upgrading vulnerable packages.

  • Add a codecov bundled component that syncs .github/codecov.yaml to suppress noisy PR comments.

  • Support tool-runner config for tools that discover config from the working directory rather than a --config flag.

  • Move the mdformat number default to a bundled mdformat.toml so downstream repos can override it.

  • Expand PAT validation in lint-repo and check-renovate with repository scope, tag ruleset, and permission checks.

  • Auto-exclude changelog.md for awesome-list repositories.

  • Migrate from actions/attest-build-provenance to actions/attest.

  • Run granular PAT permission checks in setup-guide, keeping the issue open with a diagnostic table when permissions are incomplete.

  • Fix the setup-guide job so PAT detection works everywhere.

  • Fix an infinite cycle between the migrate-to-renovate and sync-repomatic jobs.

  • Include git stderr in git-tag CLI error messages.

6.8.0 (2026-03-27)ΒΆ

Note

6.8.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: Rename repomatic init --delete-redundant to --delete-unmodified, which now also removes config files identical to bundled defaults.

  • Breaking: Remove the deprecated WORKFLOW_UPDATE_GITHUB_PAT secret and its fallbacks; downstream repos must use REPOMATIC_PAT.

  • Breaking: Stop persisting [tool.ruff] defaults into downstream pyproject.toml; bundled ruff config is now injected at runtime when none exists.

  • Breaking: Remove the sync-renovate command, autofix job, renovate.sync config toggle, and PR body template; sync-repomatic and runtime materialization replace them.

  • Breaking: Merge /repomatic-deps-review into /repomatic-deps, which now supports graph and review modes.

  • Move the test matrix definition into repomatic metadata so it is available in job-level if: conditions.

  • Reduce CI jobs on pull requests by skipping release builds, experimental Python versions, and redundant verification tests; the full matrix still runs on push to main.

  • Make exclude config additive to the default exclusions (labels, skills), and add an include config to force-include default-excluded components.

  • Auto-exclude the awesome-triage skill for non-awesome repositories.

  • Add --delete-excluded to repomatic init to remove excluded files that still exist on disk.

  • Replace the sync-workflows and clean-unmodified-configs autofix jobs with a single sync-repomatic job that syncs and prunes managed files in one PR.

  • Add PAT capability and repo configuration checks to lint-repo (Renovate config, Dependabot security updates off, vulnerability alerts on, PAT permissions).

  • Add stale draft release detection to lint-repo, warning about draft releases whose tag does not end with .dev0.

  • Relax the abandoned-dependency threshold from 1 year to 2 years in the Renovate config.

  • Fix thin-caller generation rendering workflow_dispatch inputs as Python dicts instead of YAML.

  • Add the /sphinx-docs-sync skill for cross-project Sphinx documentation comparison and synchronization.

  • Add the /translation-sync skill to detect and draft fixes for stale readme.*.md and contributing.*.md translations; auto-excluded for non-awesome repos.

  • Streamline Dependabot guidance in the setup-guide issue.

  • Allow repomatic init to accept qualified component/file selectors (like repomatic init skills/repomatic-topics).

  • Only auto-include the awesome-template component for awesome-* repos when no explicit components are given.

  • Add a package version diff table to sync-uv-lock PRs, listing updated, added, and removed packages with PyPI links and collapsible release notes.

  • Document file naming conventions in claude.md: prefer .yaml over .yml and lowercase filenames, with a table of GitHub exceptions.

  • Fix awesome-template URL rewriting to also process .yml files in .github/.

  • Auto-exclude the changelog.yaml, debug.yaml, and release.yaml workflows for awesome-* repositories.

  • Materialize the bundled renovate.json5 at runtime when absent, so downstream repos can safely delete their own copy.

  • Pin GitHub Actions to SHA digests via Renovate’s helpers:pinGitHubActionDigestsToSemver preset.

  • Add top-level permissions: {} to all workflow files, requiring each job to declare its own minimal permissions.

  • Fix sync-repomatic deleting the upstream repo’s own skills.

  • Generalize the opt_in_key config option into config_key/config_default.

6.7.0 (2026-03-24)ΒΆ

Note

6.7.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: Remove the sync-skills, workflow create, and workflow sync commands; repomatic init handles all three.

  • Bundle awesome-template boilerplate files in repomatic instead of cloning kdeldycke/awesome-template at runtime.

  • Format every pyproject.toml in the repo in the format-pyproject job, not just the root file.

  • Add a branch protection checklist to the setup-guide issue, linking to a pre-filled ruleset creation form.

  • Add an opt-in unsubscribe.yaml reusable workflow for scheduled cleanup of closed notification threads, enabled via notification.unsubscribe = true and requiring REPOMATIC_NOTIFICATIONS_PAT.

  • Surface actual gh CLI error messages in unsubscribe-threads warnings.

  • Enable delete-branch: true on all peter-evans/create-pull-request invocations so stale automation PRs auto-close.

  • Add gitleaks to the tool runner with binary download and [tool.gitleaks] config bridge, and migrate lint-secrets to repomatic run gitleaks.

  • Move lychee config from lychee.toml to [tool.lychee] in pyproject.toml.

  • Fix the format-images job by installing oxipng from its GitHub release .deb so it runs on ubuntu-slim.

6.6.0 (2026-03-23)ΒΆ

Note

6.6.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: downstream repos with yamllint or zizmor in their [tool.repomatic] exclude list must remove those entries.

  • Remove yamllint and zizmor init components; the tool runner falls back to bundled default configs at runtime. Default exclude is now ["labels", "skills"].

  • Add repomatic clean-redundant-configs command and autofix job that removes native config files identical to bundled defaults; repomatic init warns about redundant configs on disk.

  • Rename the WORKFLOW_UPDATE_GITHUB_PAT secret to REPOMATIC_PAT; workflows accept both names. Old-name repos get a migration issue that auto-closes once REPOMATIC_PAT is detected.

  • Add a setup-guide toggle to [tool.repomatic] to suppress the setup guide issue.

  • Pre-fill the fine-grained PAT creation form via URL and provide gh CLI commands for adding the secret, configuring Dependabot, and triggering a verify run.

  • Add a lint-repo check that warns when the owner has GitHub Sponsors enabled but .github/FUNDING.yml is missing.

6.5.0 (2026-03-23)ΒΆ

Note

6.5.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Breaking: the old init.exclude and workflow.sync-exclude keys are no longer recognized and raise a hard error.

  • Breaking: remove legacy [tool.gha-utils] and [tool.repokit] config migration; rename old sections to [tool.repomatic] manually.

  • Replace init.exclude and workflow.sync-exclude with a unified exclude key: bare names exclude whole components, component/identifier entries exclude specific files.

  • Add repomatic run <tool> for unified tool invocation with managed config resolution (native file, [tool.X], bundled default, bare); use --list to see managed tools and their active config source.

  • Register actionlint, autopep8, biome, bump-my-version, labelmaker, lychee, mdformat, mypy, pyproject-fmt, ruff, typos, yamllint, and zizmor with repomatic run, and migrate all workflow tool invocations to it.

  • Add a yamllint init component, excluded from init by default like zizmor.

  • Add repomatic update-checksums --registry to refresh SHA-256 hashes for binary tools.

  • Add [tool.lychee] and [tool.biome] config translation, so downstream repos can configure lychee and biome from pyproject.toml without separate config files.

6.4.1 (2026-03-11)ΒΆ

Note

6.4.1 is available on 🐍 PyPI and πŸ™ GitHub.

  • Add a github-json output dialect to repomatic metadata that bundles all keys into a single metadata output, accessed via fromJSON(needs.metadata.outputs.metadata).key_name.

  • Add key filtering to repomatic metadata: pass key names as arguments to output only those values.

  • Add a --list-keys flag to repomatic metadata to list all available keys with descriptions.

  • Rename the project-metadata job and step IDs to metadata across all workflows.

  • Rename the linters init component to zizmor; default init.exclude is now ["labels", "skills", "zizmor"].

  • Remove the sync-zizmor job, CLI command, and zizmor.sync toggle; zizmor.yaml is now user-owned and created by repomatic init zizmor if missing.

  • Rename the bump-versions job to bump-version in changelog.yaml.

  • Upgrade zizmor to 1.23.0 and re-enable the template-injection audit.

  • Fix repomatic metadata list values breaking GitHub Actions ${{ }} interpolation: lists are now pre-formatted (file lists as quoted strings, plain lists space-separated, dict lists as JSON).

  • Fix repomatic workflow sync --format header-only erroring when a target workflow file is absent downstream; missing default files are skipped and named missing files warn instead.

  • Enable parallel test execution by default via --numprocesses=auto.

6.4.0 (2026-03-10)ΒΆ

Note

6.4.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Rename optimize-images to format-images, aligning it with the format-* naming convention, and add a matching PR body template.

  • Allow --prefix and --template to be combined in repomatic pr-body; the prefix is prepended before the rendered template.

  • Add awesome-template-sync, bumpversion-sync, dev-release-sync, gitignore-sync, labels-sync, mailmap-sync, uv-lock-sync, and zizmor-sync toggles to [tool.repomatic], so each sync operation can be individually disabled.

  • Rename sync-linter-configs to sync-zizmor (and linter-sync to zizmor-sync), naming the sync job after the tool it syncs.

  • Add a repomatic sync-labels command wrapping labelmaker with toggle check, profile detection, and extra label file handling.

  • Replace AndreasAugustin/actions-template-sync with a native repomatic sync-awesome-template command.

  • Add repomatic init typos to sync the shared typos spell-checker config into pyproject.toml, with proper-noun corrections and <!-- typos:off --> / <!-- typos:on --> block markers.

  • Skip Ruff config injection in format-python for non-Python projects, and skip sync-bumpversion for non-Python projects.

  • Use TOML sub-keys for grouped [tool.repomatic] options (like nuitka.enabled, gitignore.location, test-plan.file); only pypi-package-history stays flat.

  • Add a workflow-source-paths option to [tool.repomatic]: thin-caller and header-only workflows gain paths: filters for the project’s source directory, auto-derived from [project.name].

  • Add a repomatic config command that renders the [tool.repomatic] reference table.

  • Add ### Configuration sections to PR body templates listing the relevant [tool.repomatic] options.

6.3.2 (2026-03-08)ΒΆ

Note

6.3.2 is available on 🐍 PyPI and πŸ™ GitHub.

  • Add --all-extras to the uv sync step in tests.yaml to catch incompatibilities between optional dependency groups.

  • Add a test-package-install job to tests.yaml that verifies every [project.scripts] entry point installs and runs via uvx, uv run --with, module invocation, uv tool install, and pipx run, from PyPI and GitHub. Add a cli_scripts metadata output.

  • Sync customManagers to downstream renovate.json5 so Renovate can update inline version pins in workflow files.

  • Fix thin-caller generation stripping paths and paths-ignore filters, which incorrectly restricted CI triggers downstream.

  • Fix the optimize-images job failing on ubuntu-slim where oxipng is unavailable.

  • Add a citation.cff date-released update to the bundled bumpversion.toml template so downstream repos keep their release date in sync on version bumps.

6.3.1 (2026-03-07)ΒΆ

Note

6.3.1 is available on 🐍 PyPI and πŸ™ GitHub.

  • Sync the repomatic-audit skill to downstream repos.

6.3.0 (2026-03-06)ΒΆ

Note

6.3.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • repomatic init now always overwrites managed files (workflows, configs, skills) by default; remove the --overwrite flag. changelog.md is never overwritten once it exists.

  • repomatic init output now distinguishes created, updated, and skipped files, and warns about excluded files still on disk.

  • Auto-remove legacy .claude/skills/gha-*/ skill directories during repomatic init, completing the gha-utils to repomatic rename.

  • sync-bumpversion, sync-linter-configs, and sync-skills now report both created and updated files.

  • sync-bumpversion now replaces the whole [tool.bumpversion] section from the bundled template instead of applying incremental migrations.

  • Use the short SHA in release workflow job names instead of the full commit hash.

6.2.1 (2026-03-06)ΒΆ

Note

6.2.1 is available on 🐍 PyPI and πŸ™ GitHub.

  • Fix actions/checkout wiping downloaded Python package artifacts before gh release create could attach them, so release drafts now include the distribution files.

  • Fix fix-changelog marking releases as not available on GitHub while the release was still a draft.

6.2.0 (2026-03-05)ΒΆ

Note

6.2.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Add the repomatic optimize-images CLI command (lossless oxipng for PNG, jpegoptim for JPEG), replacing calibreapp/image-actions.

  • Add the sync-dev-release CLI command and workflow job to maintain a rolling dev pre-release on GitHub with the latest binaries and Python package.

  • Add the repomatic-topics skill for optimizing GitHub repository topics for discoverability.

  • Add a lint-repo check that warns when GitHub topics are not a subset of pyproject.toml keywords.

  • Add the init-exclude config option to skip components during repomatic init, defaulting to ["labels", "linters", "skills"]; workflow-sync-exclude now also applies to repomatic init.

  • Add rename-from rules to migrate all 9 default GitHub labels.

  • Add the package version to compiled binary filenames (repomatic-6.2.0-linux-arm64.bin).

  • Automatically migrate [tool.gha-utils] and [tool.repokit] config sections to [tool.repomatic] during repomatic init; commands fall back to legacy section names when [tool.repomatic] is absent.

  • Support GitHub immutable releases by drafting releases then publishing them.

  • Replace softprops/action-gh-release with gh release create; all release operations now use the gh CLI.

  • Freeze readme binary download URLs to versioned /releases/download/vX.Y.Z/ paths during releases.

  • GitHub releases now include PyPI and GitHub availability links at creation time.

  • Fix Nuitka-compiled binaries silently producing no output when the entry point is a __main__.py inside a package.

  • Fix update-checksums leaving stale SHA-256 hashes when the hash and sha256sum --check keyword span multiple lines.

  • Fix Windows ARM64 test runners using x86_64 emulation by forcing native ARM64 Python via UV_PYTHON.

  • Fix fix-changelog producing a trailing blank line when the last changelog section is modified.

6.1.0 (2026-02-27)ΒΆ

Note

6.1.0 is available on 🐍 PyPI and πŸ™ GitHub.

  • Add the unsubscribe-threads CLI command to unsubscribe from closed, inactive GitHub notification threads.

  • Add the prebake-version CLI command to inject the Git commit hash into __version__ before Nuitka compilation, so binaries report the exact commit they were built from (e.g., 6.1.0.dev0+abc1234).

  • Add the list-skills CLI command to display all available Claude Code skills grouped by lifecycle phase.

  • Add the sync-github-releases CLI command to sync GitHub release notes from changelog.md.

  • Add the pypi-package-history config option so lint-changelog fetches releases from former package names and generates correct PyPI URLs for renamed projects.

  • lint-changelog now detects orphaned versions (git tags, GitHub releases, or PyPI packages with no changelog entry) and inserts placeholder sections in --fix mode.

  • Rename the lint-changelog workflow job to fix-changelog; the CLI command remains lint-changelog.

  • Make changelog entries and GitHub release bodies template-driven via release-notes.md and github-releases.md, so editing one template affects only its destination.

  • Group CLI commands into sections (Project setup, Release & versioning, Sync, Linting & checks, GitHub issues & PRs) in help output.

  • Add next-step handoff suggestions to all Claude Code skills, and document skills with a grouped table and walkthrough in readme.md.

  • Generate thin caller workflows with explicit secret forwarding instead of secrets: inherit.

  • Move zizmor config from .github/zizmor.yml to zizmor.yaml at repo root.

6.0.1 (2026-02-24)ΒΆ

Note

First release under the repomatic name on PyPI, after repokit was rejected for typo-squatting (see 6.0.0). The GitHub repository is kdeldycke/repomatic.

Note

6.0.1 is available on 🐍 PyPI and πŸ™ GitHub.

  • Rename project from repokit to repomatic. Rename GitHub repository from kdeldycke/repokit to kdeldycke/repomatic.

6.0.0 (2026-02-24)ΒΆ

Caution

This release was deleted from PyPI. It was supposed to be published as repokit, but PyPI flagged the name as typo-squatting the pre-existing repo-kit package.

Note

6.0.0 is available on πŸ™ GitHub.

Warning

6.0.0 is not available on 🐍 PyPI.

  • Rename project from gha-utils to repokit. Rename GitHub repository from kdeldycke/workflows to kdeldycke/repokit.

Earlier releasesΒΆ

Note

Releases 5.14.1 and earlier are recorded in the changelog archive.