Skip to main content
wit includes a built-in CI/CD engine that can parse and validate GitHub Actions-compatible workflow files. Define your workflows in .wit/workflows/ and wit understands them natively.
The CI/CD engine supports local workflow execution. Jobs run on your machine with shell command execution, environment variable expansion, and step output handling.

Quick Start

Workflow Location

Workflows are stored in .wit/workflows/*.yml:

Workflow Syntax

wit supports GitHub Actions workflow syntax:

Triggers

Push Trigger

Pull Request Trigger

Schedule Trigger

Manual Trigger

Multiple Triggers

Jobs

Basic Job

Job Dependencies

wit automatically determines the correct job order based on dependencies.

Matrix Strategy

Conditional Jobs

Steps

Run Commands

Use Actions

Environment Variables

Services

Concurrency

Permissions

Programmatic API

wit exposes the CI engine programmatically:

Validation

wit validates workflows for common errors:

Validated Elements

  • Required fields (name, on, jobs)
  • Valid trigger events
  • Job dependency cycles
  • Step structure
  • Expression syntax (${{ ... }})
  • Cron expressions

Example Workflows

Node.js CI

Deploy on Tag

Scheduled Maintenance

Comparison with GitHub Actions

Future Plans

  • Container step support
  • Action marketplace integration
  • Parallel job execution
  • Artifact handling
  • Remote runners