On this page
Developer utilities for rlsbl projects: per-target local installs, sibling checkout overlays via dev sync, and overlay drift reporting.
#rlsbl dev
Developer utilities for locally working with rlsbl projects, including editable installs that mirror the project's release target (pypi -> uv tool install -e, npm -> npm link, go -> go install).
#dev install
Install the project locally for development by running each detected target's own install command. --global (the default) is supported by 7 targets: pypi (uv tool install -e), npm (npm link), go, deno, zig, swift, and hex. --venv installs into the project's local environment instead and covers pypi, npm, deno, and hex; other targets are skipped with a reason. --uninstall reverses a previous install on pypi, npm, and deno. In monorepo mode, pair with --all, --include, or --exclude.
Effect: mutating
#Flags
| Name | Short | Type | Default | Env | Description |
|---|---|---|---|---|---|
--all | bool | In monorepo mode, install every project in the workspace | |||
--include | str | In monorepo mode, comma-separated project names to include | |||
--exclude | str | In monorepo mode, comma-separated project names to exclude | |||
--uninstall | bool | Reverse a previous dev install (where supported by the target) | |||
--global | bool | Install as a global tool/symlink. This is the default behavior when neither --global nor --venv is passed. Mutually exclusive with --venv. | |||
--venv | bool | Install into the project's local environment only (e.g. uv sync, npm install). Mutually exclusive with --global. |
#dev sync
Overlay local editable checkouts of sibling projects onto this project's locked environment. Reads dev-sources.toml.local-only for overlay entries, runs uv sync --inexact excluding overlaid packages, then uv pip install -e per entry. Requires UV_NO_SYNC=1 in the environment to prevent bare uv run from reverting overlays.
Effect: mutating
#dev status
Report the state of local dev-sync overlays: for each package recorded in the dev-overlays sentinel, show its declared editable checkout path and version alongside the venv's actual install (editable at the expected path, WIPED back to a registry wheel, or missing entirely). Exits 1 if any overlay drifted so scripts and pre-run guards can detect a silent wipe by a bare uv sync or uv run; exits 0 when all overlays are intact or none are declared.
Effect: read_only