Skip to content
flowctl

Local Editor

Start the editor:

Terminal window
flowctl --editor :3000

Opens a YAML editor at http://localhost:3000/editor with:

  • Syntax highlighting for flowctl YAML
  • Live validation as you type
  • Flow diagrams that update automatically
  • Sample browser with example flows
  • Draft persistence in your browser

Creating from the Editor

Section titled “Creating from the Editor”

Write your YAML (or load a sample from the toolbar), fix any validation errors, and click Create to push the flow to ServiceNow.

Updating from the Editor

Section titled “Updating from the Editor”

Open an exported YAML file (with --with-uuid metadata), make changes, and click Update. The editor shows the structural diff before applying.

Connection Setup

Section titled “Connection Setup”

Click the gear icon in the nav bar to configure:

  • Instance URL (e.g., https://myco.service-now.com)
  • Auth method (OAuth2 or Basic Auth)
  • Credentials (stored in browser localStorage, never sent to the flowctl server)

Click Test Connection to verify.

Dev Mode

Section titled “Dev Mode”

For development, run with --dev to skip embedded assets and use a local dev server:

Terminal window
flowctl --serve :3000 --dev

The editor runs entirely on your machine. No data leaves your network.

The web UI and REST API are available on the hosted version at flowctl.sh.