@redwoodjs/agent-ci 0.4.0 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +7 -6
- package/SKILL.md +30 -0
- package/package.json +18 -5
package/README.md
CHANGED
|
@@ -46,12 +46,13 @@ DOCKER_HOST=ssh://user@remote-server npx agent-ci run --workflow .github/workflo
|
|
|
46
46
|
|
|
47
47
|
Run GitHub Actions workflow jobs locally.
|
|
48
48
|
|
|
49
|
-
| Flag | Short | Description
|
|
50
|
-
| -------------------- | ----- |
|
|
51
|
-
| `--workflow <path>` | `-w` | Path to the workflow file
|
|
52
|
-
| `--all` | `-a` | Discover and run all relevant workflows for the current branch
|
|
53
|
-
| `--pause-on-failure` | `-p` | Pause on step failure for interactive debugging
|
|
54
|
-
| `--quiet` | `-q` | Suppress animated rendering (also enabled by `AI_AGENT=1`)
|
|
49
|
+
| Flag | Short | Description |
|
|
50
|
+
| -------------------- | ----- | --------------------------------------------------------------------------------- |
|
|
51
|
+
| `--workflow <path>` | `-w` | Path to the workflow file |
|
|
52
|
+
| `--all` | `-a` | Discover and run all relevant workflows for the current branch |
|
|
53
|
+
| `--pause-on-failure` | `-p` | Pause on step failure for interactive debugging |
|
|
54
|
+
| `--quiet` | `-q` | Suppress animated rendering (also enabled by `AI_AGENT=1`) |
|
|
55
|
+
| `--no-matrix` | | Collapse all matrix combinations into a single job (uses first value of each key) |
|
|
55
56
|
|
|
56
57
|
### `agent-ci retry`
|
|
57
58
|
|
package/SKILL.md
ADDED
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: agent-ci
|
|
3
|
+
description: Run GitHub Actions workflows locally with pause-on-failure for AI-agent-driven CI iteration
|
|
4
|
+
keywords: [github-actions, local-ci, pause-on-failure, ai-agent, runner]
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## What agent-ci does
|
|
8
|
+
|
|
9
|
+
Runs the official GitHub Actions runner binary locally (in Docker), emulating GitHub's cloud API.
|
|
10
|
+
Cache is bind-mounted (instant). When a step fails, the container pauses — you can fix and retry the failed step without restarting.
|
|
11
|
+
|
|
12
|
+
## When to use agent-ci (not `act`)
|
|
13
|
+
|
|
14
|
+
- You want bit-for-bit compatibility with remote GitHub Actions
|
|
15
|
+
- You need pause-on-failure for AI agent debugging loops
|
|
16
|
+
- Cache round-trip speed matters
|
|
17
|
+
|
|
18
|
+
## Key commands
|
|
19
|
+
|
|
20
|
+
- Run workflow: `npx @redwoodjs/agent-ci run --workflow <path>`
|
|
21
|
+
- Run all relevant workflows (those whose `on` triggers match the current branch/event, just like GitHub): `npx @redwoodjs/agent-ci run --all`
|
|
22
|
+
- Retry after fix: `npx @redwoodjs/agent-ci retry --name <runner>`
|
|
23
|
+
- Abort: `npx @redwoodjs/agent-ci abort --name <runner>`
|
|
24
|
+
|
|
25
|
+
## Common mistakes
|
|
26
|
+
|
|
27
|
+
- Don't push to remote CI to test changes — use `npx @redwoodjs/agent-ci run` locally first
|
|
28
|
+
- Don't use `--from-start` when only the last step failed — use `retry` with no flags to re-run only the failed step
|
|
29
|
+
- The `AI_AGENT=1` env variable disables animated output for cleaner agent logs
|
|
30
|
+
- 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
|
package/package.json
CHANGED
|
@@ -1,8 +1,20 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@redwoodjs/agent-ci",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"description": "Local GitHub Actions runner",
|
|
5
|
-
"keywords": [
|
|
3
|
+
"version": "0.5.0",
|
|
4
|
+
"description": "Local GitHub Actions runner — pause on failure, ~0ms cache, official runner binary. Built for AI coding agents.",
|
|
5
|
+
"keywords": [
|
|
6
|
+
"act-alternative",
|
|
7
|
+
"ai-agent",
|
|
8
|
+
"ci",
|
|
9
|
+
"coding-agent",
|
|
10
|
+
"devtools",
|
|
11
|
+
"github-actions",
|
|
12
|
+
"local-ci",
|
|
13
|
+
"local-runner",
|
|
14
|
+
"pause-on-failure",
|
|
15
|
+
"runner",
|
|
16
|
+
"workflow"
|
|
17
|
+
],
|
|
6
18
|
"license": "FSL-1.1-MIT",
|
|
7
19
|
"author": "",
|
|
8
20
|
"repository": {
|
|
@@ -15,7 +27,8 @@
|
|
|
15
27
|
},
|
|
16
28
|
"files": [
|
|
17
29
|
"dist",
|
|
18
|
-
"shim.sh"
|
|
30
|
+
"shim.sh",
|
|
31
|
+
"SKILL.md"
|
|
19
32
|
],
|
|
20
33
|
"type": "module",
|
|
21
34
|
"publishConfig": {
|
|
@@ -27,7 +40,7 @@
|
|
|
27
40
|
"log-update": "^7.2.0",
|
|
28
41
|
"minimatch": "^10.2.1",
|
|
29
42
|
"yaml": "^2.8.2",
|
|
30
|
-
"dtu-github-actions": "0.
|
|
43
|
+
"dtu-github-actions": "0.5.0"
|
|
31
44
|
},
|
|
32
45
|
"devDependencies": {
|
|
33
46
|
"@types/dockerode": "^3.3.34",
|