Official Documentation

NowDev Assistant v2.2.0

"The high-performance toolkit designed to reclaim the flow state for ServiceNow developers."

The NowDev Assistant is a comprehensive Chrome browser extension tailored for the modern ServiceNow professional. It enables rapid GlideRecord and GlideAggregate query creation, high-fidelity form inspection, incremental cross-table search, and recursive record previews—all integrated directly into your ServiceNow instances without page reloads.

✨ What's New in the Venus Release (v2.2.0)

Our latest update focuses on deep discovery and context preservation. Here are the major highlights:

  • Unified Search: Code, sys_id, and Record # in one hub.
  • Contextual Preview: Peek into records via overlays.
  • Sidebar Position: Dock to Left or Right side.
  • Smart Prefix: Search any record type instantly.

🚀 Getting Started

NowDev Assistant is designed to be as unobtrusive as possible. It lives on the edge of your screen, ready whenever you need it.

1. Opening the Assistant

Once installed, you will see a small floating NowDev toggle on the right side of any *.service-now.com page. Simply click this button to slide the sidebar into view.

Pro Tip: You can customize whether the panel docks to the Left or Right in the Settings tab.

2. Understanding the Workspace

The Assistant is organized into several functional modules accessible via the navigation rail:

  • ⚡
    Code Generator: Your primary workspace for creating GlideRecord queries using natural language.
  • 🔍
    Search Center: The global hub for finding scripts, identifying sys_ids, and jumping to record numbers.
  • 🕵️
    Form Center: Context-aware tools that automatically load when you are viewing a specific record.

🏗️ Core Architecture

The architecture of v2 represents a complete ground-up rebuild focused on performance and total platform isolation.

Shadow DOM Isolation

NowDev mounts its entire UI inside a Shadow Root. This ensures that the extension's CSS never conflicts with ServiceNow's global styles (and vice-versa), providing a consistent UI regardless of platform versions.

Native Push Layout

Unlike other extensions that cover your work, NowDev Assistant uses a Native Push Layout. When the sidebar opens, it dynamically resizes the page body, "pushing" the ServiceNow workspace so everything remains visible.

🔍 Unified Search Center

The Search Center is a new top-level hub designed for high-speed navigation. It eliminates the need to open multiple tabs or rely on the slow global navigator.

1. Incremental Code Search

Find logic across Business Rules, Client Scripts, Script Includes, UI Actions, and more. Results are displayed incrementally as they are found.

Search query example: "current.update"
  • Smart Snippets: Automatically extracts the relevant lines of code surrounding your keyword.
  • Collapsible Groups: Results are organized by class with sticky headers for better context during scrolling.

2. Global sys_id Search

Paste any 32-character sys_id to identify it instantly. NowDev performs a deep incremental scan across 30+ platform tables including Metadata, Task, CMDB, User, and Audit logs.

3. Dynamic Record Lookup

Search directly by number (e.g., INC0010001). NowDev uses Dynamic Prefix Resolution to query Number Maintenance (sys_number), ensuring support for custom table prefixes.

🕵️ The Form Center

When you open a record in ServiceNow, the Form Center automatically detects the context and loads a suite of debugging and inspection tools.

1. Explorer (The Data Spy)

The Explorer is designed for total visibility. It fetches every field on the record, including those hidden by UI Policies or ACLs.

  • View internal column names & labels
  • Analyze technical types (Reference, Choice, etc)
  • Inspect raw database values vs display values
  • Filter for Null or Not-Null fields

2. Logic Explorer

Instantly discover every configuration governing the current form. It even pulls inherited logic from parent tables (e.g., viewing task logic while on an incident).

3. Ajax Tracker

A real-time monitor for background traffic. Every GlideAjax call made by the form is intercepted, revealing the exact payload and server response without needing to open logs.

4. Executor

A live JavaScript scratchpad with full access to the page's globals (g_form, g_user, GlideAjax). Test your logic instantly in the live context.

🖼️ Contextual Record Preview

The "Peek" feature you've always wanted. Inspect any record in a sidebar overlay without navigating away from your current workspace.

Platform-Accurate UI

Unlike the Explorer, the Preview intelligently mirrors the native ServiceNow experience. It respects the "Default view" field order and displays proper section headers.

Recursive Drill-down

Click the Preview icon on any reference field within the sidebar to open a new preview overlay. Use the Back button to navigate through your investigation history.

Encrypted Data Safety

To maintain platform security, the preview automatically identifies and masks all encrypted field types (masked, password, digest). These fields never show the original value.

📦 App Navigator

A dedicated browser for your scoped applications. It replaces the slow global navigator with a focused view of your current work context.

  • Searchable Apps: Find any scoped app instantly.
  • Metadata Tree: Browse application files grouped by class.
  • Integrated Flow: Click to open files directly in the main iframe.

🌐 Environment Switcher

Manage multiple ServiceNow instances safely and jump between environments with one click.

Visual Guardrails

Configure color-coded borders for different environments (e.g., Red for Production) to prevent accidental data modifications.

Contextual Switching

Open the exact record you are currently viewing in a different environment node (e.g., jump from Prod to Dev for debugging) with a single click.

⚡ Quick Switcher

"Switch nodes, not tabs."

The Quick Switcher is a floating shortcut designed for ultra-fast transitions. It appears as a small icon when the sidebar is closed, allowing you to jump between Dev, Test, and Prod nodes instantly while staying context-aware.

📃 List Helper

Extract data and generate logic directly from any ServiceNow list view.

  • ✓
    List-to-Glide Generator: Convert your active list filters (Breadcrumbs) into a ready-to-use GlideRecord query script with one click.
  • ✓
    Column Extraction: Select any visible column to instantly pull all values into a copyable list.

⌨️ Code Generator Syntax

Write GlideRecord queries using intuitive natural language. The core engine translates your thoughts into production-ready scripts.

<gr|ga> [operation] <table> [clauses]

Command Structure

  • gr: Standard GlideRecord operation.
  • ga: GlideAggregate operation for counting and grouping.
  • [operation]: Defaults to query. Also supports insert, update, delete.
  • <table>: The internal name of the table (e.g., incident, sys_user).

Supported Operations

1. Query Records 

gr incident where active=true, priority=1

2. Update Records 

gr update incident set state=2 where priority=1

3. Insert Records 

gr insert incident set short_description=test, priority=2

Natural Date Shortcuts

Keyword ServiceNow Equivalent
today gs.beginningOfToday()
yesterday gs.beginningOfYesterday()
last_week gs.beginningOfLastWeek()
this_month gs.beginningOfThisMonth()

Special Logic Keywords

  • me: Resolves to current user (gs.getUserID()).
  • null: Maps to addNullQuery().
  • active: Maps to addActiveQuery().

Advanced Code Examples

Aggregate Data (ga) 

ga incident where active=true group by priority aggregate count

Join Queries 

gr task where active=true join incident on task_id=sys_id

⚙️ Settings & Feedback

Personalize your development experience via the dedicated Settings tab at the bottom of the navigation rail.

Sidebar Positioning

Dock the Assistant to either the Left or Right side. The UI dynamically flips to maintain a natural ergonomic flow.

Community Feedback

We build for the community. Use the Feedback tab to report bugs or suggest a new feature.

🔐 Security & Privacy

NowDev Assistant is built with a "Privacy First" philosophy. All processing happens locally in your browser using your active ServiceNow session.

  • 🛡️ Shadow DOM Isolation: Your ServiceNow UI and NowDev styles remain completely separate.
  • 🔒 Encrypted Data Safety: Masked and password fields are never requested or displayed in previews.
  • ☁️ 100% Local: No external API calls are made for core processing or GlideRecord generation.

❓ Troubleshooting

Issue Solution
Clipboard blocked Ensure browser permissions for clipboard access are enabled for the extension.
Form Center not loading Refresh the page. Ensure you are on a standard .do page with a valid Sys ID.
Search not responding Incremental search yields to the browser. If the instance is very large, allow a few seconds for the scan.