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
(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
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.
Show more
Installs
908
Repository
netlify/context…nd-tools
GitHub Stars
32
First Seen
Jun 24, 2026
Security Audits
Gen Agent Trust Hub
Pass
Socket
Pass
Snyk
Pass