---
name: eridas
description: >-
  Scan and remediate npm dependency vulnerabilities and run passive live-app
  exposure recon with Erydas (OSV-backed CLI, Cloud API, SDK, MCP). Use when
  the user asks about dependency security, CVEs, MAL malware advisories,
  lockfile vulns, live URL security headers/exposure, eridas scan/fix/tinfoil,
  Cloud remediations, or wiring Erydas into CI. Deterministic JSON and exit
  codes — easy to set up, read, use, and debug.
license: MIT
metadata:
  author: Erydas
  homepage: https://erydas.vercel.app
  source: https://github.com/rcdev714/erydas
  agent-index: https://erydas.vercel.app/agents.txt
  llms-txt: https://erydas.vercel.app/llms.txt
---

# Erydas — deterministic cyber defense

Erydas scans exact installed npm versions against [OSV](https://osv.dev) (CVEs, GHSAs, and `MAL-*` supply-chain malware records), runs passive L1–L4 live-app recon (`tinfoil`), and plans the smallest verified safe update with `--ignore-scripts` and atomic rollback. The CLI, Cloud API, SDK, and MCP server are deterministic — coding agents use the same contracts as humans and CI. Optional AI may explain confirmed findings — it must never invent advisories or pick versions.

- Open-source CLI: no account required
- Cloud: GitHub App + `/api/v1` + `/api/v2` + `@eridas/cloud-sdk` + `@eridas/mcp`
- Agent index: https://erydas.vercel.app/agents.txt
- Machine docs: https://erydas.vercel.app/llms.txt
- Agents guide: https://erydas.vercel.app/agents

## Rules (always)

1. Vulnerability truth comes from OSV via Erydas. Do not invent CVEs or scrape forums.
2. Prefer non-interactive flags. Use `--dry-run` before mutating unless the user explicitly asked to apply.
3. `--force` / `--yes` skip approval prompts only — not integrity checks, `--ignore-scripts`, rollback, or major-upgrade policy. Majors need `--allow-major`.
4. Optional `--ai` explains confirmed findings only; it must not select versions.
5. Prefer opening/updating a remediation PR over pushing to the default branch.
6. Cloud GitHub-gated endpoints need the App connected; otherwise expect `github_not_connected`.

## Exit codes

| Code | Meaning           | Agent action                                    |
| ---- | ----------------- | ----------------------------------------------- |
| 0    | Clean / success   | Continue                                        |
| 1    | Findings remain   | Report findings; do not claim the tree is clean |
| 2    | Operational error | Fix lockfile/config/network; retry              |
| 3    | Approval declined | Do not retry apply without explicit user intent |

## Local CLI (no account)

```sh
npx eridas scan . --quiet --format json
npx eridas fix . --dry-run --quiet --format json
npx eridas fix . --yes
npx eridas tinfoil https://example.com --level 2 --format json
npx eridas init . --mode fix
```

JSON contracts:

- `eridas scan --format json` → `ScanResult` (`schemaVersion: 1`)
- `eridas fix --format json` → `FixResult` (`kind: "fix"`, `status`, `plan`, `scan`)
- Progress goes to stderr; use `--quiet` in CI

## Erydas Cloud (API key)

```sh
export ERIDAS_API_KEY=erd_…
export ERIDAS_API_URL=https://erydas.vercel.app

eridas auth whoami --format json
eridas cloud repos --format json
eridas cloud scan --repo-id <uuid> --wait --format json
eridas cloud findings --repo-id <uuid> --format json
# Only remediate with explicit user intent:
eridas cloud remediate --repo-id <uuid> --wait --format json
```

SDK: `import { EridasCloudClient } from "@eridas/cloud-sdk"`

MCP (Cursor / editors):

```json
{
  "mcpServers": {
    "eridas": {
      "command": "npx",
      "args": ["-y", "@eridas/mcp"],
      "env": {
        "ERIDAS_API_KEY": "erd_…",
        "ERIDAS_API_URL": "https://erydas.vercel.app"
      }
    }
  }
}
```

Local MCP tools always work. Cloud tools need `ERIDAS_API_KEY`. Remediation requires `confirm=true`.

## Safe workflow

1. Discover: `npx eridas scan . --quiet --format json`
2. Preview: `npx eridas fix . --dry-run --quiet --format json`
3. Apply only when allowed: `npx eridas fix . --yes`
4. Prove: rescan; exit `0` before claiming clean

## Links

- Docs: https://erydas.vercel.app/docs
- Security teams: https://erydas.vercel.app/for-security-teams
- Agents & MCP: https://erydas.vercel.app/agents
- Commands: https://erydas.vercel.app/commands
- Scan levels: https://erydas.vercel.app/scan-levels
- Security model: https://erydas.vercel.app/security
- GitHub: https://github.com/rcdev714/erydas
- OSV: https://osv.dev
