{
  "schemaVersion": 1,
  "methodology": "https://ionbin.com/interfaces/methodology/#evaluations",
  "evaluation": {
    "id": "neon-cli",
    "testedOn": "2026-10-18",
    "coverage": "local-runtime",
    "summary": "The official neon package reported version 8.8.0 and printed its command and option help without credentials. No Neon API call was made.",
    "identity": {
      "version": "neon 8.8.0 (npm latest at test time)",
      "target": "neon from the npm registry, run as neon",
      "integrity": "npm dist.integrity sha512-P7b7TGm/WfyOy3p85EvK0IQHOZYMSiEJrbslo3leEjtnRiuvsysUZWfuOt3W+38ZoLuogJ67QmFBcBAsjIrJdg== (registry-published package integrity; not an independent provenance audit)"
    },
    "environment": [
      "Debian Linux x86_64 (kernel 6.12); Node.js 24.18.0; npm 11.16.0; installed with --ignore-scripts into an isolated directory.",
      "Fresh HOME; environment limited to PATH plus NEON_DISABLE_ANALYTICS and CI; no NEON_API_KEY, profile or login.",
      "Observed 2026-10-19T06:29:40.903323+00:00 through 2026-10-19T06:29:41.290495+00:00 UTC."
    ],
    "checks": [
      {
        "id": "neon-cli-version",
        "name": "Installed version",
        "method": "neon --version",
        "expected": "Print the package version.",
        "observed": "Exit 0. 8.8.0",
        "outcome": "pass"
      },
      {
        "id": "neon-cli-help",
        "name": "Command and option help",
        "method": "neon --help",
        "expected": "List commands and global options without needing credentials.",
        "observed": "Exit 0. Listed command groups including projects, databases, roles, snapshots, functions, psql, diff, mcp and skills (the saved transcript keeps the last 4,000 characters of the help text); global options include --output (json, yaml, table), --profile, --api-key (default NEON_API_KEY) and --analytics (default true).",
        "outcome": "pass"
      }
    ],
    "findings": [
      {
        "title": "Analytics are on by default",
        "basis": "observed",
        "severity": "low",
        "detail": "The help output shows --analytics defaults to true.",
        "practicalAdvice": "Pass --no-analytics, or set it in CI, if you do not want usage analytics sent."
      },
      {
        "title": "Some commands write agent configuration",
        "basis": "observed",
        "severity": "informational",
        "detail": "The help lists mcp, skills and plugins commands that install Neon tooling into coding agents.",
        "practicalAdvice": "Review the files these commands write before running them on a shared machine."
      }
    ],
    "caveats": [
      "neonctl is a compatibility package for the same CLI; the documented install is npm i -g neon.",
      "Installed with --ignore-scripts."
    ],
    "notTested": [
      "Login, API-key use, project and branch operations, psql connections and schema diffs.",
      "The neon mcp, skills and plugins installers, which write agent configuration; analytics behavior with defaults on."
    ],
    "sources": [
      {
        "label": "Official CLI documentation and install",
        "url": "https://neon.com/docs/cli"
      }
    ],
    "reportUrl": "/interface-evaluations/neon-cli.json"
  }
}