โšกLocal-first workflow runner

AI-Powered
Task Automation

sir.sh decomposes high-level instructions into executable workflows using AI. Define once, run anywhere. Built on Laravel Zero.

Everything you need to automate

From simple scripts to complex multi-step workflows, sir.sh handles it all with a powerful yet simple interface.

๐Ÿ“

Layered Configuration

Discovers .sir/ directories from cwd to root. Nearest layer takes precedence with global ~/.sir fallback.

๐Ÿ“ฆ

Pack System

Install workflow packs from Git repositories with github:owner/repo shorthand. Share automation without Composer.

โš™๏ธ

Workflow Engine

Define workflows in YAML with variables, templating, loops, conditionals. Dry-run support for safe previewing.

๐Ÿ”ง

Built-in Tasks

Common operations: git clone, file operations, test running, and more out of the box.

๐Ÿ”Œ

Method System

Extensible method definitions from packs. Shell or exec implementations with JSON schema validation.

๐Ÿค–

AI Agent Interface

MCP-style tool surface for AI assistants. Discover and execute workflows safely with full context.

Simple yet powerful

Built on a clean architecture with LayerResolver, Context, and WorkflowRunner working together to execute your workflows.

1
LayerResolver

Discovers .sir/ directories from cwd to root

2
Context

Template resolution with {{variable}} and functions

3
WorkflowRunner

Sequential step execution with saveAs support

4
PackManager

Install and manage packs from Git

sir.sh terminal
$ sir run deploy

โšก sir.sh v0.9.x

๐Ÿ“ Resolved layers:
   1. /project/.sir
   2. ~/.sir

โ–ถ Running workflow: deploy

[1/3] Shell: echo "Building..."
   โœ“ Done in 0.2s

[2/3] Task: git.clone
   โœ“ Cloned repo in 1.1s

[3/3] Task: tests.auto
   โœ“ 42 tests passed

โœ… Workflow complete in 4.2s

15 Specifications

Built on a foundation of clear specifications. Every feature has a spec, every spec has tests.

S001
Layer Resolution
S002
Config Loading
S003
Workflow Engine
S004
Template System
S005
Pack System
S006
Method System
S007
Built-in Tasks
S008
AI Interface
S009
CLI Commands
S010
Conditionals
S011
Loops
S012
Nested Props
S013
Pack Updates
S014
Remote Exec
S015
Scheduling

Get started with sir.sh

Clone the repo, run your first workflow. It's that simple.