CLI for Socket.dev — bring Socket's supply-chain security analysis to your terminal and CI.
Socket CLI is the command-line interface to Socket.dev, letting you scan dependencies, audit packages, and gate installs from your terminal or CI. This repository is the source for the published socket package on npm; end-user documentation lives on socket.dev and the socket npm page.
npm install -g socketThen run:
socket --help# Scan a package
socket package npm/express@4.18.0
# Scan your project's dependencies
socket scan create
# Audit an install before it runs
socket npm installSee the Socket docs for the full command reference.
Contributor commands
git clone https://github.com/SocketDev/socket-cli.git
cd socket-cli
pnpm install
pnpm run build
pnpm testRequires Node.js (see .node-version) and pnpm (see the packageManager field in package.json).
| Command | Description |
|---|---|
pnpm run build |
Smart build (skips unchanged) |
pnpm run build --force |
Force rebuild everything |
pnpm run build:cli |
Build CLI package only |
pnpm run build:sea |
Build SEA binaries |
pnpm dev |
Watch mode (auto-rebuild) |
pnpm test |
Run all tests |
pnpm testu |
Update test snapshots |
pnpm run check |
Lint + typecheck |
pnpm run fix |
Auto-fix lint + formatting |
Run the built CLI from source:
node packages/cli/dist/index.js --helpEnable debug logging:
SOCKET_CLI_DEBUG=1 node packages/cli/dist/index.js <command>Key development environment variables:
| Variable | Description |
|---|---|
SOCKET_CLI_DEBUG |
Enable debug logging (1) |
SOCKET_CLI_API_TOKEN |
Socket API token |
SOCKET_CLI_ORG_SLUG |
Socket organization slug |
SOCKET_CLI_API_BASE_URL |
Override API endpoint |
SOCKET_CLI_NO_API_TOKEN |
Disable default API token |
Further contributor reading:
docs/build-guide.md— build pipeline, SEA binaries, cache managementdocs/bundle-tools.md— how bundled tools (opengrep, trivy, etc.) are integratedpackages/cli/README.md— CLI package architecturepackages/build-infra/README.md— shared build toolingpackages/package-builder/README.md— template-based package generation
MIT