Install

npm i -g snow-flow@latest

bun i -g snow-flow@latest                              # Bun
pnpm i -g snow-flow@latest                             # pnpm
yarn global add snow-flow@latest                       # Yarn
curl -fsSL https://snow-flow.dev/install | bash            # Install script
brew install groeimetai/tap/snow-flow                      # macOS / Linux
scoop install snow-flow                                    # Windows

Quick Start

snow-flow

That's it. Snow-Flow will prompt you to configure an AI provider on first launch.

Or pre-configure in snow-flow.jsonc:

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

Why Snow-Flow?

ServiceNow-Native 200+ MCP tools and 54 domain skills built for ServiceNow development, deployment, and automation.

Any AI Provider 20+ providers: Anthropic, OpenAI, Google, AWS Bedrock, Azure, Groq, xAI, OpenRouter, and more.

Multi-Agent Built-in build & plan agents. Custom agents with per-agent models, permissions, and temperature.

Extensible MCP ecosystem support (stdio, SSE, HTTP). Plugin system via npm or local packages.

Supported Providers

Built-in Tools

 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 Tools

Connect to your ServiceNow instance and access 200+ tools:

{
  "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": "..."
      }
    }
  }
}

Agents

| Agent | Description | |:------|:------------| | build | Full access agent for development work | | plan | Read-only agent for analysis — denies edits, asks before bash | | general | Subagent for complex multi-step tasks (@general) |

CLI

snow-flow                        # Start TUI
snow-flow serve                  # Headless API server (port 4096)
snow-flow web                    # Server + web interface
snow-flow attach <url>           # Attach to remote server
snow-flow auth                   # Configure authentication
snow-flow models                 # List available models
snow-flow stats                  # Usage statistics
snow-flow export                 # Export session data
snow-flow pr                     # Pull request automation

Configuration

Config is loaded from (in priority order):

| Priority | Source | |:---------|:-------| | 1 | Remote/well-known organization configs | | 2 | Global config (~/.snow-flow/) | | 3 | SNOW_FLOW_CONFIG env variable | | 4 | Project config (snow-flow.jsonc) | | 5 | SNOW_FLOW_CONFIG_CONTENT inline |

{
  "mcp": {
    "my-server": { "type": "local", "command": ["node", "./server.js"] },
    "remote":    { "type": "remote", "url": "https://example.com/mcp" }
  }
}

Supports stdio, SSE, and streamable HTTP with OAuth.

{
  "plugin": ["my-snow-flow-plugin", "file://./local-plugin"]
}

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

Glob patterns, per-agent rulesets, and env file protection included.

Links

• Documentation — Full configuration reference and guides
• GitHub — Source code and issues
• Contributing — How to contribute

License

MIT — see LICENSE.