{
  "slug": "pulumi-neo-local-agent-workflow-and-tui-952f22a853df",
  "title": "pulumi neo local agent workflow and TUI",
  "tools": [
    "pulumi"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-04-23T02:56:27.000Z",
  "announced_at": "2026-04-23T02:56:27.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When a repository task needs local agent inspection or edits, authenticate with `pulumi login` and run `pulumi neo` from a directory containing `Pulumi.yaml` with `PULUMI_EXPERIMENTAL=true`. Use the TUI to direct the task; press Shift+Tab before the first message to enable plan mode, and press Esc during a turn to request cancellation.",
    "examples": [
      "PULUMI_EXPERIMENTAL=true pulumi neo"
    ],
    "gotchas": [
      "Version: v3.232.0",
      "Availability: Experimental; hidden behind PULUMI_EXPERIMENTAL.",
      "PULUMI_EXPERIMENTAL (required): Set to `true` to enable experimental commands and options.",
      "prompt: Optional positional prompt; without one, the TUI starts and waits for the first message.",
      "Shift+Tab: Toggles plan mode; enable it before sending the first message. Approving the proposed plan exits plan mode automatically.",
      "Esc: During a turn, requests agent cancellation.",
      "Prerequisite: Authenticate to Pulumi Cloud with `pulumi login`; run `pulumi neo` from a directory containing `Pulumi.yaml`.",
      "Prerequisite: Set `PULUMI_EXPERIMENTAL=true` to enable experimental commands.",
      "Plan mode must be set before the first message because it is task-level on the wire.",
      "Approving the proposed plan exits plan mode automatically.",
      "The TUI prompts for approval when the agent requests confirmation for a sensitive action and forwards the response to the Pulumi Console.",
      "Filesystem and shell tool calls run on the user's machine in their working directory.",
      "The edit tool creates a new file when the target is missing and old_string is empty.",
      "Docs conflict: The current generated command reference is for Pulumi CLI v3.268.0, newer than the card's v3.232.0; its additional options are not included here."
    ]
  },
  "why_it_matters": "For a repository task that needs a local agent to inspect or edit files and propose changes, start `pulumi neo` and use its terminal UI to direct the task.",
  "sources": [
    "https://github.com/pulumi/pulumi/releases/tag/v3.232.0",
    "https://www.pulumi.com/docs/ai/neo/pulumi-cli/",
    "https://www.pulumi.com/docs/iac/cli/environment-variables/",
    "https://www.pulumi.com/docs/iac/cli/commands/pulumi_neo/"
  ],
  "rank": 0.93022,
  "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": "wave1b-20261016",
    "verdict_id": "wave1b-20261016:wave1b-20261016-3ad5e6857878575b-0:gate",
    "evidence_hash": "a014ba5dd146dfb70d5698c4bf27b214ac77fc9694c7f5de785a6d1665f097bc"
  },
  "review": {
    "draft_hash": "ab088734c71e9ef9286482215d4b9719a0d726c69446d7d3a4772ad5ad16e191",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave1b-20261016:gate",
    "reason": "2 of 3 judge runs approved with p_yes >= 0.9 (mean 0.93 >= 0.9; 2 needed) and Jev gave 0.71 (>= 0.6 needed)."
  }
}