README.md

June 11, 2026 · View on GitHub

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

The terminal-native AI agent for ServiceNow developers and consultants.

Your terminal • your keys (BYOK, 20+ providers) • every instance • 429 ServiceNow MCP tools

npm  Downloads  Stars  TypeScript  License

English | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська | বাংলা | Ελληνικά | Tiếng Việt

Serac Terminal UI

Serac is a terminal-native AI development agent purpose-built for ServiceNow. It brings 429 ServiceNow MCP tools, 55 bundled domain skills (including Blast Radius impact analysis), and 20+ AI providers into your own terminal — your editor, your keys (BYOK), and any instance you connect to. It's built for ServiceNow developers and the consultants who work across many client instances. Serac extends the open-source opencode agent with a deep ServiceNow domain layer.


Installation

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

# Package managers
npm i -g @serac-labs/core@latest  # or bun/pnpm/yarn

Tip

Remove versions older than 0.1.x before installing.

Desktop App (BETA)

Serac is also available as a desktop application. Download directly from the releases page or github.com/serac-labs/serac/releases/latest.

PlatformDownload
macOS (Apple Silicon)serac-desktop-mac-arm64.dmg
macOS (Intel)serac-desktop-mac-x64.dmg
Windowsserac-desktop-windows-x64.exe
Linux.deb, .rpm, or .AppImage

Installation Directory

The install script respects the following priority order for the installation path:

  1. $SERAC_INSTALL_DIR - Custom installation directory
  2. $XDG_BIN_DIR - XDG Base Directory Specification compliant path
  3. $HOME/.serac/bin - Default
# Examples
SERAC_INSTALL_DIR=/usr/local/bin curl -fsSL https://serac.build/install | bash
XDG_BIN_DIR=$HOME/.local/bin curl -fsSL https://serac.build/install | bash

Agents

Serac includes two built-in agents you can switch between with the Tab key.

  • build - Default, full-access agent for development work
  • plan - Read-only agent for analysis and code exploration
    • Denies file edits by default
    • Asks permission before running bash commands
    • Ideal for exploring unfamiliar codebases or planning changes

Also included is a general subagent for complex searches and multistep tasks. This is used internally and can be invoked using @general in messages.

Learn more about agents.

Documentation

For more info on how to configure Serac, head over to our docs.

Contributing

If you're interested in contributing to Serac, please read our contributing docs before submitting a pull request.

Building on Serac

If you are working on a project that's related to Serac and is using "serac" as part of its name, for example "serac-dashboard" or "serac-mobile", please add a note to your README to clarify that it is not built by the Serac team and is not affiliated with us in any way.

License

Licensed under the Apache License 2.0 — see also NOTICE for third-party attributions (built on the MIT-licensed opencode).