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 skip linking entirely: pass --project <name> (a project ID or name) directly to netlify agents:create to target any Netlify site without linking first.
• The Netlify CLI must be installed and authenticated
• Agent runs consume plan credits. If the account has no available credits — or the agent/AI usage limit has been reached — netlify agents:create is blocked and the run won't start. That's an account/plan-state issue to surface to the user, not something to work around.

Use only documented CLI surfaces

Interact with agent tasks only through the documented netlify agents:* commands (plus netlify --help and the public CLI reference). Do not go around the CLI:

• Do not curl https://api.netlify.com/... to fetch, create, or stop a task — the endpoint shapes are not part of the public contract.
• Do not run netlify api <method> as a recovery hatch when a documented command fails.
• Do not read auth tokens out of ~/Library/Preferences/netlify/config.json (or anywhere on disk) to authenticate side-channel calls.