Set up your machine
Install the CLI
Install reware-lighthouse, the command-line tool that connects your machine to Lighthouse.
reware-lighthouse is a small command-line tool. It signs you in, links a checkout to its Lighthouse repository, runs the pre-commit scan, and gives your coding agent access to Lighthouse.
Requirements
| Requirement | Notes |
|---|---|
| Python 3.11 or newer | |
| Git | On Windows, the hook runs through Git for Windows. |
uv or pipx | Either installs the CLI in its own environment. |
The CLI runs on macOS, Linux, and Windows.
Install
uv tool install reware-lighthouse
uv tool update-shellupdate-shell adds uv's tool directory to your path. Open a new terminal afterwards.
Confirm it's installed:
reware-lighthouse --versionUpdate
uv tool upgrade reware-lighthouse # or: pipx upgrade reware-lighthouseWhen Lighthouse needs a newer CLI, every command says so and prints the upgrade command.
Troubleshooting
| You see | Do this |
|---|---|
command not found: reware-lighthouse | Run uv tool update-shell, then open a new terminal. Restart your coding agent too, so it picks up the new path. |
| A message asking you to upgrade | Run the update command above, then try again. |
Next: Sign in.
Still stuck after reading this page?