How to: Install the exact version if the setup script didn't already
pip install pre-commit==4.2.0
pre-commit install
pre-commit run --all-files   # verify hooks after setup
pre-commit run --files
# before each commit
```
Run `pre-commit run --all-files` once after the setup script to confirm
everything is formatted correctly. These commands mirror the steps in
[AGENTS.md](AGENTS.md) and keep commits consistent.
After editing `.github/workflows/ci.yml`, run:

```bash
pre-commit run --files .github/workflows/ci.yml
python tools/update_actions.py
```
to validate the workflow with actionlint before committing.
Before opening a pull request, run `pre-commit run --all-files` to ensure
all hooks succeed.
Run `python check_env.py --auto-install` before invoking these commands so
optional hook dependencies are installed. When working offline, pass
`--wheelhouse
` or set `WHEELHOUSE` to install from a local cache. If
`pre-commit` isn't found or the version differs, install it with
`pip install pre-commit==4.2.0`.

When editing the web UI, preserve existing ARIA labels so the interface
remains accessible.