Local CI

Agent-enablingSource Available

Source-available local GitHub Actions runner designed for AI-agent development loops

Overview

About Local CI

This summary uses submitted and public product material. Only source-mapped claims are documentation reviewed.

Local CI, formerly Agent CI, is a local GitHub Actions runner built for AI-agent development workflows. It focuses on running workflows on your machine with near-instant cache reuse, pausing on failures so an agent can fix the issue in place, and retrying without pushing commits to trigger remote CI.

Features

  • Local execution of GitHub Actions workflows with bind-mounted caches for fast reruns
  • Pause-on-failure flow that preserves container state so fixes can be applied before retrying
  • Retry support for failed steps instead of restarting the whole workflow from scratch
  • Emulation layer around the official GitHub Actions runner binary rather than a full custom reimplementation
  • Guidance for integrating local CI runs into agent instruction files like AGENTS.md or CLAUDE.md

So agents can…

  • Run CI checks locally before pushing code and cut feedback loops from minutes to seconds
  • Inspect and fix failing workflow steps without losing the environment state
  • Treat GitHub Actions as part of an iterative local agent workflow instead of a remote-only gate

Listing decision

Why Local CI is listed

The software shortens an agent’s development feedback loop by executing existing GitHub Actions workflows locally; it enables agents but does not itself plan or carry out general user goals.

Before you choose

Fit and limitations

Best for

Coding-agent workflows that need repeatable local pre-flight checks, fast dependency-cache reuse, and the ability to inspect and retry a failed CI step before pushing.

Known limitations

A running Docker provider is required for ordinary jobs. macOS jobs require Apple Silicon plus Tart and sshpass, and Windows jobs are not supported. The canonical product and package are now Local CI; the Agent CI package remains a compatibility alias only during the 0.x line.

Not yet verified

No workflow-compatibility claim was hands-on tested for this record.

Sources

Sources and verification

First-party unless marked otherwise. Each link supports only its adjacent claim.

  1. Local CI product site — local GitHub Actions runner workflow

    The current product site documents local GitHub Actions execution, local caches, pause-on-failure, and retry-in-place workflows for coding agents.

    official product page · accessed Sep 3, 2026
  2. Local CI repository — requirements, interfaces, and Agent CI migration

    The maintained repository documents the CLI and NDJSON interface, Docker requirement, platform caveats, and the rename from Agent CI to Local CI.

    official repository · accessed Sep 3, 2026
  3. Local CI license — FSL-1.1-MIT

    RedwoodJS Inc publishes Local CI under FSL-1.1-MIT, which restricts competing use and grants an MIT future license after two years.

    official license · accessed Sep 3, 2026

Related tools

Comments