From 3b52a2b244c853a4b66e0cdcf72abc1890948c39 Mon Sep 17 00:00:00 2001 From: "Jiaxiao (mossaka) Zhou" Date: Sat, 21 Feb 2026 01:13:17 +0000 Subject: [PATCH 1/2] docs: add supported runners table to frontmatter reference Add a table showing which GitHub Actions runners are supported for the runs-on: field. Links to FAQ for macOS explanation. Co-Authored-By: Claude Opus 4.6 (1M context) --- docs/src/content/docs/reference/frontmatter.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/src/content/docs/reference/frontmatter.md b/docs/src/content/docs/reference/frontmatter.md index 82982805f9..3cd341b690 100644 --- a/docs/src/content/docs/reference/frontmatter.md +++ b/docs/src/content/docs/reference/frontmatter.md @@ -450,6 +450,16 @@ runs-on: ubuntu-latest # Defaults to ubuntu-latest (main job only) timeout-minutes: 30 # Defaults to 20 minutes ``` +**Supported runners for `runs-on:`** + +| Runner | Status | +|--------|--------| +| `ubuntu-latest` | ✅ Default. Recommended for most workflows. | +| `ubuntu-24.04` / `ubuntu-22.04` | ✅ Supported. | +| `ubuntu-24.04-arm` | ✅ Supported. Linux ARM64 runner. | +| `macos-*` | ❌ Not supported. Docker is unavailable on macOS runners (no nested virtualization). See [FAQ](/gh-aw/reference/faq/#why-dont-agentic-workflows-support-macos-runners). | +| `windows-*` | ❌ Not supported. AWF requires Linux. | + ### Workflow Concurrency Control (`concurrency:`) Automatically generates concurrency policies for the agent job. See [Concurrency Control](/gh-aw/reference/concurrency/). From dc9454da451e0a1e2a8f8ad0c1b0d61c33086881 Mon Sep 17 00:00:00 2001 From: Peli de Halleux Date: Sat, 21 Feb 2026 21:10:14 -0800 Subject: [PATCH 2/2] Update frontmatter.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/src/content/docs/reference/frontmatter.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/src/content/docs/reference/frontmatter.md b/docs/src/content/docs/reference/frontmatter.md index 3cd341b690..927c2993a0 100644 --- a/docs/src/content/docs/reference/frontmatter.md +++ b/docs/src/content/docs/reference/frontmatter.md @@ -457,7 +457,7 @@ timeout-minutes: 30 # Defaults to 20 minutes | `ubuntu-latest` | ✅ Default. Recommended for most workflows. | | `ubuntu-24.04` / `ubuntu-22.04` | ✅ Supported. | | `ubuntu-24.04-arm` | ✅ Supported. Linux ARM64 runner. | -| `macos-*` | ❌ Not supported. Docker is unavailable on macOS runners (no nested virtualization). See [FAQ](/gh-aw/reference/faq/#why-dont-agentic-workflows-support-macos-runners). | +| `macos-*` | ❌ Not supported. Docker is unavailable on macOS runners (no nested virtualization). See [FAQ](/gh-aw/reference/faq/). | | `windows-*` | ❌ Not supported. AWF requires Linux. | ### Workflow Concurrency Control (`concurrency:`)