Run GitHub Actions-compatible workflows locally, validate workflow files, and manage CI/CD pipelines directly from your terminal.
Overview
The wit ci command provides local workflow execution and management, compatible with GitHub Actions YAML syntax.
Commands
run
Run workflows locally on your machine.
Options
Examples
Example Output
list
List all available workflows in the repository.
Example Output
validate
Validate workflow YAML syntax and structure.
Examples
Example Output
runs
Show recent workflow runs (requires server connection).
This command requires a connection to the wit server. View runs in the web UI or use the API directly.
view
View details of a specific workflow run (requires server connection).
Workflow Configuration
Workflows are defined in .wit/workflows/ using GitHub Actions-compatible YAML syntax.
Directory Structure
Example Workflow
Supported Triggers
Job Dependencies
Use needs to specify job dependencies:
Local Execution
When running workflows locally, wit executes steps directly on your machine.
Environment
- Commands run in your repository’s working directory
- Environment variables from your shell are available
- Secrets should be set via environment variables
Setting Secrets Locally
Pre-commit/Pre-push Integration
Run CI checks before committing or pushing:
Pre-commit Hook
Pre-push Hook
Workflow Example
A typical development workflow with CI:
Server Integration
For full CI/CD capabilities including:
- Remote workflow execution
- Build artifacts
- Job logs and history
- PR status checks
Start the wit server:
Then view workflow runs in the web UI at http://localhost:3000/:owner/:repo/actions
Use wit ci run --dry-run to preview which jobs and steps would run before actually executing them. This is useful for understanding complex workflows with dependencies.
