Netlify CLI agents command
agents
Section titled “agents”Manage Netlify AI agent tasks
The agents
command will help you run AI agents on your Netlify sites to automate development tasks
Note: Agent tasks execute remotely on Netlify infrastructure, not locally.
Usage
netlify agents
Flags
filter
(string) - For monorepos, specify the name of the application to run the command indebug
(boolean) - Print debugging informationauth
(string) - Netlify auth token - can be used to run this command without logging in
Subcommand | description |
---|---|
agents:create | Create and run a new agent task on your site |
agents:list | List agent tasks for the current site |
agents:show | Show details of a specific agent task |
agents:stop | Stop a running agent task |
Examples
netlify agents:create --prompt "Add a contact form"netlify agents:list --status runningnetlify agents:show 60c7c3b3e7b4a0001f5e4b3a
agents:create
Section titled “agents:create”Create and run a new agent task on your site
Usage
netlify agents:create
Arguments
- prompt - the prompt for the agent to execute
Flags
agent
(string) - agent type (claude, codex, gemini)branch
(string) - git branch to work onfilter
(string) - For monorepos, specify the name of the application to run the command injson
(boolean) - output result as JSONmodel
(string) - model to use for the agentproject
(string) - project ID or name (if not in a linked directory)prompt
(string) - agent promptdebug
(boolean) - Print debugging informationauth
(string) - Netlify auth token - can be used to run this command without logging in
Examples
netlify agents:createnetlify agents:create "Fix the login bug"netlify agents:create --prompt "Add dark mode" --agent claudenetlify agents:create -p "Update README" -a codex -b feature-branchnetlify agents:create "Add tests" --project my-site-name
agents:list
Section titled “agents:list”List agent tasks for the current site
Usage
netlify agents:list
Flags
filter
(string) - For monorepos, specify the name of the application to run the command injson
(boolean) - output result as JSONproject
(string) - project ID or name (if not in a linked directory)status
(string) - filter by status (new, running, done, error, cancelled)debug
(boolean) - Print debugging informationauth
(string) - Netlify auth token - can be used to run this command without logging in
Examples
netlify agents:listnetlify agents:list --status runningnetlify agents:list --json
agents:show
Section titled “agents:show”Show details of a specific agent task
Usage
netlify agents:show
Arguments
- id - agent task ID to show
Flags
filter
(string) - For monorepos, specify the name of the application to run the command injson
(boolean) - output result as JSONproject
(string) - project ID or name (if not in a linked directory)debug
(boolean) - Print debugging informationauth
(string) - Netlify auth token - can be used to run this command without logging in
Examples
netlify agents:show 60c7c3b3e7b4a0001f5e4b3anetlify agents:show 60c7c3b3e7b4a0001f5e4b3a --json
agents:stop
Section titled “agents:stop”Stop a running agent task
Usage
netlify agents:stop
Arguments
- id - agent task ID to stop
Flags
filter
(string) - For monorepos, specify the name of the application to run the command injson
(boolean) - output result as JSONproject
(string) - project ID or name (if not in a linked directory)debug
(boolean) - Print debugging informationauth
(string) - Netlify auth token - can be used to run this command without logging in
Examples
netlify agents:stop 60c7c3b3e7b4a0001f5e4b3a