Run GitLab-style pipelines locally.

Opal is a terminal-first, AI-capable local runner for GitLab pipelines. It evaluates `.gitlab-ci.yml`, keeps local Git-aware behavior where it matters, and gives you fast ways to run, inspect, debug, and analyze jobs without pushing to a remote runner.

Quick Start CLI Reference GitLab Parity

Built for local debugging

Run against the working tree you are actively editing instead of waiting on a remote runner.

Main modes run · run --no-tui · plan · view

Use interactive runs, plain terminal runs, DAG-only planning, or post-run history browsing depending on the task.

AI-assisted job analysis in the TUI

Analyze a selected job, preview the exact prompt Opal sends, and keep troubleshooting inside the same terminal workflow.

Install

#Download the build that matches your machine.

Install from crates.io

cargo install opal-cli

#Install with Homebrew on macOS

brew tap cloudflavor/tap
brew install cloudflavor/tap/opal-cli

Open install docs →

macOS · Apple Silicon

aarch64-apple-silicon

curl -L https://github.com/cloudflavor/opal/releases/download/v0.1.0-rc6/opal-0.1.0-rc6-aarch64-apple-silicon.tar.gz | tar xz

Download →

Linux · ARM64

aarch64-unknown-linux-gnu

curl -L https://github.com/cloudflavor/opal/releases/download/v0.1.0-rc6/opal-0.1.0-rc6-aarch64-unknown-linux-gnu.tar.gz | tar xz

Download →

Linux · AMD64

x86_64-unknown-linux-gnu

curl -L https://github.com/cloudflavor/opal/releases/download/v0.1.0-rc6/opal-0.1.0-rc6-x86_64-unknown-linux-gnu.tar.gz | tar xz

Download →

Demos

#The main ways people actually use Opal.

Demo

#Opal Run

Use the full TUI when you want to watch jobs live, inspect history, browse artifacts, and step through the pipeline interactively.

opal run

Open docs →

Demo

#Opal Plan

Print the evaluated DAG, dependencies, gates, and scheduling decisions without starting containers.

opal plan

Open docs →

Demo

#Opal Run --no-tui

Use plain terminal mode for scriptable local checks, sharable terminal output, and CI-like runs without the interactive interface.

opal run --no-tui

Open docs →

Demo

#Opal View

Open prior run history, logs, artifacts, and cache metadata after the fact.

opal view

Open docs →

Demo

#Opal AI Troubleshooting · Codex

Analyze the selected job with the Codex backend, inspect the rendered prompt, and keep troubleshooting inside the TUI.

press a inside opal run

Open docs →

Demo

#Opal AI Troubleshooting · Ollama

Analyze the selected job with the Ollama backend and stream the response directly into the TUI.

press a inside opal run

Open docs →

Reference

#Use these docs when you need precision, not just a demo.

#CLI Reference

See the complete command-line surface, flags, environment variables, and common examples.

opal --help

Open docs →

#AI Troubleshooting

Analyze selected jobs with Codex or Ollama, inspect the exact rendered prompt, and keep troubleshooting inside the terminal.

a / A in the TUI

Open docs →

#AI Configuration

Configure the active AI backend, prompt template files, Ollama host/model settings, and Codex CLI command/model overrides.

.opal/config.toml

Open docs →

#Pipeline Model

Understand how Opal evaluates includes, rules, services, caches, artifacts, and local workspaces.

.gitlab-ci.yml

Open docs →