Ladon

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.

terminal — agent tried to install a package
■ 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. 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. 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. 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. 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 bands by risk score
VerdictScoreWhat happens
ALLOW0–29Install proceeds. Logged.
WARN30–59Install proceeds. The reasons are shown to the agent and to you.
HOLD60–100Blocked 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.