feat(cli): add --git-branch flag to branches create command#5250
Merged
Conversation
Exposes the v1 API's git_branch field on `supabase branches create` in the next shell. When provided, it overrides the git branch detected from the local environment so users can explicitly associate a git branch independent of the new branch's name.
Adds a --git-branch flag on `supabase branches create` in the Go CLI and forwards it through the legacy TS proxy. When provided, the flag takes precedence over the git branch auto-detected from the local working directory.
Coverage Report for CI Build 27128097286Coverage decreased (-0.02%) to 63.982%Details
Uncovered ChangesNo uncovered changes found. Coverage Regressions36 previously-covered lines in 3 files lost coverage.
Coverage Stats
💛 - Coveralls |
…nch-option-JZJjz # Conflicts: # apps/cli/src/legacy/commands/branches/create/SIDE_EFFECTS.md # apps/cli/src/legacy/commands/branches/create/create.handler.ts
Supabase CLI previewnpx --yes https://pkg.pr.new/supabase@5250Preview package for commit |
jgoux
approved these changes
Jun 8, 2026
mxcl
pushed a commit
to automic-vault/supabase-cli
that referenced
this pull request
Jun 11, 2026
…#5250) Adds support for explicitly specifying a git branch to associate with a new preview branch via the `--git-branch` flag in the `supabase branches create` command. ## Changes - **TypeScript CLI (next)**: Added `gitBranch` flag to the `create` command config with optional string value. The flag prefers explicitly provided values over auto-detected git branches from environment variables. - **TypeScript CLI (legacy)**: Added `gitBranch` flag to the legacy branches create command for backward compatibility. - **Go CLI**: Added `--git-branch` flag support to the branches create command, respecting explicit values over auto-detected branches. - **API integration**: Updated the branch creation API request to include the `git_branch` field when provided. - **Documentation**: Updated `SIDE_EFFECTS.md` to reflect the new `git_branch` parameter in the API request body and added the flag to the documented command flags. - **Tests**: Added integration test coverage for the new flag and verified that explicit `--git-branch` values take precedence over auto-detected branches. ## Implementation Details The implementation follows a preference hierarchy: explicitly provided `--git-branch` flag values take precedence over auto-detected git branches (from `GITHUB_HEAD_REF` or local git state). This allows users to override auto-detection when needed while maintaining backward compatibility for existing workflows that rely on auto-detection. https://claude.ai/code/session_01Vsgo83p6eooc7QUXuZXJVx Closes: CLI-1465 --------- Co-authored-by: Claude <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds support for explicitly specifying a git branch to associate with a new preview branch via the
--git-branchflag in thesupabase branches createcommand.Changes
gitBranchflag to thecreatecommand config with optional string value. The flag prefers explicitly provided values over auto-detected git branches from environment variables.gitBranchflag to the legacy branches create command for backward compatibility.--git-branchflag support to the branches create command, respecting explicit values over auto-detected branches.git_branchfield when provided.SIDE_EFFECTS.mdto reflect the newgit_branchparameter in the API request body and added the flag to the documented command flags.--git-branchvalues take precedence over auto-detected branches.Implementation Details
The implementation follows a preference hierarchy: explicitly provided
--git-branchflag values take precedence over auto-detected git branches (fromGITHUB_HEAD_REFor local git state). This allows users to override auto-detection when needed while maintaining backward compatibility for existing workflows that rely on auto-detection.https://claude.ai/code/session_01Vsgo83p6eooc7QUXuZXJVx
Closes: CLI-1465