Tiny wrapper that watches the current directory and reruns a Python target with uv run whenever files change.
From PyPI via pipx: https://pypi.org/project/iuv/
pipx install iuvPersistent install with uv from head:
uv tool install git+https://github.com/gueraf/iuv.git
Local checkout + script (also installs uv if missing):
git clone https://github.com/gueraf/iuv.git
cd iuv
./install.sh
From inside your project directory:
iuv run app.py
Or module mode:
iuv run -m package.module
Pass any additional args after the script/module:
iuv run script.py --flag value
On each relevant file change (excluding .git, .venv, __pycache__) the previous run finishes (not force killed) and the command is invoked again.
- Watches recursively from cwd
- Debounce default: 150ms (change with
--debounce 300) - Prints a short line when rerunning
- Errors just print; watcher keeps going
- Press
Enterto manually trigger a rerun.
iuv run main.py
iuv run -m mypkg.cli --help
iuv run examples/demo.py --foo bar
Press Ctrl+C once to pause. From there, you can press Enter to rerun, or Ctrl+C again to exit.