netskope 0.2.1

The official Netskope CLI — manage your Netskope tenant from the command line

Netskope CLI

The official command-line interface for the Netskope platform. Manage your tenant, query events, investigate alerts, configure policies, and more — all from your terminal.

Available as both netskope and the shorter alias nsk.

---

Installation

pip (all platforms)

pip install netskope

pipx (recommended — isolated install)

pipx installs the CLI in its own virtual environment so it won't conflict with other Python packages.

# Install pipx if you don't have it
# macOS
brew install pipx && pipx ensurepath

# Linux
python3 -m pip install --user pipx && pipx ensurepath

# Windows
py -m pip install --user pipx && pipx ensurepath

# Then install Netskope CLI
pipx install netskope

Homebrew (macOS / Linux)

brew install netskope

Note: The Homebrew formula may lag behind the latest PyPI release.

Windows

# Using pip (requires Python 3.11+)
py -m pip install netskope

# Or using pipx
py -m pipx install netskope

From source

git clone https://github.com/netSkopeoss/netksope-cli.git
cd netksope-cli
pip install .

Verify installation

netskope --version
nsk --help

---

Quick Start

1. Configure your tenant

netskope config set-tenant mytenant.goskope.com

2. Authenticate

Option A — API token:

export NETSKOPE_API_TOKEN="your-token"

Option B — Browser SSO login:

netskope auth login

3. Start using the CLI

# Check tenant connectivity and status
nsk status

# List recent alerts
nsk alerts list --limit 10

# Search events
nsk events list --query 'alert_type eq "DLP"' --limit 20

# List users
nsk users list

# Export incidents as CSV
nsk incidents list -o csv > incidents.csv

# View policies
nsk policy list -o table

---

Output Formats

Every command supports multiple output formats via the -o / --output flag:

Format	Flag	Description
Table	-o table	Human-friendly table (default in TTY)
JSON	-o json	Pretty-printed JSON
JSONL	-o jsonl	One JSON object per line
CSV	-o csv	Comma-separated values
YAML	-o yaml	YAML output

# Pipe JSON output to jq
nsk alerts list -o json | jq '.[] | .alert_name'

# Export users to CSV
nsk users list -o csv > users.csv

---

Commands

Category	Commands
Events	events list
Alerts	alerts list
Incidents	incidents list, incidents show
Users	users list
Policy	policy list
Devices	devices list
Status	status
Auth	auth login, auth logout, auth status
Config	config set-tenant, config show
Publishers	publishers list
Steering	steering list
IPSec	ipsec list
Services	services list
DNS	dns list
Docs	docs

Run nsk --help or nsk <command> --help for full details.

---

Environment Variables

Variable	Description
NETSKOPE_API_TOKEN	API v2 token for authentication
NETSKOPE_TENANT	Tenant hostname (overrides config file)
NETSKOPE_PROFILE	Configuration profile to use

# Check which values are active and their sources
netskope config show

---

Shell Completion

# Bash
netskope --install-completion bash

# Zsh
netskope --install-completion zsh

# Fish
netskope --install-completion fish

# PowerShell
netskope --install-completion powershell

---

Requirements

• Python 3.11 or later
• A Netskope tenant with API access

---

License

MIT