snow-flow
v10.0.17
Snow-Flow - ServiceNow Multi-Agent Development Framework powered by AI
3.7K/weekUpdated todayElastic-2.0Unpacked: 13.8 MB
Published by groeimetai
███████╗███╗ ██╗ ██████╗ ██╗ ██╗███████╗██╗ ██████╗ ██╗ ██╗
██╔════╝████╗ ██║██╔═══██╗██║ ██║██╔════╝██║ ██╔═══██╗██║ ██║
███████╗██╔██╗ ██║██║ ██║██║ █╗ ██║█████╗ ██║ ██║ ██║██║ █╗ ██║
╚════██║██║╚██╗██║██║ ██║██║███╗██║██╔══╝ ██║ ██║ ██║██║███╗██║
███████║██║ ╚████║╚██████╔╝╚███╔███╔╝██║ ███████╗╚██████╔╝╚███╔███╔╝
╚══════╝╚═╝ ╚═══╝ ╚═════╝ ╚══╝╚══╝ ╚═╝ ╚══════╝ ╚═════╝ ╚══╝╚══╝
Snow-Flow
The autonomous ServiceNow development agent.
---
Install
``bash`
npm i -g snow-flow@latest
More installation methods
`bash`
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
`bash`
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:
`jsonc`
{
"$schema": "https://snow-flow.dev/config.json",
"provider": {
"anthropic": {}
}
}
Why Snow-Flow?
ServiceNow-Native | Any AI Provider |
Multi-Agent | Extensible |
Supported Providers
| Anthropic | OpenAI | AWS Bedrock | |
| Claude 4.5/4.6 | GPT-5, GPT-4, o-series | Gemini 2.5 + Vertex AI | All models, cross-region |
| Azure | Mistral | Groq | + 13 more |
| OpenAI + Cognitive Services | Large, Medium, Small | Ultra-fast inference | xAI, OpenRouter, Copilot, Cohere, Perplexity, ... |
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:
| Operations — Query tables, CMDB, users, metrics | Development — Script Includes, Business Rules, Client Scripts, UI Policies |
| Deployment — Widgets, Update Sets, validation, rollback | Automation — Flow Designer, Scheduled Jobs, Approvals, Events |
| Security — ACLs, Domain Separation, compliance, scanning | Analysis — Reporting, Dashboards, KPIs, Performance Analytics |
`jsonc`
{
"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
`bash`
snow-flow # Start TUI
snow-flow serve # Headless API server (port 4096)
snow-flow web # Server + web interface
snow-flow attach
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/) |SNOW_FLOW_CONFIG
| 3 | env variable |snow-flow.jsonc
| 4 | Project config () |SNOW_FLOW_CONFIG_CONTENT
| 5 | inline |
MCP servers
`jsonc`
{
"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.
Plugins
`jsonc`
{
"plugin": ["my-snow-flow-plugin", "file://./local-plugin"]
}
Permissions
`jsonc``
{
"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.