SafeDep CLI

safedep is SafeDep Cloud on the command line. Manage auth, query endpoint telemetry, harden AI coding agents, and integrate with your security toolchain. Built for humans and the agents they work with.

TL;DR

npx @safedep/cli setup mcp install

One command authenticates you with SafeDep Cloud, detects your AI coding agents (Claude Code, Cursor, Gemini CLI, and more), and injects MCP-based threat protection into each one.

Install

Homebrew (macOS and Linux):

brew install safedep/tap/cli

Other installation options

npm:

npm install -g @safedep/cli

pnpm:

pnpm add -g @safedep/cli

Bun:

bun add -g @safedep/cli

Download prebuilt binaries for Linux, macOS, and Windows from the GitHub Releases page.

Get started

# Authenticate with SafeDep Cloud
safedep auth login

# Check your endpoint fleet
safedep endpoint status

# Query your security telemetry
safedep query exec --sql "select name, version from packages limit 10"

# Protect your AI coding agents
safedep setup mcp install

What safedep can do

Authentication and profiles: safedep auth Log in to SafeDep Cloud, manage credential profiles, and switch between tenants.

Endpoint fleet intelligence: safedep endpoint Monitor the health of every endpoint reporting to your tenant, list active machines, and drill into package inventory and recent activity.

Security telemetry queries: safedep query Run SQL against SafeDep Cloud's query service. Inspect packages, events, and findings across your entire fleet.

On-demand package scanning: safedep package scan Submit a package version (OSS library, editor extension, and more) for malware scanning via SafeDep Cloud, then track the verdict and read the full report.

Subscription and plan: safedep subscription Check your plan status, start a free trial, subscribe, and manage on-demand (usage-based) billing. Low-level billing is handled in the hosted portal.

AI agent protection: safedep protect mcp Inject or remove the SafeDep MCP server from detected AI coding agents. Supports Claude Code, Cursor, Gemini CLI, and more.

Integrations: safedep integration Push SafeDep malware findings to external security tools. JFrog XRay is supported.

Learn more

• Documentation: guides, concepts, and API reference
• SafeDep Cloud: the platform behind the CLI
• GitHub Issues: bug reports and feature requests

Full command reference

Command	Description
safedep auth login	Authenticate with SafeDep Cloud
safedep auth logout	Remove credentials for the active profile
safedep auth status	Show authentication status
safedep auth profile list	List credential profiles
safedep endpoint status	Show fleet health
safedep endpoint list	List endpoints with filters
safedep endpoint show	Show endpoint detail
safedep endpoint activity list	List recent endpoint activity
safedep endpoint inventory list	List current endpoint inventory
safedep query exec	Execute a SQL query against SafeDep Cloud
safedep query schema list	List tables in the query schema
safedep query schema show	Show one table from the query schema
safedep query schema get	Get the full schema in one call (for AI agents and scripts)
safedep package scan run	Submit a package for on-demand scanning
safedep package scan get	Get the status and verdict of a scan
safedep package scan list	List package scans
safedep package scan show	Show the full report of a completed scan
safedep subscription status	Show subscription status
safedep subscription trial enable	Activate the free trial
safedep subscription create	Subscribe to the Professional plan
safedep subscription ondemand enable	Enable on-demand (overage) billing
safedep subscription ondemand disable	Disable on-demand (overage) billing
safedep subscription ondemand status	Show on-demand billing state
safedep subscription customer create	Create the billing customer profile
safedep subscription customer show	Show the billing customer profile
safedep subscription portal open	Open the billing portal
safedep protect mcp status	Show SafeDep MCP integration status for detected AI agents
safedep protect mcp install	Inject SafeDep MCP server config into detected AI agents
safedep protect mcp uninstall	Remove SafeDep MCP server config from detected AI agents
safedep integration jfrog run	Push SafeDep malware findings to JFrog XRay
safedep setup mcp install	Guided onboarding: authenticate and configure AI agents
safedep version	Print CLI version