Skip to content

lock

Write both locks: toolroom.lock for the tools, uv.lock for the venv.

The pair to sync, in uv's shape: this decides what a checkout installs and nothing on the machine changes, and sync installs what these say. An entry that still satisfies its declarations stands, so a newer release moves nothing until an upgrade asks.

--upgrade moves every entry of both locks to its newest eligible version, and --check reports whether both locks are current and writes nothing, exiting non-zero when either would move. Both mean the same thing to each half, so both reach both.

A name does not. --upgrade-tool names tools and reaches the tools alone, because a tool is not a package in uv.lock: for one package there, uv lock --upgrade-package is the verb.

fm lock [--upgrade] [--upgrade-tool=VALUE ...] [--check]
Parameter Type Default Description
--upgrade flag false
--upgrade-tool=VALUE repeatable move just these tools to their newest
--check flag false

Example

$ fm lock --upgrade