{
  "slug": "railway-usage-adds-workspace-usage-and-limit-commands-908890b8f83b",
  "title": "railway usage adds workspace usage and limit commands",
  "tools": [
    "railway"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-07-08T09:18:25.000Z",
  "announced_at": "2026-07-08T09:18:25.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "Inspect workspace or project usage for the linked or selected workspace and billing period. Manage compute limits with `railway usage limit` commands; current docs require `--target workspace` when setting limits.",
    "examples": [
      "railway usage --workspace <workspace> --period <current|previous|YYYY-MM> --json",
      "railway usage projects --project <project> --workspace <workspace> --period <current|previous|YYYY-MM> --json",
      "railway usage limit set --target workspace --soft <dollars> --hard <dollars> --workspace <workspace> --json"
    ],
    "gotchas": [
      "Version: v5.25.0",
      "--workspace <WORKSPACE>: Workspace name or ID; defaults to the linked project's workspace, or prompts/selects when unlinked.",
      "--period <PERIOD>: Usage period: `current`, `previous`, or `YYYY-MM`; defaults to `current`. Only applies to summaries and project breakdowns.",
      "--json: Output in JSON format.",
      "--project <PROJECT>: Show service-level usage for one project name or ID; cannot be combined with `--limit`.",
      "--limit <COUNT>: Maximum projects returned; cannot be combined with `--project`.",
      "--target workspace (required): Selects compute usage limits for `limit set`; current docs also document `workspace` and `agent` targets for status.",
      "--soft <DOLLARS>: Workspace compute email alert: `0` or a whole-dollar value from $5 to $500,000. When both thresholds are nonzero, hard must be at least soft.",
      "--hard <DOLLARS>: Workspace compute hard limit: `0` or a whole-dollar value from $10 to $500,000. When both thresholds are nonzero, hard must be at least soft.",
      "--yes: Confirms limit removal; required in non-interactive sessions.",
      "Prerequisite: A workspace admin is required to configure usage limits.",
      "The period may be current, previous, or YYYY-MM.",
      "Docs conflict: Current docs require `--target workspace` for `limit set`, but the v5.25.0 release-note syntax omits `--target`; current docs also describe agent targets and usage limits not mentioned in the release note. Verify the installed CLI version before relying on the newer syntax."
    ]
  },
  "why_it_matters": "Inspect usage and compute limits for a Railway workspace or project associated with the repository.",
  "sources": [
    "https://github.com/railwayapp/cli/releases/tag/v5.25.0",
    "https://github.com/railwayapp/cli/pull/1001",
    "https://docs.railway.com/cli/usage",
    "https://docs.railway.com/pricing/cost-control"
  ],
  "rank": 0.9103,
  "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-4136a100c3fbea26-0:gate",
    "evidence_hash": "e239909291e9d38f890660cfaec9b8c41f7be3c7cdccf6fd9302115205e9da02"
  },
  "review": {
    "draft_hash": "a1841f6975ec0a7485f70516d922769a1f2f4c87de77b678d34288a6eab4388d",
    "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.91 >= 0.9; 2 needed) and Jev gave 0.78 (>= 0.6 needed)."
  }
}