netlify-agent-runner

Run Claude, Codex, or Gemini coding agents remotely on Netlify infrastructure.

Updated Jul 16, 2026
One-click install
npx skills add https://github.com/JamesMitofsky/tag-archive --skill netlify-agent-runner-jamesmitofsky
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: netlify-agent-runner
Source: https://github.com/JamesMitofsky/tag-archive/tree/main/.claude/skills/netlify-agent-runner
Command: npx skills add https://github.com/JamesMitofsky/tag-archive --skill netlify-agent-runner-jamesmitofsky

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Delegating development work to a remote AI agent requires understanding Netlify's agent task model: tasks run against the pushed repository (not local changes), are asynchronous with no completion callbacks, and output lands on a new branch with a Deploy Preview. This Skill encodes those semantics so tasks are created, polled, and reviewed correctly without misusing undocumented APIs. ## Core Features & Use Cases - Remote task creation: Launch Claude, Codex, or Gemini agents via netlify agents:create with prompt, branch, model, and project targeting options. - Task lifecycle management: List, inspect, and stop agent tasks with netlify agents:list, agents:show, and agents:stop, polling until a terminal status (done, error, cancelled). - Safe delegation guardrails: Enforces documented CLI surfaces only, requires explicit user approval before billable runs, and prevents delegating work that depends on unpushed local changes. - Use Case: Get a second opinion from a different model on your implementation by delegating a code review prompt to a remote agent, then polling for its result on a new Deploy Preview branch. ## Quick Start Ask the assistant to run a Netlify agent task, for example: create a remote agent task with the codex agent to audit this site's codebase for accessibility issues, then poll the task until it completes.

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 on my Netlify site?

Use netlify agents:create with a prompt and an agent flag (-a claude, codex, or gemini). The site must be linked via netlify link, or you can pass --project with a project name or ID to target any site without linking.

Which agents does Netlify Agent Runner support?

Netlify agent tasks support three agents: claude, codex, and gemini, selected with the -a or --agent flag on netlify agents:create. You can also pin a specific model with the -m flag.

Why can't the remote Netlify agent see my local changes?

Agent tasks run remotely against the site's connected repository, not your local working tree. Only committed and pushed changes are visible, so commit and push your work before delegating a task that depends on it.

How do I know when a Netlify agent task is finished?

There are no webhooks or callbacks, so you must poll with netlify agents:show <task-id> or netlify agents:list. Keep polling until the status reaches a terminal state: done, error, or cancelled.

Does a Netlify agent task modify my main branch directly?

No. The agent pushes its work to a new branch with its own Deploy Preview, leaving your base branch untouched. Review the results on that new branch before merging anything.

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

Agent runs consume plan credits, so creation is blocked if the account has no available credits or has reached its AI usage limit. This is an account plan-state issue to resolve with Netlify, not something to work around.