cli

module
v1.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 15, 2026 License: Apache-2.0

README

Escape CLI

The official CLI for Escape — an AI-powered offensive security platform for APIs and web applications.

Two main use cases:

  • Security scanning — trigger scans, manage vulnerabilities, and integrate Escape into CI/CD pipelines
  • Private Location — run a self-hosted tunnel to reach APIs inside private networks

Full documentation: docs.escape.tech/documentation/tooling/cli

Installation

Binary (Linux, macOS, Windows): download from GitHub Releases.

Docker:

docker pull escapetech/cli:latest

Helm (for Private Location on Kubernetes):

helm install escape-location ./helm \
  --set ESCAPE_API_KEY=<your-api-key> \
  --set ESCAPE_PRIVATE_LOCATION=<location-name>

Authentication

export ESCAPE_API_KEY=your_api_key_here

Quick Start

# Start a scan and wait for results
escape-cli scans start <profile-id> --watch

# Review discovered issues
escape-cli issues list --severity CRITICAL,HIGH --status OPEN

Private Location

Private Location is a self-hosted tunnel that lets Escape reach APIs that are not publicly accessible — behind firewalls, in private VPCs, or in Kubernetes clusters.

# Start a Private Location
escape-cli locations start <location-name>

For Kubernetes, use the provided Helm chart. See helm/values.yaml for configuration options including existing secrets and K8s integration.

GitHub Actions

- name: Escape scan
  uses: Escape-Technologies/cli@v1
  with:
    profile_id: ${{ secrets.ESCAPE_PROFILE_ID }}
    api_key: ${{ secrets.ESCAPE_API_KEY }}
    watch: 'true'

Optional inputs: schema (path or URL to update the API schema before the scan), configuration_override (partial JSON config).

Commands

scans       Run and manage security scans
issues      Manage and track security vulnerabilities
problems    View scan problems and failures
profiles    Configure security testing profiles
assets      Manage your API inventory
locations   Manage Private Locations
custom-rules Manage custom security rules
tags        Organize resources with tags
upload      Upload schema files (OpenAPI, GraphQL, Postman)
audit       View audit logs
version     Display CLI version

Global flags: -o pretty|json|yaml|schema, -v/-vv/-vvv, and --input-schema.

Directories

Path Synopsis
Package main is the entry point for the CLI
Package main is the entry point for the CLI
pkg
api/escape
Package escape provides the API client for the Escape Platform
Package escape provides the API client for the Escape Platform
cli
Package cli run the cli
Package cli run the cli
cli/cmd
Package cmd implements the CLI commands
Package cmd implements the CLI commands
cli/out
Package out provides the output formatting for the CLI
Package out provides the output formatting for the CLI
cli/schema
Package schema provides JSON Schema generation for CLI output types
Package schema provides JSON Schema generation for CLI output types
env
Package env provides environment variables parsing and utils builders
Package env provides environment variables parsing and utils builders
locations
Package locations provides the location start implementation
Package locations provides the location start implementation
locations/dns
Package dns provides the DNS integration for private locations
Package dns provides the DNS integration for private locations
locations/health
Package health implements the health check server
Package health implements the health check server
locations/kube
Package kube provides the kubernetes integration for private locations
Package kube provides the kubernetes integration for private locations
locations/private
Package private provides the private location tunnel implementation
Package private provides the private location tunnel implementation
locations/private/monitor
Package monitor provides a way to monitor the private location on the Escape Platform
Package monitor provides a way to monitor the private location on the Escape Platform
locations/ssh
Package ssh provides SSH key generation
Package ssh provides SSH key generation
log
Package log provides logging implementation with hooks to send logs to Escape Platform
Package log provides logging implementation with hooks to send logs to Escape Platform
version
Package version contains the version information for the CLI
Package version contains the version information for the CLI

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL