Introduction

Specrun lets you define multi-step agent workflows in YAML or JSON, wire tools in any language, and run everything from a single command.

Why Specrun?

• Declarative — Define workflows as data, not code. Use YAML or JSON following the Open Agent Specification.
• Language agnostic tools — Tools are standalone executables that read JSON from stdin and write JSON to stdout. No SDK required.
• Provider agnostic — Works with OpenAI, vLLM, Ollama, or any OpenAI-compatible endpoint.
• Single command — Compile, validate, and execute your workflow with specrun run.

Quick Start

Install via npm or Homebrew:

npm install -g @specrun/cli
# or
brew install spichen/tap/specrun

Scaffold a new project:

specrun init my-agent
cd my-agent

Run it:

specrun run flow.json --tools-dir tools

How It Works

1. Define your workflow in YAML/JSON using nodes and edges
2. Wire tools as standalone executables in any language
3. Run with a single command — Specrun compiles, validates, and executes

YAML/JSON → Parse → Validate → Compile Graph → Execute