Netlify Agent Runner

Run AI coding agents (Claude, Codex, Gemini) remotely on Netlify infrastructure to automate development tasks on your site.

Prerequisites

The site must be linked to a Netlify project (via netlify link or netlify init), or you can specify --project <name> to target any Netlify site
The Netlify CLI must be installed and authenticated

Read this before creating a task — agent tasks behave differently from running an agent locally, and the differences are easy to miss.

Remote, not local. Tasks run on Netlify infrastructure, not on your machine. They operate on the site's connected repository, not your local working tree. The remote agent only sees what has been pushed to the remote — it cannot see uncommitted or unpushed changes.
Branch-based. By default a task runs against the production branch (main or master). To target a different branch, use -b <branch> and make sure that branch has been pushed to the remote first, or the agent will be working from code that doesn't exist remotely.
Asynchronous. netlify agents:create returns as soon as the task is queued — it does not block until the work is finished. When the command returns, the task is still running remotely.
No webhooks or callbacks. Nothing notifies you when a task changes state or completes. To find out what's happening, you have to poll with netlify agents:show <task-id> or netlify agents:list.
Statuses are terminal or not. A task moves through new → running → one of done, error, or cancelled. Keep polling until the status is one of those last three before you act on the results.