# agent-ci > Agent-CI is local GitHub Actions for your agents. - **URL**: https://www.freshcrate.ai/projects/agent-ci - **Author**: redwoodjs - **Category**: AI Agents - **Latest version**: `@redwoodjs/agent-ci@0.16.2` (2026-05-22) - **License**: NOASSERTION - **Source**: https://github.com/redwoodjs/agent-ci - **Homepage**: https://agent-ci.dev - **Language**: TypeScript - **GitHub**: 599 stars, 13 forks - **Registry**: github - **Tags**: `act-alternative`, `ai-agent`, `ci-cd`, `developer-experience`, `devtools`, `github-actions`, `local-runner`, `typescript` ## Description Agent-CI is local GitHub Actions for your agents. ## Recent releases | Version | Date | Urgency | Changes | | --- | --- | --- | --- | | `@redwoodjs/agent-ci@0.16.2` | 2026-05-22 | High | ### Patch Changes - b619fc7: Avoid reusing runner numbers while stable log directories still exist, and clear stale per-run timeline/log artifacts when a runner name is reused, so old `timeline.json` records cannot be merged into a fresh run and reported as a false failure. Refs #341. - Updated dependencies [b619fc7] - dtu-github-actions@0.16.2 | | `dtu-github-actions@0.16.0` | 2026-05-21 | High | ### Minor Changes - c8da13a: Add `agent-ci run --var-file ` for loading workflow variables from JSON files or GitHub CLI `gh variable list --json name,value` output piped on stdin. Explicit `--var KEY=VALUE` flags override file-provided values. Refs #358. - ab075d9: chore: require Node 24 and drop `tsx` Node 24 ships native TypeScript stripping as a stable feature, so we no longer need the `tsx` runtime to execute `.ts` files. Every `tsx foo.ts` invocation in pack | | `@redwoodjs/agent-ci@0.15.1` | 2026-05-07 | High | ### Patch Changes - 63204ec: fix(macos-vm): let `waitForIp` retry on cold-boot `tart ip` timeouts `getIp` swallows the `runCommand` rejection that fires when `tart ip` hangs past 5s waiting for a DHCP lease, so `waitForIp` can keep polling for the full 90s budget instead of dying on the first iteration. Refs #329. - Updated dependencies [63204ec] - dtu-github-actions@0.15.1 | | `dtu-github-actions@0.15.0` | 2026-04-29 | High | ### Minor Changes - daa536c: Colocate per-run log artifacts with the checks JSON under `/logs/` (override via `AGENT_CI_LOG_DIR`) so log paths recorded in the run-result JSON survive OS-level pruning of `os.tmpdir()`. Add an opportunistic, throttled cleanup that runs at the start of `agent-ci run` plus an explicit `agent-ci clean` command. Knobs: `AGENT_CI_LOG_RETAIN_DAYS` (default 7), `AGENT_CI_LOG_RETAIN_RUNS` (default 20), `AGENT_CI_LOG_PRUNE=0` to disable. Refs #312. Also f | | `dtu-github-actions@0.14.0` | 2026-04-28 | High | ### Patch Changes - 44595b1: Surface degraded local runs when the host machine is smaller than the runner spec declared by `runs-on:` (e.g. `ubuntu-latest-8-cores`). The job is tagged `degraded`, a warning is printed before execution, and `[degraded]` appears in CLI output. Execution is never blocked — slow runs and OOMs now have a visible cause instead of being a mystery. Refs #229. - 76b46f9: Revert the opt-in smolvm backend (#287). The implementation proved too rough to keep in | | `@redwoodjs/agent-ci@0.13.0` | 2026-04-22 | High | ### Minor Changes - 77ea148: Rename `DOCKER_HOST` to `AGENT_CI_DOCKER_HOST` and load `AGENT_CI_*` vars from `.env.agent-ci`. **Breaking:** agent-ci no longer honours the standard `DOCKER_HOST` env var. If it is set in the shell, agent-ci exits immediately with an error asking you to rename it. Rename it in your shell (or move it to `.env.agent-ci`) as `AGENT_CI_DOCKER_HOST`. This avoids the long-standing collision where users wanted agent-ci to target one daemon (e.g. a Lima/OrbStack VM) | | `@redwoodjs/agent-ci@0.12.4` | 2026-04-20 | High | ### Patch Changes - e2fe576: Make `packages/cli/compatibility.json` the single source of truth for the YAML compatibility matrix. The `compatibility.md` document and the website's compatibility table are both derived from it — run `pnpm compat:gen` after editing the JSON. `pnpm check` fails if the `.md` drifts out of sync. - e2fe576: Add a `proof` field to `compatibility.json` rows pointing at the workflow files that exercise each feature end-to-end. Internal field — not rendered in the ma | | `dtu-github-actions@0.12.4` | 2026-04-20 | High | ### Patch Changes - e2fe576: Make `packages/cli/compatibility.json` the single source of truth for the YAML compatibility matrix. The `compatibility.md` document and the website's compatibility table are both derived from it — run `pnpm compat:gen` after editing the JSON. `pnpm check` fails if the `.md` drifts out of sync. - e2fe576: Add a `proof` field to `compatibility.json` rows pointing at the workflow files that exercise each feature end-to-end. Internal field — not rendered in the ma | | `@redwoodjs/agent-ci@0.12.3` | 2026-04-19 | High | ### Patch Changes - 2e7c844: Document and surface Docker Desktop's default-socket toggle. Docker Desktop 4.x ships with `/var/run/docker.sock` disabled, so a fresh install will hit `agent-ci couldn't use a Docker socket at /var/run/docker.sock` even when Docker Desktop is running. The `docker-socket.md` recipe now walks through the Settings → Advanced toggle, and the resolver error appends a one-shot hint pointing at it whenever it detects Docker Desktop's user-side socket (`~/.docker/run/doc | | `dtu-github-actions@0.12.3` | 2026-04-19 | High | ### Patch Changes - 2e7c844: Document and surface Docker Desktop's default-socket toggle. Docker Desktop 4.x ships with `/var/run/docker.sock` disabled, so a fresh install will hit `agent-ci couldn't use a Docker socket at /var/run/docker.sock` even when Docker Desktop is running. The `docker-socket.md` recipe now walks through the Settings → Advanced toggle, and the resolver error appends a one-shot hint pointing at it whenever it detects Docker Desktop's user-side socket (`~/.docker/run/doc | ## Dependency audit - **Score**: 98/100 - **Total deps**: 11 - **Resolved**: 11 - **Unresolved**: 0 - **License conflicts**: 0 - **Warnings**: 1 - **Scanned**: 2026-05-11 ## Citation - HTML: https://www.freshcrate.ai/projects/agent-ci - Markdown: https://www.freshcrate.ai/projects/agent-ci.md - Dependencies JSON: https://www.freshcrate.ai/api/projects/agent-ci/deps _Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._