netlify-agent-runner

Run Claude, Codex, or Gemini agent tasks remotely on Netlify infrastructure.

Updated May 19, 2026
One-click install
npx skills add https://github.com/costrict-plugins-repo/anthropic-netlify-skills --skill netlify-agent-runner-costrict-plugins-repo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: netlify-agent-runner
Source: https://github.com/costrict-plugins-repo/anthropic-netlify-skills/tree/main/codex/skills/netlify-agent-runner
Command: npx skills add https://github.com/costrict-plugins-repo/anthropic-netlify-skills --skill netlify-agent-runner-costrict-plugins-repo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Delegating development work to a remote AI agent on Netlify involves non-obvious behavior: tasks run against the pushed repository rather than local changes, results land on a new branch with a Deploy Preview, and there are no completion callbacks. This Skill prevents misuse of the netlify agents:* CLI commands and ensures tasks are created, polled, and reviewed correctly. ## Core Features & Use Cases - Remote task creation: Queue agent tasks with netlify agents:create using Claude, Codex, or Gemini, with branch, model, and project targeting options. - Task lifecycle management: List, inspect, and stop tasks with netlify agents:list, agents:show, and agents:stop, polling until a terminal status (done, error, cancelled). - Safe delegation guardrails: Enforces explicit user approval before billable runs and restricts interaction to documented CLI commands only. - Use Case: Ask the agent to get a second opinion on your authentication logic from a different model; it proposes the exact netlify agents:create command, waits for your approval, queues the task, and polls for the result on the new branch. ## Quick Start Ask the agent to run a remote task on your Netlify site, for example: create an agent task with the codex agent to add end-to-end tests to my linked Netlify project.

Frequently Asked Questions about netlify-agent-runner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run an AI agent remotely on my Netlify site?

Use `netlify agents:create "<prompt>" -a <agent>` with claude, codex, or gemini. The site must be linked via `netlify link` or targeted with `--project <name>`, and the CLI must be authenticated.

How do I check the status of a Netlify agent task?

Poll with `netlify agents:show <task-id>` or list tasks with `netlify agents:list`. There are no webhooks or callbacks, so keep polling until the status reaches done, error, or cancelled.

Does the Netlify agent runner work on my local uncommitted changes?

No. Tasks run remotely against the site's connected repository and only see code pushed to the remote. Commit and push your changes first, or finish local work yourself before delegating.

Where do Netlify agent task results get committed?

The agent pushes its work to a new branch with its own Deploy Preview, not onto the base branch you selected. Review results on that new branch; your main branch is never overwritten.

Why did netlify agents:create fail to start a task?

Agent runs consume plan credits, so the command is blocked if the account has no available credits or has reached its agent usage limit. This is an account plan-state issue to surface to the user, not something to work around.