{
  "slug": "netlify-create-builds-a-project-through-an-agent-runner-886f2a927e01",
  "title": "netlify create builds a project through an agent runner",
  "tools": [
    "netlify"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-03-24T15:05:30.000Z",
  "announced_at": "2026-03-24T15:05:30.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "To create a Netlify project from a natural-language site description, run `netlify create` with the prompt; add `--agent <claude|codex|gemini>` to choose the runner, or `--git github` to create a GitHub repository and push the source.",
    "examples": [
      "netlify create \"<site description>\" --agent <claude|codex|gemini>",
      "netlify create \"<site description>\" --git github"
    ],
    "gotchas": [
      "Version: 24.5.0",
      "prompt (required): Site description; accepted as a positional argument or with `--prompt`.",
      "--agent <type>: Agent type: `claude`, `codex`, or `gemini`.",
      "--git <provider>: Create a Git repository and push source code; example provider: `github`.",
      "--repo-owner <owner>: GitHub org or user to create the repository under.",
      "--account-slug <slug>: Account slug to create the project under.",
      "--name <name>: Project name (subdomain).",
      "--no-download: Skip downloading source after the agent run completes.",
      "--no-wait: Return after starting the agent run, without polling for completion.",
      "--json: Output result as JSON.",
      "The command creates a new Netlify site, starts an AI agent runner that defaults to Claude, polls for completion, downloads generated source locally, and links the project.",
      "`--no-download` skips downloading source code locally.",
      "`--no-wait` returns immediately after starting the agent run.",
      "`--git github` optionally creates a private GitHub repository and pushes the source via Netlify's API."
    ]
  },
  "why_it_matters": "Create a new Netlify project from a natural-language site description.",
  "sources": [
    "https://github.com/netlify/cli/releases/tag/v24.5.0",
    "https://github.com/netlify/cli/pull/8066",
    "https://github.com/netlify/cli/blob/b100657432707e8a080c671154c8319c5f1e2c4a/docs/commands/create.md"
  ],
  "rank": 0.92032,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "wave2a-20261017",
    "verdict_id": "wave2a-20261017:wave2a-20261017-1821a633eb7d5023-2:gate",
    "evidence_hash": "d068ccb027cace0e7b704c4dac942dafcf57ed332ad56bddbe75b2e986bb522f"
  },
  "review": {
    "draft_hash": "3575ce6b0226522f2a0207d6112d592776da316012e897959023b40a7bbdec83",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave2a-20261017:gate",
    "reason": "2 of 3 judge runs approved with p_yes >= 0.9 (mean 0.92 >= 0.9; 2 needed) and Jev gave 0.76 (>= 0.6 needed)."
  }
}