{
  "slug": "railway-code-creates-a-fresh-cloud-agent-vm-and-adds-project-selection-7cbe05950b0f",
  "title": "railway code creates a fresh cloud-agent VM and adds project selection",
  "tools": [
    "railway"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-09-15T05:51:57.000Z",
  "announced_at": "2026-09-15T05:51:57.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When starting a Railway coding-agent session for repository work, run `railway code` to open `railway-agent-tui` on a fresh VM. In the picker, press `n` from the main screen or Option+N from an existing VM, session, or focused terminal; use `p` to choose the project and environment, and optionally toggle **Use bootstrap** and press `b` to choose one.",
    "examples": [
      "railway code",
      "railway ca\n# Main screen: press n to open the new-VM picker."
    ],
    "gotchas": [
      "Version: v5.57.2",
      "Cloud Agents access (required): Required to use the cloud-agent commands.",
      "n: Opens the new-VM picker from the `railway ca` main screen.",
      "Option+N: Opens the new-VM picker from an existing session; the picker starts with that VM's project and environment.",
      "p: Selects the project and environment for this VM; the saved default project appears first, and this choice does not change it.",
      "Use bootstrap: Toggle with arrow keys and Enter or click; when enabled, the Select Bootstrap row appears.",
      "b: Opens the bootstrap list from the Select Bootstrap row.",
      "Prerequisite: Cloud Agents access is required.",
      "Bare `railway code` opens `railway-agent-tui` on a new VM.",
      "Piped sessions and agent arguments after `--` use the terminal directly.",
      "The picker starts with the current VM's project and environment when opened from an existing VM, session, or focused terminal.",
      "Choosing a project applies to this VM and does not change the saved default project.",
      "Changing environments clears a named bootstrap selection."
    ]
  },
  "why_it_matters": "When starting a Railway coding-agent session for repository work, launch a fresh VM with the intended project and environment, optionally selecting a bootstrap.",
  "sources": [
    "https://github.com/railwayapp/cli/releases/tag/v5.57.2",
    "https://github.com/railwayapp/cli/pull/1203",
    "https://github.com/railwayapp/cli/blob/v5.57.2/docs/cloud-agents.md"
  ],
  "rank": 0.91048,
  "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": "wave1-20261014",
    "verdict_id": "wave1-20261014:wave1-20261014-cbf118f778eda729-0:gate",
    "evidence_hash": "9b78f5a4837e8d14f380681d8b361358c62f5eee2cb4a2652479cc7003d6e72b"
  },
  "review": {
    "draft_hash": "47466fc24f9f6d7c82fd51915912bf1dcdbde9d6a478d1c98f5c9e4d2a374f28",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave1-20261014:gate",
    "reason": "2 of 3 judge runs approved with p_yes >= 0.9 (mean 0.91 >= 0.9; 2 needed) and Jev gave 0.73 (>= 0.6 needed)."
  }
}