snow-cli

A portable CLI for ServiceNow. Query tables, inspect schemas, edit and search script fields, bulk-update records, manage users and groups, handle attachments, promote update sets across environments, browse the Service Catalog, inspect Flow Designer flows, manage scoped applications, tail and AI-analyse system logs, analyse user access across every security layer, translate queries and diagnose errors with AI, and generate complete applications — all from your terminal.

Commands at a glance

Command	Description
`snow instance`	Add and switch ServiceNow instance connections
`snow table`	Query, create, update, and delete records
`snow schema`	Inspect field definitions and generate schema diagrams
`snow script`	Pull, edit, push, search, and replace script fields
`snow bulk`	Bulk-update records matching a query
`snow user`	Manage group membership and role assignments
`snow attachment`	Download and upload record attachments
`snow updateset`	List, export, import, diff, and AI-explain update sets
`snow run`	Execute a server-side script on the instance
`snow sys`	Read and write system properties
`snow approval`	List, approve, and reject approval requests
`snow watch`	Poll a record and print field changes in real time
`snow acl`	Inspect Access Control rules for a table
`snow import`	Import records from a JSON or CSV file
`snow status`	Dashboard health and stats overview
`snow diff`	Compare schema and scripts between instances
`snow security`	Analyse user access across all security layers with AI
`snow factory`	AI-orchestrated multi-component application pipeline
`snow catalog`	Browse the Service Catalog
`snow flow`	Inspect Flow Designer flows and actions
`snow app`	List and inspect scoped applications
`snow log`	Tail system, app, and transaction logs
`snow log analyze`	AI pattern analysis of recent log errors
`snow provider`	Configure LLM providers for AI commands
`snow ai`	Generate ServiceNow artifacts from natural language
`snow ai explain`	Ask the LLM to explain any table or record in plain English
`snow ai query`	Translate natural language into an encoded query string
`snow ai translate`	Translate an encoded query string into plain English
`snow ai fix`	Diagnose a ServiceNow error and get a fix
`snow updateset explain`	AI pre-promotion review of an update set
`snow ai audit`	AI code review of a script record
`snow ai impact`	Blast radius analysis for table or field changes
`snow ai document`	Generate markdown docs for a scoped application
`snow ai onboard`	Role configuration analysis and assignment for new users
`snow ai debug`	Gather all scripts firing on a record and diagnose unexpected behavior with AI

Installation

From npm:

npm install -g snow-cli

From source:

git clone https://github.com/tuckerman/snow-cli
cd snow-cli
npm install
npm run build
npm link

Requires Node.js 18+.

Quick start

# 1. Add a ServiceNow instance
snow instance add

# 2. Query a table
snow table get incident -q "active=true" -l 10 -f "number,short_description,state,assigned_to"

# 3. Pull a script, edit it locally, and push it back
snow script pull sys_script_include <sys_id> script

# 4. Configure an AI provider and generate a feature
snow provider set openai
snow ai build "Create a script include that auto-routes incidents by category and urgency"

# 5. Run the full factory pipeline
snow factory "Build a hardware asset request app with approval workflow" --envs test,prod

Continue to Getting Started for a full walkthrough.