---
name: servicenow
description: Use the jsn CLI for ServiceNow development, administration, and data exploration.
license: MIT
metadata:
  author: jacebenson
  version: "4.3.13"
  repository: https://github.com/jacebenson/jsn
---

# ServiceNow with JSN

Discover commands with `jsn --help`, `jsn discover "search words"`, and
`jsn <command> --help`.

- Verify the intended instance and select it explicitly with `--profile <name>`.
- Prefer purpose-built or records commands over `eval`. Explain the need and get
  approval before using eval; avoid bypassing ServiceNow protections.
- Honor delete confirmations. Get approval for destructive work and Global +
  Default mutations; use `--force` only for the approved operation.

For development:

1. Choose or create the application scope and update set.
2. Do the work, keeping related changes together.
3. Verify the results on the instance and report where changes were captured.
4. Offer to run relevant existing ATFs and instance scans, or create missing checks.
5. Ask whether anything else belongs in the update set. If the user confirms
   it is finished, complete it with notes.

For incoming update sets: import the XML, preview the set, and resolve preview
errors with the human where needed. Once the preview is clear, commit the set
and verify the results.

Search documentation with `jsn docs "query"` or read with `jsn docs --path <path>`.
Documentation source and defaults for future connections are configured in `jsn setup`.