{
  "slug": "railway-ca-adds-flat-agent-lifecycle-commands-fa4004172941",
  "title": "railway ca adds flat agent lifecycle commands",
  "tools": [
    "railway"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-08-09T07:52:57.000Z",
  "announced_at": "2026-08-09T07:52:57.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When you need to manage a Railway cloud agent from the CLI, use `railway ca list`, `create`, `ssh`, `wake`, `sleep`, or `delete` for the matching operation. Select agents by name or ID; `create` provisions a VM without connecting, and `ssh` never creates one.",
    "examples": [
      "railway ca list\nrailway ca list --json",
      "railway ca create <agent-name> --project <project-id> --environment <environment-name>\nrailway ca ssh <agent-name> -- bash",
      "railway ca wake <agent-name>\nrailway ca sleep <agent-name>\nrailway ca delete <agent-name>"
    ],
    "gotchas": [
      "Version: v5.35.0",
      "<agent-name> or <agent-id>: Select an existing agent for lifecycle commands. Omit to use the directory’s agent or the only agent, when unambiguous.",
      "--project <project-id>: Select the project for creation. Otherwise Railway uses the linked project or saved default.",
      "--environment <environment-name>: Select the environment for creation. Otherwise Railway uses the linked environment or saved default.",
      "--json: Output the agent list in JSON format.",
      "-- bash: Run a plain shell over SSH.",
      "--session <name>: Select a terminal session to attach to.",
      "--variable <key=value>: Set creation-time variables; repeatable and overrides matching environment-file entries.",
      "--env-file <path>: Load creation-time variables from a file; repeatable.",
      "--no-wait: Not found in the official documentation checked.",
      "--keep-awake: Current docs say this remains accepted for compatibility and is no longer needed; current behavior differs from the release note’s description.",
      "--all: Sleep every running agent you own; current docs also describe narrowing the scope with an environment filter.",
      "-y: Skip the delete confirmation; not documented on the current page checked.",
      "ls, new, connect, rm: Aliases named in the release note; not documented on the current page checked.",
      "Prerequisite: Enable Cloud Agents in Priority Boarding.",
      "Prerequisite: Install the Railway CLI and sign in with `railway login`.",
      "`ca list` can narrow with `-e`; `--all` includes teammates’ agents; `--json` is available for scripts.",
      "`ca create` creates an agent VM without connecting to it; it accepts `--variable`, `--env-file`, `--no-wait`, and `--json`.",
      "`ca ssh` attaches to an agent’s durable session; `-- bash` requests a plain shell, `--session` selects a session, and `--keep-awake` skips sleep-on-disconnect.",
      "`ca wake` waits for RUNNING.",
      "`ca sleep` stops compute billing while keeping the disk; `--all` targets every running agent you own.",
      "`ca delete` destroys the agent and its disk, with confirmation unless `-y` is used.",
      "Docs conflict: Current docs say `--keep-awake` is retained for compatibility and is no longer needed; the release note says it skips sleep-on-disconnect. Current docs may describe behavior newer than v5.35.0."
    ]
  },
  "why_it_matters": "From a repository directory, list, create, connect to, wake, sleep, or delete a cloud agent without relying on the interactive agent flow.",
  "sources": [
    "https://github.com/railwayapp/cli/releases/tag/v5.35.0",
    "https://github.com/railwayapp/cli/pull/1064",
    "https://docs.railway.com/cloud-agents/manage",
    "https://docs.railway.com/cloud-agents/configuration",
    "https://docs.railway.com/cloud-agents/quickstart"
  ],
  "rank": 0.96047,
  "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-f820861369f98996-1:gate",
    "evidence_hash": "30213ba710d3df3b355ab2729b71a27f90023819fd9773af8929bfb0803477cb"
  },
  "review": {
    "draft_hash": "3cb10bfccce85970a30a0347013c221af864d6b5b1d3cfb5d14fbf66291d8a73",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave1b-20261016:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.96 >= 0.9; 2 needed) and Jev gave 0.79 (>= 0.6 needed)."
  }
}