REPOMATIC-SYNC-DEPS(1) REPOMATIC-SYNC-DEPS(1)

repomatic sync-deps - Update dependencies, all or a named subset

repomatic sync-deps [OPTIONS] [sync-dep-sources|sync-uv-lock|sync-action-pins|sync-workflow-pins|sync-tool-versions]...

Update project dependencies, the whole set or a named subset.

The single entry point for dependency updates. It drives
sync-dep-sources, sync-uv-lock, sync-action-pins, sync-workflow-pins, and
sync-tool-versions: their network discovery runs concurrently (one shared
HTTP cache, one spinner), then the file rewrites apply serially because
two of them touch the same workflow files. Name one or more updaters to
run just those; with none named, every enabled updater runs.

The [tool.repomatic] feature flags are always authoritative: a disabled
updater never runs. With no names, updaters not meaningful in the current
working tree are skipped too (sync-tool-versions outside the repomatic
checkout, the pin updaters without workflow files); naming one runs it
regardless of the working tree.

With --pr-sync, each updater instead runs on its own, from a tree put back
to HEAD, and opens, refreshes or closes the pull request on the branch
named after it. A named updater with nothing to act on in this tree runs
nothing, and only closes a stale pull request. A failed updater leaves its
pull request alone, the others still run, and the command exits 1. Since
the reset discards uncommitted changes, the mode refuses to start when a
tracked file holds some, staged or not. Untracked files do not block it.
[sync-dep-sources|sync-uv-lock|sync-action-pins|sync-workflow-pins|sync-tool-versions]...

Write a combined markdown report (one section per updater) to this file.
Format of the --output file. github-actions writes step outputs, for $GITHUB_OUTPUT.
Fetch release notes from GitHub (markdown, appended after the table).
Report newer releases withheld by the minimum-release-age cooldown.
Report what would be done without making changes.
Run the updaters one after the other, each from a clean tree, and open, refresh or close the pull request of each, as `pr-sync` does. The mode the autofix workflow runs. Refuses to start while a tracked file holds uncommitted changes.
Show this message and exit.

Write a combined markdown report (one section per updater) to this file.
Format of the --output file. github-actions writes step outputs, for $GITHUB_OUTPUT.
Fetch release notes from GitHub (markdown, appended after the table).
Report newer releases withheld by the minimum-release-age cooldown.
Report what would be done without making changes.
Run the updaters one after the other, each from a clean tree, and open, refresh or close the pull request of each, as `pr-sync` does. The mode the autofix workflow runs. Refuses to start while a tracked file holds uncommitted changes.
Show this message and exit.

0
Success.
1
A runtime error, an aborted prompt (Ctrl-D), or a declined confirmation.
2
A usage error: unknown option, invalid value, missing operand, or an unparsable configuration file.
130
Interrupted with Ctrl-C: the process ends by SIGINT, reported as 130.

Update everything enabled

repomatic sync\-deps

Only the lockfile and action pins

repomatic sync\-deps sync\-uv\-lock sync\-action\-pins

Preview without writing

repomatic sync\-deps \-\-dry\-run

CI: one pull request per updater

repomatic sync\-deps \-\-pr\-sync \-\-release\-notes sync\-uv\-lock

Kevin Deldycke

2026-10-29 8.0.1.dev0