{
  "slug": "supabase-cli-adds-branches-switch-command-171d8f9495fd",
  "title": "Supabase CLI adds branches switch command",
  "tools": [
    "supabase"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-05-18T09:29:21.000Z",
  "announced_at": "2026-05-18T09:29:21.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When repository work needs a different Supabase branch, run `supabase branches switch <name>` (or provide its project ref). It updates the active branch in `.supabase/project.json`; a running local Supabase stack is stopped and restarted for that branch.",
    "examples": [
      "supabase branches switch <branch-name>",
      "supabase branches switch <project-ref>"
    ],
    "gotchas": [
      "Version: 2.99.0",
      "<name>: Branch name or project ref. If omitted in an interactive TTY, prompts to select a branch; without a TTY, omission fails.",
      "Docs conflict: Current Supabase CLI reference lists branches subcommands but omits `branches switch`, differing from the v2.99.0 command documented in its source commit: https://supabase.com/docs/reference/cli/global-flags"
    ]
  },
  "why_it_matters": "Switch the Supabase branch used for repository work.",
  "before": "Before this command, `supabase branches list` showed the active branch but the CLI had no way to change it.",
  "sources": [
    "https://github.com/supabase/cli/releases/tag/v2.99.0",
    "https://github.com/supabase/cli/commit/5906132e91b2b76f2672a0a764f1f5dead0c3c64"
  ],
  "rank": 0.92031,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v1+judge-v2x3-rejudge+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "backfill-20261007",
    "verdict_id": "backfill-20261007:backfill-20261007-35d025ad8d890b24-6:rescue",
    "evidence_hash": "bbf38a7e39f45a5efaa0a23b582e23fb73d868ff142d7de508e4782230d003e4"
  },
  "review": {
    "draft_hash": "cbcc707eb7a8b36a405f2149816f7c1633f9000d02d818a6fc6c70116b0af453",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "backfill-20261007:rescue",
    "reason": "Rescue path: first rejected only because the extracted card lacked usage; judged again on the enriched card, 2 of 3 judge runs approved with p_yes >= 0.9 (mean 0.92 >= 0.9; 2 needed) and Jev gave 0.73 (>= 0.6 needed)."
  }
}
