Agent-first, agent-native

A CLI for exploring and managing ServiceNow instances.
Works standalone or with any AI agent.

npm install -g @jacebenson/jsn

Cross-platform · Works on Windows, macOS, Linux · Requires Node.js

Requirements

Node.js required — that is the only runtime dependency
Install: npm install -g @jacebenson/jsn — works on Windows, macOS, Linux
AI Agents: jsn skill install after setup

Don't have Node.js?

Install Node.js and npm from the official site:
nodejs.org

Or use a version manager:
brew install node (macOS) · sudo apt install nodejs npm (Ubuntu/Debian) · nvm (all platforms)

⏎ What it looks like

$ jsn setup

→ JSN Setup

Instance URL: https://dev12345.service-now.com
Profile: dev
Authentication: OAuth 2.0 (browser)
✓ Authenticated as admin

$ jsn records --table change_request

Select a record from change_request:

> CHG0000077 - A failed RAID controller card needs to be replaced
CHG0000067 - A failed RAID controller card needs to be replaced
CHG0040005 - Add network switch to cabinet
CHG0000011 - Another Java Application Server change
CHG0000009 - Apply patches 10.2.0.1 to 10.2.0.3

↑/↓ navigate • enter select • /search • a-z jump

$ jsn rules --table incident

Select a rule to view:

> Abort changes on group - incident - before
Add info messages for incident closure - incident - after
Auto assessment business rule - incident - async
Caller Close - incident - before
Cascade closure of Incident Tasks - incident - after

1-5 of 20 loaded (20 total)

$ jsn flows

Flow: Change - Cloud Infrastructure - Authorize

Status: Active | Version: Unset (Assumed V1)

▶ TRIGGER
──────────────────────────────────────
Created or Updated

⚡ FLOW STRUCTURE
──────────────────────────────────────
1. Apply Change Approval Policy
2. Wait For Condition
3. Do the following in Parallel
4. If → Update Record
5. Else → Update Record
6. Evaluate Change Model

Quick Setup

Requires Node.js and npm. One command, no ServiceNow plugins, no build step, no config file to wrestle.

                    npm install -g @jacebenson/jsn

                    jsn setup # Interactive first-time setup

                    jsn incidents # Start using

Agent-Native

Designed for AI agents. JSON output, breadcrumbs, and machine-readable structure. Works with Claude, Codex, Cursor, and more.

                    jsn dev tables --json # Structured JSON output

                    jsn incidents list -q # Quiet mode, no prompts

Explore Your Instance

Understand your ServiceNow instance without clicking through 12 UI screens. Incidents, changes, requests, tables, business rules, flows, and more.

                    jsn incidents list --query "priority=1" # Critical incidents

                    jsn dev rules --table incident # Business rules

                    jsn dev tables incident # Table schema

AI Agent Skills

Built-in skill file for AI agents. Run jsn skill install and your agent automatically gains expert-level ServiceNow knowledge.

                    jsn skill install # Install to Hermes skills

                    jsn skill show # Preview the skill content

Quick Setup for AI Agents

1. Install CLI

                    npm install -g @jacebenson/jsn # Requires Node.js

                    jsn --version # Verify: jsn 0.1.0

2. Authenticate

                    jsn setup # Interactive setup

                    jsn auth status # Verify: Authenticated

3. Install Skill

                    jsn skill install # Installs to ~/.hermes/skills/servicenow/

                    jsn skill show # Verify: displays skill content

4. Start Using

                    # Restart your agent to load the skill

                    # Then just ask naturally about ServiceNow:

                    # "Show me my incidents" or "List business rules on incident"

                    # The agent automatically invokes jsn commands for you

View full skill documentation →