TechXploreLabs/seristack

One YAML configuration. CLI commands, HTTP endpoints, and MCP tools.
Seristack is a lightweight automation engine for DevOps, Platform, SRE, and Cloud teams.
Define shell-based workflows in YAML, manage dependencies and variables, execute them locally or through HTTP, and expose selected stacks as MCP tools for AI agents and IDE integrations.
GitHub Repository
## Why Seristack?
Operational workflows often live as shell scripts, runbooks, CI jobs, and undocumented procedures.
Seristack provides a single configuration layer for turning those workflows into reusable execution stacks that can be:
Run from the CLI
Exposed as HTTP endpoints
Exposed as MCP tools
Protected with per-stack authorization
Audited with structured JSON logs
Composed using dependencies and shared results
## Documentation
Configuration Reference
## Features
🚀 Run multiple command stacks from a single YAML configuration
🔁 Execute stacks sequentially or concurrently
🔢 Repeat stack execution with configurable counts
🔗 Define dependencies between stacks
🧩 Variable substitution with validation rules
📦 Share output and results between dependent stacks
🌐 Expose stacks as HTTP endpoints
🔐 Per-stack authorization using identity headers
📋 Structured JSON audit logging
🧠 Run as an MCP server for AI agents and IDE integrations
🛠 Support for mvdan shell, Bash, sh, and PowerShell
⏱ Per-stack execution timeouts
📁 Configurable working directories
🛡 Allow and deny rules for stack variables
## Installation
### Homebrew — macOS and Linux
bash
brew install TechXploreLabs/tap/seristack
### Linux — installer
bash
curl -fsSL https://raw.githubusercontent.com/TechXploreLabs/seristack/main/install.sh | bash
### Linux — release archive
1. Go to Seristack Releases.
2. Download the latest:
text
seristackVERSIONlinuxARCH.tar.gz
For example:
text
seristack0.4.1linuxamd64.tar.gz
3. Extract the archive:
bash
tar -xzf seristackVERSIONlinuxARCH.tar.gz
4. Install the binary:
bash
sudo mv seristack /usr/local/bin/
sudo chmod +x /usr/local/bin/seristack
5. Verify:
bash
seristack --help
### Windows — installer
Run PowerShell as a user with permission to install the binary:
powershell
irm https://raw.githubusercontent.com/TechXploreLabs/seristack/main/install.ps1 | iex
### Windows — release archive
1. Go to Seristack Releases.
2. Download the Windows release archive:
text
seristackVERSIONwindowsARCH.tar.gz
For example:
text
seristack0.4.1windowsamd64.tar.gz
3. Extract the archive with a tool that supports .tar.gz.
4. Place seristack.exe in a directory included in your %PATH%.
5. Verify:
powershell
seristack --help
## Configuration
Seristack uses YAML to define execution stacks.
For a complete description of all configuration fields, see the Configuration Reference.
### Example
yaml
stacks:
name: stack1
workDir: ./
description: Print welcome message
method: GET
urlPath: /show
continueOnError: false
count: 3
timeouts: 1h
executionMode: PARALLEL
vars:
name: samplekey
value: samplevalue
required: true
allowedvalue:
samplevalue
devvalue
cmds:
export samplekey={{.Vars.samplekey}}
echo $samplekey
echo "count={{.Count.index}}"
echo "Hey I'm Seristack!"
name: stack2
workDir: ./
continueOnError: false
count: 3
executionMode: SEQUENTIAL
vars:
name: env