AI Skills

<pre align="center"> ███████╗███████╗██████╗ █████╗ ██████╗ ██╔════╝██╔════╝██╔══██╗██╔══██╗██╔════╝ ███████╗█████╗ ██████╔╝███████║██║ ╚════██║██╔══╝ ██╔══██╗██╔══██║██║ ███████║███████╗██║ ██║██║ ██║╚██████╗ ╚══════╝╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝ </pre> <h3 align="center">The autonomous ServiceNow development agent.</h3> AI-powered • Multi-agent • Multi-provider • 200+ MCP tools <a href="https://www.npmjs.com/package/@serac-labs/serac"><img alt="npm" src="https://img.shields.io/npm/v/@serac-labs/serac?style=for-the-badge&logo=npm&logoColor=white&color=CB3837" /></a>  <a href="https://www.npmjs.com/package/@serac-labs/serac"><img alt="Downloads" src="https://img.shields.io/npm/dw/@serac-labs/serac?style=for-the-badge&logo=npm&logoColor=white&label=downloads&color=CB3837" /></a>  <a href="https://github.com/serac-labs/serac/stargazers"><img alt="Stars" src="https://img.shields.io/github/stars/serac-labs/serac?style=for-the-badge&logo=github&color=yellow" /></a>  <a href="https://github.com/serac-labs/serac"><img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-3178C6?style=for-the-badge&logo=typescript&logoColor=white" /></a>  <a href="https://github.com/serac-labs/serac/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/badge/license-Elastic--2.0-blue?style=for-the-badge" /></a> <a href="README.md">English</a> • <a href="README.zh.md">简体中文</a> • <a href="README.zht.md">繁體中文</a> • <a href="README.ko.md">한국어</a> • <a href="README.de.md">Deutsch</a> • <a href="README.es.md">Español</a> • <a href="README.fr.md">Français</a> • <a href="README.it.md">Italiano</a> • <a href="README.da.md">Dansk</a> • <a href="README.ja.md">日本語</a> • <a href="README.pl.md">Polski</a> • <a href="README.ru.md">Русский</a> • <a href="README.ar.md">العربية</a> • <a href="README.no.md">Norsk</a> • <a href="README.br.md">Português (Brasil)</a>

Serac is an AI-powered, multi-agent development framework built specifically for ServiceNow. It combines a powerful terminal UI with 200+ ServiceNow MCP tools, 55 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 55 domain skills (including Blast Radius impact analysis) purpose-built for ServiceNow development, deployment, and automation.

</td> <td width="33%" valign="top">

Any AI Provider Works with 20+ providers: Anthropic, OpenAI, Google, AWS Bedrock, Azure, Groq, and many more.

</td> <td width="33%" valign="top">

Multi-Agent Built-in build & plan agents with configurable permissions, custom agents, and subagent orchestration.

</td> </tr> <tr> <td width="33%" valign="top">

Terminal-First Beautiful TUI built with SolidJS + opentui.

</td> <td width="33%" valign="top">

MCP Ecosystem Connect any MCP server via stdio, SSE, or HTTP. Extend with the full MCP ecosystem.

</td> <td width="33%" valign="top">

Open Source Elastic License 2.0. Fully transparent. Community-driven.

</td> </tr> </table>

Getting Started

Install

curl -fsSL https://serac.build/install | bash

<details> <summary>More installation methods</summary>

# npm / bun / pnpm / yarn
npm i -g @serac-labs/serac@latest

# Homebrew (macOS & Linux — recommended, always up to date)
brew install serac-labs/tap/serac

# Windows
scoop install serac
choco install serac

# Arch Linux
paru -S serac-bin

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

</details>

Quick Start

serac

On first launch, Serac prompts you to configure an AI provider. You can also pre-configure in serac.jsonc:

{
  "$schema": "https://serac.build/config.json",
  "provider": {
    "anthropic": {},
    "openai": {},
  },
}

Supported AI Providers

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

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

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 serac.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 Serac — 200+ MCP tools purpose-built for ServiceNow.

Operations

Query any table
CMDB search
User management
Operational metrics

</td> <td width="33%" valign="top">

Development

Script Includes
Business Rules
Client Scripts
UI Policies & Actions

</td> <td width="33%" valign="top">

Automation

Flow Designer
Scheduled Jobs
Approval Workflows
Event Management

</td> </tr> <tr> <td width="33%" valign="top">

Deployment

Widget deploy & preview
Update Set lifecycle
Artifact validation
Rollback support

</td> <td width="33%" valign="top">

Security

ACL management
Domain Separation
Compliance auditing
Vulnerability scanning

</td> <td width="33%" valign="top">

Analysis

Reporting & Dashboards
KPI management
Performance Analytics
Data quality checks

</td> </tr> </table>

Connect to your instance:

{
  "mcp": {
    "servicenow": {
      "type": "local",
      "command": ["serac", "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
Analysis	Blast Radius (configuration dependency & impact analysis)

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"],
    },
  },
}

</td> <td width="50%" valign="top">

Plugins

Extend with npm packages or local plugins that add tools, auth providers, event hooks, and config hooks:

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

</td> </tr> </table>

Headless / Server Mode

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

serac serve              # Start API server on port 4096
serac serve --port 8080  # Custom port
serac web                # Start server + open web interface
serac 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",
  },
}

<details> <summary>Installation directory priority</summary>

The install script respects the following priority order:

$SERAC_INSTALL_DIR — Custom installation directory
$XDG_BIN_DIR — XDG Base Directory Specification compliant path
$HOME/bin — Standard user binary directory
$HOME/.serac/bin — Default fallback

</details>

Documentation

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

serac.build/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

<details> <summary>What is Serac?</summary>

Serac 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.

</details> <details> <summary>How is this different from other coding agents?</summary>

Serac is purpose-built for ServiceNow:

Open source — Elastic License 2.0, fully transparent
ServiceNow-native — 200+ MCP tools and 55 domain skills (including Blast Radius impact analysis) 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

</details> <details> <summary>Can I use my own AI provider / API key?</summary>

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

</details> <details> <summary>Does this work with my existing ServiceNow instance?</summary>

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

</details>

Disclaimer

Serac 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 <a href="https://serac.build"><img alt="Website" src="https://img.shields.io/badge/Website-snow--flow.dev-0ea5e9?style=for-the-badge&logo=safari&logoColor=white" /></a> If you are building a project that uses "serac" in its name, please note in your README that it is not built by or affiliated with the Serac team.

Name	performance-analytics
Description	This skill should be used when the user asks to "create indicator", "performance analytics", "PA", "KPI", "dashboard widget", "breakdown", "threshold", "scorecard", or any ServiceNow Performance Analytics development.

performance-analytics

SKILL.md

Getting Started

Install

Quick Start

Supported AI Providers

Agents

Built-in Tools

ServiceNow MCP Integration

54 Bundled Skills

Extend with MCP & Plugins

Headless / Server Mode

Permission System

Documentation

Contributing

FAQ

Disclaimer