From fb7631a96ada0ecfb376bbc6f1f1ca9fee5897ed Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Fri, 24 Jul 2026 00:05:24 +0000 Subject: [PATCH] [docs] Add engine.extensions section to concise frontmatter reference Closes #47307 Closes #47083 Co-Authored-By: Claude --- docs/src/content/docs/reference/frontmatter.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/src/content/docs/reference/frontmatter.md b/docs/src/content/docs/reference/frontmatter.md index 718ed370e0f..a7db7fd7ea7 100644 --- a/docs/src/content/docs/reference/frontmatter.md +++ b/docs/src/content/docs/reference/frontmatter.md @@ -161,6 +161,18 @@ engine: driver: .github/drivers/custom-copilot-driver.js ``` +### Engine Extensions (`engine.extensions:`) + +Lists engine-specific plugins to install before the agent runs. Only the Pi engine reads this field; each entry is an npm package name passed to `pi install `. Other engines ignore it. See [Pi Extensions](/gh-aw/reference/engines/#pi-extensions-extensions) for details. + +```yaml wrap +engine: + id: pi + extensions: + - "@pi/web-search" + - "@pi/file-browser" +``` + ### Network Permissions (`network:`) Controls network access using ecosystem identifiers and domain allowlists. See [Network Permissions](/gh-aw/reference/network/) for full documentation.