netlify-labs/Netlify Agent Runners
Start Netlify Agent Runners agent runs from GitHub Issues and Pull Requests via @netlify mentions
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Jun 15, 2026
- License
- None
Pinned Snippet
uses: netlify-labs/agent-runner-action@4e06b4897d1d69c619af6a25e00ee65e8cb9c91f # no releases — HEAD as of 2026-07-11tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| netlify-auth-token | Netlify personal access token (NETLIFY_AUTH_TOKEN) | yes | — |
| netlify-site-id | Netlify site ID (NETLIFY_SITE_ID) | yes | — |
| netlify-filter | Netlify CLI monorepo app filter (--filter), for sites with multiple apps | no | "" |
| github-token | GitHub token for API calls (defaults to GITHUB_TOKEN) | no | ${{ github.token }} |
| allowed-users | Comma-separated list of GitHub usernames allowed to trigger agent runs (optional — defaults to repo collaborators) | no | "" |
| default-agent | Default agent to use (claude, codex, or gemini) | no | codex |
| default-model | Backward-compatible alias for default-agent | no | codex |
| manage-labels | Automatically create and apply labels on agent runs (opt-in) | no | false |
| timeout-minutes | Maximum minutes to wait for the agent to complete | no | 10 |
| netlify-cli-version | Netlify CLI version to install (pinned for stability) | no | 24.8.1 |
| dry-run | Preview mode — start an agent run but skip PR creation and commits | no | false |
| preflight-only | Validate setup and exit without creating or resuming an agent run | no | false |
| debug | Enable debug logging of Netlify API responses | no | false |
| timezone | Timezone for displaying dates (IANA format, e.g. America/New_York) | no | America/Los_Angeles |
Outputs
| name | description |
|---|---|
| agent-id | The agent run ID |
| outcome | Agent outcome: success, failure, or timeout |
| agent-result | The agent result summary text |
| agent-pr-url | Pull request URL if the agent created one |
| agent-deploy-url | Deploy preview URL |
| agent | The selected agent |
| model | Backward-compatible alias for agent |
| trigger-text | The cleaned trigger text / prompt |
| is-pr | Whether the trigger came from a PR (true/false) |
| issue-number | The issue or PR number |
| is-dry-run | Whether this was a preview/dry-run (true/false) |
| preflight-ok | Whether preflight checks passed |
| preflight-json | Serialized preflight result payload |
| preflight-summary | Human-readable preflight summary |
| should-continue | Whether workflow should continue into agent execution |
| failure-category | Failure category from preflight or runtime execution |
| failure-stage | Failure stage from preflight or runtime execution |
| agent-error | Sanitized runtime agent error summary |