Skip to content

Netlify CLI agents command

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

Terminal window
netlify agents

Flags

  • filter (string) - For monorepos, specify the name of the application to run the command in
  • debug (boolean) - Print debugging information
  • auth (string) - Netlify auth token - can be used to run this command without logging in
Subcommanddescription
agents:createCreate and run a new agent task on your site
agents:listList agent tasks for the current site
agents:showShow details of a specific agent task
agents:stopStop a running agent task

Examples

Terminal window
netlify agents:create --prompt "Add a contact form"
netlify agents:list --status running
netlify agents:show 60c7c3b3e7b4a0001f5e4b3a

Create and run a new agent task on your site

Usage

Terminal window
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 on
  • filter (string) - For monorepos, specify the name of the application to run the command in
  • json (boolean) - output result as JSON
  • model (string) - model to use for the agent
  • project (string) - project ID or name (if not in a linked directory)
  • prompt (string) - agent prompt
  • debug (boolean) - Print debugging information
  • auth (string) - Netlify auth token - can be used to run this command without logging in

Examples

Terminal window
netlify agents:create
netlify agents:create "Fix the login bug"
netlify agents:create --prompt "Add dark mode" --agent claude
netlify agents:create -p "Update README" -a codex -b feature-branch
netlify agents:create "Add tests" --project my-site-name

List agent tasks for the current site

Usage

Terminal window
netlify agents:list

Flags

  • filter (string) - For monorepos, specify the name of the application to run the command in
  • json (boolean) - output result as JSON
  • project (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 information
  • auth (string) - Netlify auth token - can be used to run this command without logging in

Examples

Terminal window
netlify agents:list
netlify agents:list --status running
netlify agents:list --json

Show details of a specific agent task

Usage

Terminal window
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 in
  • json (boolean) - output result as JSON
  • project (string) - project ID or name (if not in a linked directory)
  • debug (boolean) - Print debugging information
  • auth (string) - Netlify auth token - can be used to run this command without logging in

Examples

Terminal window
netlify agents:show 60c7c3b3e7b4a0001f5e4b3a
netlify agents:show 60c7c3b3e7b4a0001f5e4b3a --json

Stop a running agent task

Usage

Terminal window
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 in
  • json (boolean) - output result as JSON
  • project (string) - project ID or name (if not in a linked directory)
  • debug (boolean) - Print debugging information
  • auth (string) - Netlify auth token - can be used to run this command without logging in

Examples

Terminal window
netlify agents:stop 60c7c3b3e7b4a0001f5e4b3a