greening-ci-local

Run GitHub Actions workflows locally in Docker and retry paused steps.

125|42|Updated May 19, 2025
One-click install
npx skills add https://github.com/SocketDev/socket-mcp --skill greening-ci-local
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: greening-ci-local
Source: https://github.com/SocketDev/socket-mcp/tree/main/.claude/skills/fleet/greening-ci-local
Command: npx skills add https://github.com/SocketDev/socket-mcp --skill greening-ci-local

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Drive a repo's CI to green LOCALLY with Agent-CI (Docker), the local analog of greening-ci. Runs a workflow (or all PR/push workflows) in containers, and on the first paused step reads the failure log, fixes the code locally, and agent-ci retries the same paused runner — looping until the run lands green or a wall-clock budget expires. Use to validate a workflow change or a release dispatch BEFORE burning a remote run, to catch a CI failure on your own machine, or as the local pre-flight before republishing-stubs / any remote build-matrix dispatch. Where greening-ci watches GitHub Actions remotely and fixes-then-pushes, this runs in local containers and fixes-then-retries in place — no push, no remote runner minutes.

Core Features & Use Cases

  • Local twin of greening-ci for local validation
  • Runs workflows in Docker via Agent-CI and retries the same paused runner
  • Pre-flight validation before remote CI runs and reduced remote minutes

Quick Start

Run the greening-ci-local tool to run a workflow locally and retry on paused steps until green.

Frequently Asked Questions about greening-ci-local

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run GitHub Actions workflows locally in Docker to test CI changes?

Run GitHub Actions workflows locally in Docker to validate CI changes by executing them in containers and automatically retrying paused steps until the run passes or a time budget expires. This enables fast feedback without using remote runners.

Can I validate a single workflow file locally before pushing to remote CI?

Yes, you can validate a single workflow file locally before pushing to remote CI. The tool runs the specified workflow in local containers, allowing you to preflight changes and catch failures on your own machine without burning remote runner minutes.

What is the best way to automatically fix and retry paused CI steps locally?

The best way to automatically fix and retry paused CI steps locally is using an agent that reads failure logs, modifies code in place, and retries the same paused runner in Docker. This loops until the workflow lands green or a wall-clock budget is reached.

Does local CI execution with Docker avoid pushing code to remote repositories?

Yes, local CI execution with Docker avoids pushing code to remote repositories. It runs workflows in local containers and fixes then retries steps in place, ensuring no code is pushed and no remote runner minutes are consumed during validation.

How do I set a time budget for local workflow validation loops?

You can set a wall-clock budget for local workflow validation loops to constrain execution time. The tool automatically stops retrying paused steps and terminates the local run when this budget expires, preventing infinite loops.

Why use local Docker containers instead of remote GitHub Actions runners for CI preflight?

Use local Docker containers instead of remote GitHub Actions runners for CI preflight to get deterministic execution and fast feedback without consuming remote runner minutes. It allows you to catch and fix failures on your local machine before dispatching a remote build.