GoAudit is a sandbox security scanner for CLI commands.

It inspects install commands and project upgrades for suspicious file reads, writes, process execution, and network behavior.

Install

go install github.com/KushalMeghani1644/GoAudit-CLI/cmd/goaudit@latest

Usage

Scan a command

goaudit scan "npm install lodash"
goaudit scan "pnpm add <package>"
goaudit scan "bun add <package>"
goaudit scan "pip install <package>"
goaudit scan "curl -fsSL https://example.com/install.sh | sh"
goaudit scan "npm install <package>" --ci
goaudit scan "npm install <package>" --verbose
goaudit scan "npm install <package>" --offline
goaudit scan "npm install <package>" --allow-domain example.com --max-remote-depth 1
goaudit scan "npm install <package>" --network off
goaudit scan "npm install <package>" --run-as-root
goaudit scan "npm install <package>" --skip-probe
goaudit scan "npm install <package>" --warm-cache
goaudit scan "npm install <package>" --no-cache

Scan a project

scan-project audits an existing JavaScript project before you upgrade dependencies. It reads package.json, detects npm/pnpm/bun, checks dependencies against the npm registry, and then runs the upgrade install inside a sandbox. Your host node_modules is not modified.

goaudit scan-project ~/mywebsite
goaudit scan-project ~/mywebsite --upgrade-mode ncu
goaudit scan-project ~/monorepo --upgrade-mode update --ci
goaudit scan-project ~/app --manager pnpm
goaudit scan-project ~/app --include-transitive
goaudit scan-project ~/app --probe-all
goaudit scan-project ~/app --skip-probe
goaudit scan-project ~/app --warm-cache

Upgrade modes:

ModeBehavior
refresh-lockRemove lockfile and reinstall
ncuRun npm-check-updates, then install (bun uses bun update)
updateRun the package manager's update command

Supported project package managers: scan-project supports npm, pnpm, and bun. Yarn projects (yarn.lock) have no scan-project profile, but you can audit an explicit Yarn command with goaudit scan yarn install. Switch to npm, pnpm, or bun only when you need scan-project.

Runtime probe

After install, GoAudit optionally loads each package entrypoint (require / dynamic import) and runs package CLI bin entries with --help under strace. It does not exercise delayed timers, workers, interactive prompts, or arbitrary exported APIs. Use --skip-probe to disable.

Project staging

scan-project stages install inputs (manifests/lockfiles) into the sandbox by default so install scripts cannot read host secrets via /project-ro. Pass --mount-project for a full-tree stage with known secret paths redacted. Multi-local scan installs refuse mounting the working directory unless --mount-cwd is set.

Cache

GoAudit caches prepared sandbox containers to speed up repeat scans.

goaudit cache status
goaudit cache clean
goaudit cache clean --runtime runsc
goaudit cache clean --runtime runc

Use --cache-dir or GOAUDIT_CACHE_DIR to store cache entries elsewhere.

Requirements

  • Docker
  • gVisor (recommended)

gVisor (runsc) on Fedora / SELinux

GoAudit uses gVisor when Docker lists runsc in docker info runtimes. Installing the runsc binary is not enough; it must be registered with Docker:

{
  "runtimes": {
    "runsc": {
      "path": "/usr/local/bin/runsc",
      "runtimeArgs": ["--debug=false", "--platform=ptrace"]
    }
  },
  "default-runtime": "runc"
}

Use runsc help platform to see valid --platform values.

Restart Docker: sudo systemctl restart docker, then verify:

docker info | rg -i runtimes

SELinux: gVisor cannot use Docker’s default container SELinux labels. GoAudit sets --security-opt label=disable automatically for runsc containers.

Node sandbox image: when gVisor is available and you keep the default --node-image, GoAudit uses ghcr.io/kushalmeghani1644/goaudit-node-sandbox:latest for Node-based scans.

Fallbacks: if gVisor is unavailable, or image preparation fails, GoAudit falls back to runc and prints a warning.

Notes

  • scan supports npm, pnpm, bun, pip, and curl | sh style commands.
  • scan-project supports npm, pnpm, and bun only.
  • --ci emits JSON output.
  • --verbose shows live findings during a scan.
  • --warm-cache prepares the sandbox without running a scan.

Important Note

GoAudit is not meant for proving absolute maliciousness, it just provides a risk assessment based on behavior and static indicators.