repomatic run - Run a registered external tool, pinned and
checksum-verified
repomatic run [OPTIONS] [TOOL]
[EXTRA_ARGS]...
Run an external tool with managed configuration.
Installs the tool at a pinned version, resolves config through a
4-level precedence chain (native config file, [tool.X] in pyproject.toml,
bundled default, bare invocation), and invokes the tool.
Binary tools are cached locally to avoid re-downloading on
repeated runs. Use --no-cache to force a fresh download. See repomatic cache
for cache management.
Pass extra arguments to the tool after --:
repomatic run yamllint -- --strict .
repomatic run zizmor -- --persona auditor .
Report what a formatter would rewrite, leaving the tree alone:
repomatic run mdformat --verify -- changelog.md
Override the pinned version:
repomatic run shfmt --version 3.14.0 --skip-checksum -- .
List all managed tools and their resolved config source:
repomatic run --list
- [TOOL]
- [EXTRA_ARGS]...
- --list
- List all managed tools.
- --verify
- Report which targets the tool would rewrite, without touching them. Runs
the write path against throwaway copies, so the answer holds even for a
tool whose own --check mode is unreliable.
- --version
TEXT
- Override the pinned version of the tool.
- --checksum
TEXT
- Override the SHA-256 checksum for the current platform.
- --skip-checksum
- Skip SHA-256 verification of binary downloads.
- --no-cache
- Bypass the binary cache (download fresh every time).
- --sort-by
[tool|version|config-source]
- Sort table by this column. Repeat to set priority.
- --help /
-h
- Show this message and exit.
- RUN_LIST_TOOLS
- List all managed tools.
- RUN_VERIFY
- Report which targets the tool would rewrite, without touching them. Runs
the write path against throwaway copies, so the answer holds even for a
tool whose own --check mode is unreliable.
- RUN_TOOL_VERSION
- Override the pinned version of the tool.
- RUN_CHECKSUM
- Override the SHA-256 checksum for the current platform.
- RUN_SKIP_CHECKSUM
- Skip SHA-256 verification of binary downloads.
- RUN_NO_CACHE
- Bypass the binary cache (download fresh every time).
- RUN_SORT_BY
- Sort table by this column. Repeat to set priority.
- RUN__CLICK_DEFAULT_HELP
- Show this message and exit.
- 0
- Success.
- 1
- A runtime error, or an aborted prompt (Ctrl-C, a declined
confirmation).
- 2
- A usage error: unknown option, invalid value, missing operand, or an
unparsable configuration file.