███████╗███╗   ██╗ ██████╗ ██╗    ██╗███████╗██╗      ██████╗ ██╗    ██╗
██╔════╝████╗  ██║██╔═══██╗██║    ██║██╔════╝██║     ██╔═══██╗██║    ██║
███████╗██╔██╗ ██║██║   ██║██║ █╗ ██║█████╗  ██║     ██║   ██║██║ █╗ ██║
╚════██║██║╚██╗██║██║   ██║██║███╗██║██╔══╝  ██║     ██║   ██║██║███╗██║
███████║██║ ╚████║╚██████╔╝╚███╔███╔╝██║     ███████╗╚██████╔╝╚███╔███╔╝
╚══════╝╚═╝  ╚═══╝ ╚═════╝  ╚══╝╚══╝ ╚═╝     ╚══════╝ ╚═════╝  ╚══╝╚══╝

The autonomous ServiceNow development agent.

AI-powered • Multi-agent • Multi-provider • 200+ MCP tools

       

English • 简体中文 • 繁體中文 • 한국어 • Deutsch • Español • Français • Italiano • Dansk • 日本語 • Polski • Русский • العربية • Norsk • Português (Brasil)

Snow-Flow is an AI-powered, multi-agent development framework built specifically for ServiceNow. It combines a powerful terminal UI with 200+ ServiceNow MCP tools, 54 bundled domain skills, and support for 20+ AI providers to give you an autonomous coding agent that understands your ServiceNow instance.

ServiceNow-Native 200+ MCP tools and 54 domain skills purpose-built for ServiceNow development, deployment, and automation.	Any AI Provider Works with 20+ providers: Anthropic, OpenAI, Google, AWS Bedrock, Azure, Groq, and many more.	Multi-Agent Built-in build & plan agents with configurable permissions, custom agents, and subagent orchestration.
Terminal-First Beautiful TUI built with SolidJS + opentui.	MCP Ecosystem Connect any MCP server via stdio, SSE, or HTTP. Extend with the full MCP ecosystem.	Open Source Elastic License 2.0. Fully transparent. Community-driven.

Getting Started

Install

curl -fsSL https://snow-flow.dev/install | bash

More installation methods

# npm / bun / pnpm / yarn
npm i -g snow-flow@latest

# Homebrew (macOS & Linux — recommended, always up to date)
brew install groeimetai/tap/snow-flow

# Windows
scoop install snow-flow
choco install snow-flow

# Arch Linux
paru -S snow-flow-bin

[!TIP] Remove versions older than 0.1.x before installing.

Quick Start

snow-flow

On first launch, Snow-Flow prompts you to configure an AI provider. You can also pre-configure in snow-flow.jsonc:

{
  "$schema": "https://snow-flow.dev/config.json",
  "provider": {
    "anthropic": {},
    "openai": {},
  },
}

Supported AI Providers

Snow-Flow is not coupled to any single AI provider. Use whichever model works best for you.

Anthropic	OpenAI	Google	AWS Bedrock
Claude 4.5/4.6 Opus, Sonnet, Haiku	GPT-5, GPT-4, o-series reasoning	Gemini 2.5 Pro, Flash + Vertex AI	All models, cross-region support
Azure	GitHub Copilot	Mistral	Groq
OpenAI + Cognitive Services	GPT-5 via Copilot enterprise	Large, Medium, Small	Ultra-fast inference
xAI	OpenRouter	GitLab AI	+ 10 more
Grok models	100+ models, single API	Native GitLab integration	Cohere, Perplexity, DeepInfra, Cerebras, Together AI, Vercel, ...

Agents

Switch between agents with Tab:

Agent	Description
build	Default agent with full tool access for development work
plan	Read-only agent for analysis and exploration — denies edits, asks before bash
general	Subagent for complex multi-step tasks — invoke with @general

Custom agents can be configured in snow-flow.jsonc with per-agent model selection, permissions, and temperature controls. Learn more about agents.

Built-in Tools

19+ tools out of the box:

 File Operations    Shell              Web                 Dev
 ───────────────    ─────              ───                 ───
 read               bash (streaming,   webfetch            plan (enter/exit)
 write              pty support)       websearch           task management
 edit                                  codesearch          LSP (experimental)
 glob                                                      skill invocation
 grep
 ls
 apply_patch

ServiceNow MCP Integration

The core of Snow-Flow — 200+ MCP tools purpose-built for ServiceNow.

Operations Query any table CMDB search User management Operational metrics	Development Script Includes Business Rules Client Scripts UI Policies & Actions	Automation Flow Designer Scheduled Jobs Approval Workflows Event Management
Deployment Widget deploy & preview Update Set lifecycle Artifact validation Rollback support	Security ACL management Domain Separation Compliance auditing Vulnerability scanning	Analysis Reporting & Dashboards KPI management Performance Analytics Data quality checks

Connect to your instance:

{
  "mcp": {
    "servicenow": {
      "type": "local",
      "command": ["snow-flow", "mcp", "start"],
      "environment": {
        "SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com",
        "SERVICENOW_CLIENT_ID": "...",
        "SERVICENOW_CLIENT_SECRET": "...",
      },
    },
  },
}

54 Bundled Skills

Deep domain knowledge for ServiceNow development, organized by category:

Category	Skills
Development	GlideRecord patterns, Script Includes, Business Rules, Client Scripts, UI Builder
Integration	REST integration, Integration Hub, Transform Maps, Import/Export
Automation	Flow Designer, Approval Workflows, Scheduled Jobs, Change Management
Security	ACL patterns, Domain Separation, Instance Security, GRC Compliance
ITSM	Incident, Problem, Change, Request, SLA Management
Platform	CMDB, Discovery, Performance Analytics, Virtual Agent, Agent Workspace
Quality	ATF Testing, Code Review, Widget Coherence, ES5 Compliance

Extend with MCP & Plugins

MCP Servers Connect any MCP-compatible server via stdio, SSE, or streamable HTTP with OAuth support: { "mcp": { "context7": { "type": "remote", "url": "https://mcp.context7.com/mcp", }, "custom-tools": { "type": "local", "command": ["node", "./server.js"], }, }, }

Plugins Extend with npm packages or local plugins that add tools, auth providers, event hooks, and config hooks: { "plugin": ["my-snow-flow-plugin", "file://./local-plugin"], }

Headless / Server Mode

Run Snow-Flow as a headless API server for CI/CD pipelines, remote control, or web UI access:

snow-flow serve              # Start API server on port 4096
snow-flow serve --port 8080  # Custom port
snow-flow web                # Start server + open web interface
snow-flow attach http://host:4096  # Attach TUI to remote server

Permission System

Fine-grained control over what agents can do, with glob pattern matching and env file protection by default:

{
  "permission": {
    "bash": "ask",
    "write": "allow",
    "read": "allow",
    "external_directory": "deny",
  },
}

Installation directory priority

The install script respects the following priority order:

1. $SNOW_FLOW_INSTALL_DIR — Custom installation directory
2. $XDG_BIN_DIR — XDG Base Directory Specification compliant path
3. $HOME/bin — Standard user binary directory
4. $HOME/.snow-flow/bin — Default fallback

Documentation

For full configuration reference, provider setup guides, and advanced usage:

snow-flow.dev/docs

Contributing

We welcome bug fixes, new provider support, LSP/formatter additions, and documentation improvements. Read our contributing guide before submitting a pull request.

FAQ

What is Snow-Flow?

Snow-Flow is an autonomous ServiceNow development agent. It connects AI models to your ServiceNow instance through MCP tools, giving you an intelligent assistant that can develop widgets, query tables, deploy artifacts, manage update sets, and automate tasks — all from your terminal.

How is this different from other coding agents?

Snow-Flow is purpose-built for ServiceNow:

• Open source — Elastic License 2.0, fully transparent
• ServiceNow-native — 200+ MCP tools and 54 domain skills designed for ServiceNow
• Provider-agnostic — Works with 20+ AI providers, not locked to one vendor
• Built-in LSP — Language server support for intelligent code assistance
• Terminal-first — A TUI built by terminal enthusiasts with SolidJS + opentui
• Client/server architecture — Remote control, headless mode, and web UI
• Plugin ecosystem — Extend with npm packages or local plugins

Can I use my own AI provider / API key?

Yes. Snow-Flow supports 20+ providers out of the box. Configure your preferred provider in snow-flow.jsonc or through the interactive setup on first launch. You can even switch providers mid-session.

Does this work with my existing ServiceNow instance?

Yes. Snow-Flow connects to any ServiceNow instance via OAuth2 or basic authentication. Configure your instance URL and credentials in the MCP server configuration, and Snow-Flow will have access to all 200+ ServiceNow tools.

---

Disclaimer

Snow-Flow is an independent, open-source project and is not affiliated with, endorsed by, or sponsored by ServiceNow, Inc. ServiceNow is a registered trademark of ServiceNow, Inc.

This tool requires a valid ServiceNow subscription and uses your own credentials to interact with your ServiceNow instance. Some features (including Flow Designer automation) use undocumented ServiceNow APIs that may change without notice.

Licensed under Elastic License 2.0.

---

Join our community

If you are building a project that uses "snow-flow" or "snow-code" in its name, please note in your README that it is not built by or affiliated with the Snow-Flow team.