Introduction
What Lighthouse does and where to start.
Lighthouse gives AI coding agents the security rules of your repository before they write code, then checks the code they produce. It works with Claude Code and Codex, on repositories hosted on GitHub.
How it works
Lighthouse does three things, in this order:
- Learns your repository. An ingestion reads a branch and writes down its security rules as security cards. For example: "Every handler under
app/routes/admin/must callrequire_adminfirst." - Briefs your agent. When you start a request with
/lighthouse-enhance, Lighthouse adds the cards that apply to that request. This is prompt enhancement. - Checks the result. A pre-commit scan reviews your staged changes on every commit. A pull request scan reviews every pull request on GitHub. Problems are reported as findings, and your team decides which ones block a commit or a merge.
repository ── ingestion ──→ security cards
request ── enhance ──→ request + relevant cards ──→ agent
change ── scan ──→ findings ──→ allowed or blockedEvery run is recorded in the dashboard at lighthouse.rewarelabs.com, so you can see what was scanned, what was found, and what guidance each agent received.
Start here
Setup has two parts. An admin sets up the team once. Then each developer sets up their own machine.
Set up your team
For admins. Connect GitHub, add repositories, invite people, and issue API keys.
Set up your machine
For developers. Install the CLI and link a repository. Your next commit is scanned.
Learn the terms
Projects, security cards, findings, blocking policy, and credits, explained in a few minutes.
Fix a problem
Look up the exact message you're seeing and what to do about it.
Requirements
| For | You need |
|---|---|
| Your team | An invitation from RewareLabs. Lighthouse is invite-only during the pilot. |
| Your code | Repositories on GitHub. |
| Each developer | Python 3.11 or newer, Git, and Claude Code or Codex on macOS, Linux, or Windows. |
Keep your other checks
Lighthouse adds a security review to every change. It doesn't replace code review or your existing security testing.