Name: local-ci
Author: redwoodjs

About

Imported from redwoodjs/local-ci (packages/cli/SKILL.md). Install upstream with npx skills add redwoodjs/local-ci --skill cli. Copyright stays with the author.

What local-ci does

Runs the official GitHub Actions runner binary locally (in Docker), emulating GitHub's cloud API. Cache is bind-mounted (instant). When a step fails, the container pauses — you can fix and retry the failed step without restarting.

When to use local-ci (not `act`)

You want bit-for-bit compatibility with remote GitHub Actions
You need pause-on-failure for AI agent debugging loops
Cache round-trip speed matters

Key commands

Run workflow: npx run-local-ci run --workflow <path>
Run all relevant workflows (those whose on triggers match the current branch/event, just like GitHub): npx run-local-ci run --all
Retry after fix: npx run-local-ci retry --name <runner>
Abort: npx run-local-ci abort --name <runner>

Agent output mode

Pass --json (or set LOCAL_CI_JSON=1) to emit an NDJSON event stream on stdout — one JSON object per line, with run.start/paused/finish, job.start/finish, step.start/finish, and diagnostic events. run.start carries schemaVersion: 1. Pair with --pause-on-failure: when stdout isn't a TTY the launcher detaches and the foreground process exits 77 the instant a run.paused event fires, so callers can react cleanly without parsing plaintext.

Common mistakes

Don't push to remote CI to test changes — use npx run-local-ci run locally first
Don't use --from-start when only the last step failed — use retry with no flags to re-run only the failed step
The AI_AGENT=1 env variable disables animated output for cleaner agent logs
Use --no-matrix to collapse matrix jobs into a single run — your local machine is likely faster than GitHub's runners, so parallelizing across matrix combinations is unnecessary

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/redwoodjs-local-ci-cli/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

redwoodjs-local-ci-cli.ocm.jsonjson

{
  "ocm": "1",
  "id": "redwoodjs-local-ci-cli",
  "kind": "skill",
  "name": "local-ci",
  "description": "Run GitHub Actions workflows locally with pause-on-failure for AI-agent-driven CI iteration",
  "publisher": "redwoodjs",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "github-actions",
      "local-ci",
      "pause-on-failure",
      "ai-agent",
      "runner",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Run GitHub Actions workflows locally with pause-on-failure for AI-agent-driven CI iteration"
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/redwoodjs/local-ci",
      "path": "packages/cli/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/redwoodjs/local-ci/blob/HEAD/packages/cli/SKILL.md",
      "key": "redwoodjs/local-ci/packages/cli/SKILL.md"
    }
  },
  "instructions": "## What local-ci does\n\nRuns the official GitHub Actions runner binary locally (in Docker), emulating GitHub's cloud API.\nCache is bind-mounted (instant). When a step fails, the container pauses — you can fix and retry the failed step without restarting.\n\n## When to use local-ci (not `act`)\n\n- You want bit-for-bit compatibility with remote GitHub Actions\n- You need pause-on-failure for AI agent debugging loops\n- Cache round-trip speed matters\n\n## Key commands\n\n- Run workflow: `npx run-local-ci run --workflow <path>`\n- Run all relevant workflows (those whose `on` triggers match the current branc",
  "cost": {
    "context_tokens": 436
  }
}

Fetch it by URL: GET /api/v1/registry/redwoodjs-local-ci-cli/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.