Quickstart

From zero to verified package in 60 seconds.

Get a free key, ask Nipcode a question, read the verdict, approve the install yourself.

1. Get a key

Open nipcode.xyz, enter your email, paste the 6-digit code from the sign-in email. Your account dashboard opens at /account and your primary key appears under API keys.

The key looks like nip_094cda2070725db12cbf6e8b2d61ef39. Treat it like a password.

2. Ask for a recommendation

KEY=nip_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
curl -H "x-nipcode-api-key: $KEY" \
  "https://nipcode.xyz/api/decision?q=fast%20xml%20parser&sources=npm&limit=3"

The response includes a best object with a one-line recommendation, decision and trust scores (0-100), a risk level, and an install_boundary with the exact command you would run.

3. Inspect or check a known package

curl -H "x-nipcode-api-key: $KEY" \
  "https://nipcode.xyz/api/inspect?source=npm&name=undici"

curl -H "x-nipcode-api-key: $KEY" \
  "https://nipcode.xyz/api/install-plan?source=npm&name=undici&version=8.3.0"

Inspect refreshes one record with full trust factors. Install-plan returns just the command and approval boundary for when an agent has already chosen.

4. Approve the install yourself

Nipcode never installs anything. Read the install_boundary.command, decide if you trust it, run it locally.

If you are wiring an AI agent, see Agents.

API reference

Full parameter list, response shapes, error codes.

Agents

Wire Nipcode into Claude / Cursor / autogen.