HolySN Sync

Edit ServiceNow script fields in VS Code. Click the icon beside a field in your browser, the field opens here as a file, and saving the file puts the text back into the field.

VS Code never talks to ServiceNow, and your session never leaves the browser.

What you need

The HolySN browser extension in Chrome or Edge. It is the side that talks to your instance; this extension is the editor it hands the text to.

Editing a field

Open a record with a script field in ServiceNow.
Click the ⌁ icon beside the field's label.
The first time, the browser shows a four-digit code and VS Code asks: Allow a browser to edit ServiceNow scripts in VS Code? Say yes only if VS Code shows the same code.
The field opens as a file in a .holysn folder inside your workspace. With no folder open, VS Code adds a HolySN sync folder to the window instead.
Save the file, and the text goes back into the field.

Saving in VS Code does not save the record. It sets the field, and submitting the form stays yours.

The icon appears on every field that holds code: scripts, HTML, XML, JSON, CSS, conditions, and a few rarer types such as GraphQL schemas and translations.

HolySN in the status bar shows whether the bridge is running and how many browsers are connected.

Service Portal widgets

A widget opens as a folder, one file per field, side by side. In those files the shortcuts match the widget editor in the browser:

Shortcut	Does
`Alt+.`	Go to definition
`Alt+,`	Go back
`Ctrl+Q`	Rename
`Ctrl+.`	Select every occurrence
`Ctrl+I`	Show the hover

Commands

From the Command Palette, under HolySN:

Command	Does
Bridge status	Whether the bridge is running, and how many browsers are connected
Restart the bridge	Start listening again, for example after changing the port
Forget every paired browser	Revoke every approval; the next browser is asked again
Delete the synced files	Remove the files this extension wrote, except those still open in an editor
Show me the synced folder	Open the folder the files go in, in your file manager

Settings

Setting	Default	What it does
`holysn.port`	`39917`	The local port the browser connects to. Change it in the browser extension's settings too, then restart the bridge.
`holysn.keepDays`	`7`	Synced files older than this are deleted at startup. `0` keeps them.
`holysn.folder`	empty	Where synced files go. Empty means the workspace's first folder.

Privacy and security

VS Code never talks to ServiceNow. It edits text and hands it back; the browser does the write, on the session already open in that tab.
Your session token never leaves the browser. Both ends refuse any message that carries one.
Only a browser you approved gets in, and only after you have compared the code. If VS Code asks when you did not click anything, or the codes differ, say no.
An edit can only touch the field it came from. Anything else coming back is dropped.
It listens on your machine only (127.0.0.1), and a web page cannot reach it.

Help

The full guide is at holysn.com/docs. For anything else, holysn.com/support or support@holysn.com.

HolySN is an independent product, not affiliated with, endorsed by or sponsored by ServiceNow, Inc. ServiceNow is a registered trademark of ServiceNow, Inc.