Agent Pipeline CLI

Install

npm install -g agent-pipeline

Requires Node.js 18+. That's it.

Features

YAML Pipelines Define your workflow in a single configuration file. Stages, dependencies, timeouts—all declarative.

Parallel Execution Independent stages run simultaneously. No waiting when you don't have to.

Dependency Management Stage B needs Stage A? Declare it. The orchestrator handles the rest.

Automatic Handover Output from one agent becomes input for the next. Context flows through the pipeline.

Failure Strategies fail-fast, continue, or retry. You decide how errors propagate.

Local Notifications Get notified when pipelines complete or fail. Works on macOS and Linux.

How It Works

1. Define a pipeline

name: design-system
stages:
  - name: research
    agent: researcher
    timeout: 300s

  - name: design
    agent: designer
    dependsOn: [research]

  - name: review
    agent: reviewer
    dependsOn: [design]

2. Run it

agent-pipeline run pipeline.yaml

3. Agents execute

The CLI spawns agents, manages dependencies, passes context between stages, and reports results.

Command	Purpose
`agent-pipeline run <file>`	Execute a pipeline
`agent-pipeline validate <file>`	Check pipeline syntax
`agent-pipeline schema`	Output JSON schema for pipelines
`agent-pipeline help`	Show all commands

Use Cases

Multi-Agent Development

Product owner defines requirements → Designer creates mockups → Developer implements → Reviewer checks code. Each stage is an agent. Each agent does its job.

Content Pipelines

Research → Write → Edit → Publish. Chain content agents with automatic handover. Output of one becomes input of the next.

Code Review Workflows

Lint → Test → Security scan → Review. Parallel where possible, sequential where necessary.

Data Processing

Extract → Transform → Validate → Load. AI agents at each stage, orchestrated by YAML.

Get Started

Install the CLI. Write a pipeline. Run it.

View on GitHub Documentation