npm · PyPI · Claude Code · Codex · Cursor
A firewall between AI coding agents and the package registries.
Agents now run npm install on their own. Attackers register the names models hallucinate and hide install instructions in README files. Ladon checks every install, explains what it found, and makes risky ones wait for you.
■ HOLD npm:color-fn-utils@1.0.2 risk 85/100 • first published 2 days ago • postinstall reads process.env and opens a network connection • not what you asked for: "make the navbar sticky" → Held. Approve or reject on your Ladon Key. The agent cannot approve this.
Four heads
In Greek myth Ladon was the sleepless dragon that guarded the golden apples of the Hesperides. Your dependency tree is the garden.
1
Gate
Intercepts every install an agent or a human attempts — through Claude Code hooks and npm / pip shims placed first on your PATH.
2
Judge
Scores the package with documented rules: does it exist, is the name hallucination-shaped, is it days old, did the maintainer change, does its install script read your environment or call the network. Then asks whether the install matches what you actually asked for.
3
Key
Risky installs wait for a human. Approve on the Ladon Key — a small device with a screen and one button that signs with its own key — or with a passkey on your phone. The agent cannot produce either signature.
4
Atlas
A public map of package names that AI models invent, and an alert when someone registers one of them.
Three verdicts
Every verdict has a shape, a word and a colour, so it reads the same in a terminal, on the Key's screen, on your phone and for people who don't see colour. The score comes from fixed rules; an AI model only writes the explanation and judges whether the install fits your task — it can raise a verdict, never lower one.
| Verdict | Score | What happens |
|---|---|---|
| ALLOW | 0–29 | Install proceeds. Logged. |
| WARN | 30–59 | Install proceeds. The reasons are shown to the agent and to you. |
| HOLD | 60–100 | Blocked until a human approves on the Ladon Key or a passkey. No approval, no install. |
Always held at 100: a package that does not exist (the agent hallucinated it) and anything with a known-malicious OSV advisory.
Use it
Package checker
Paste a name or a package.json, requirements.txt, pyproject.toml or Pipfile. No sign-up.
Hallucination Atlas
Names models invent, and which ones were registered recently.
Run the CLI
Build it from the repo, then ladon init adds the hook and shims and pairs a Key or passkey.