agent-ci

Category: Tools & Productivity | Uploader: redwoodjs | Downloads: 0 | Version: v1.0（Latest）

Run GitHub Actions workflows locally with pause-on-failure for AI-agent-driven CI iteration

Changelog: Source: GitHub https://github.com/redwoodjs/agent-ci

Directory Structure

Current level: tree/main/packages/cli/

📁 src/
- 📁 docker/
  - 📄 container-config.test.ts 16.4 KB
  - 📄 container-config.ts 13.9 KB
  - 📄 docker-socket.test.ts 9.4 KB
  - 📄 docker-socket.ts 6.7 KB
  - 📄 image-pull.test.ts 3.1 KB
  - 📄 image-pull.ts 1.9 KB
  - 📄 repro-126.test.ts 3.0 KB
  - 📄 repro-197.test.ts 4.2 KB
  - 📄 service-containers.test.ts 12.1 KB
  - 📄 service-containers.ts 8.7 KB
  - 📄 shutdown.test.ts 15.5 KB
  - 📄 shutdown.ts 7.6 KB
- 📁 hooks/
  - 📄 json-loader.ts 689 B
- 📁 output/
  - 📄 agent-mode.test.ts 1.1 KB
  - 📄 agent-mode.ts 196 B
  - 📄 cleanup.test.ts 15.6 KB
  - 📄 cleanup.ts 9.0 KB
  - 📄 concurrency.test.ts 3.2 KB
  - 📄 concurrency.ts 3.2 KB
  - 📄 debug.ts 1.3 KB
  - 📄 logger.test.ts 6.0 KB
  - 📄 logger.ts 2.8 KB
  - 📄 reporter.test.ts 5.2 KB
  - 📄 reporter.ts 4.8 KB
  - 📄 run-state.test.ts 7.3 KB
  - 📄 run-state.ts 6.6 KB
  - 📄 state-renderer.test.ts 17.0 KB
  - 📄 state-renderer.ts 8.9 KB
  - 📄 tree-renderer.test.ts 3.2 KB
  - 📄 tree-renderer.ts 1.9 KB
  - 📄 working-directory.test.ts 3.7 KB
  - 📄 working-directory.ts 1.6 KB
- 📁 runner/
  - 📄 directory-setup.test.ts 9.7 KB
  - 📄 directory-setup.ts 4.7 KB
  - 📄 dirty-sha.test.ts 4.3 KB
  - 📄 dirty-sha.ts 2.0 KB
  - 📄 git-shim.test.ts 1.8 KB
  - 📄 git-shim.ts 3.5 KB
  - 📄 job-result.test.ts 4.2 KB
  - 📄 job-result.ts 1.2 KB
  - 📄 local-job.test.ts 1.5 KB
  - 📄 local-job.ts 36.7 KB
  - 📄 metadata.test.ts 5.4 KB
  - 📄 metadata.ts 4.2 KB
  - 📄 result-builder.test.ts 15.6 KB
  - 📄 result-builder.ts 11.2 KB
  - 📄 runner-image.test.ts 7.6 KB
  - 📄 runner-image.ts 7.7 KB
  - 📄 step-wrapper.test.ts 3.9 KB
  - 📄 step-wrapper.ts 5.8 KB
  - 📄 sync.ts 2.7 KB
  - 📄 workspace.ts 3.2 KB
- 📁 workflow/
  - 📄 job-scheduler.test.ts 3.9 KB
  - 📄 job-scheduler.ts 1.8 KB
  - 📄 matrix-collapse.test.ts 4.8 KB
  - 📄 remote-workflow-fetch.test.ts 9.9 KB
  - 📄 remote-workflow-fetch.ts 4.2 KB
  - 📄 reusable-workflow.test.ts 18.6 KB
  - 📄 reusable-workflow.ts 6.8 KB
  - 📄 workflow-parser.test.ts 53.6 KB
  - 📄 workflow-parser.ts 41.1 KB
- 📄 cli.ts 45.7 KB
- 📄 commit-status.ts 1.6 KB
- 📄 config.test.ts 8.8 KB
- 📄 config.ts 3.6 KB
- 📄 types.ts 641 B
📄 CHANGELOG.md 13.6 KB
📄 compatibility.md 26.1 KB
📄 package.json 1.2 KB
📄 README.md 8.0 KB
📄 runner-image.md 6.2 KB
📄 shim.sh 223 B
📄 SKILL.md 1.5 KB
📄 tsconfig.json 363 B
📄 vitest.config.ts 512 B

SKILL.md

---
name: agent-ci
description: Run GitHub Actions workflows locally with pause-on-failure for AI-agent-driven CI iteration
keywords: [github-actions, local-ci, pause-on-failure, ai-agent, runner]
---

## What agent-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 agent-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 @redwoodjs/agent-ci run --workflow <path>`
- Run all relevant workflows (those whose `on` triggers match the current branch/event, just like GitHub): `npx @redwoodjs/agent-ci run --all`
- Retry after fix: `npx @redwoodjs/agent-ci retry --name <runner>`
- Abort: `npx @redwoodjs/agent-ci abort --name <runner>`

## Common mistakes

- Don't push to remote CI to test changes — use `npx @redwoodjs/agent-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

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

agent-ci

Directory Structure

SKILL.md

Report

Notice