Werk

Local CI pipeline runner with parallel execution and Docker support.

Features

• Declarative pipelines in a single YAML file
• Automatic parallelism based on the dependency graph
• Local and Docker executors
• Built-in vault for encrypting secrets in dotenv files
• Execution reports with per-job timing and status
• MCP server for AI assistant integration (experimental)

Quick start

Install via Homebrew:

brew tap marghidanu/werk
brew install werk

Create a werk.yml:

version: "1"

jobs:
  main:
    executor: local
    needs:
      - lint
      - test
    commands:
      - echo "Build complete!"

  lint:
    executor: local
    commands:
      - echo "Linting..."

  test:
    executor: local
    commands:
      - echo "Running tests..."

Run it:

werk run

Inspect the execution plan:

werk plan

Get a detailed report:

werk run -r

Documentation

• Installation
• Getting started
• Philosophy
• Internals
• MCP Server
• FAQ

License

MIT