SelectCommitRanges: branch prefix via env + cli arg

Author: magus

README.md

@@ -83,6 +83,19 @@ To update your local branch with the latest changes in the remote branch (e.g. `
 git stack rebase
 ```
 
+### Customizing branch name
+
+By default `git stack` generates a unique branch name such as `gs-3cmrMBSUj`.
+
+You can specify a prefix for the generated branch name by using either the environment variable or the command line option.
+In the example below branches would be generated such as `dev/magus/gs-3cmrMBSUj`.
+
+```bash
+GIT_STACK_BRANCH_PREFIX="dev/magus/" git stack
+
+git stack --branch-prefix="dev/magus/"
+```
+
 ## Why?
 
 The goal of `git stack` is to combine the **simplicity of developing in a single branch** in order to **preserve your commit history** while also **grouping commits into pull requests for code review**.

src/app/SelectCommitRanges.tsx

@@ -387,8 +387,21 @@ function SelectCommitRangesInternal(props: Props) {
     </Ink.Box>
   );
 
+  function get_group_id() {
+    let branch_prefix = "";
+
+    // branch prefix via cli flag or env var
+    // cli flag takes precedence since it is more explicit
+    if (argv["branch-prefix"]) {
+      branch_prefix = argv["branch-prefix"];
+    } else if (process.env.GIT_STACK_BRANCH_PREFIX) {
+      branch_prefix = process.env.GIT_STACK_BRANCH_PREFIX;
+    }
+
+    return `${branch_prefix}${gs_short_id()}`;
+  }
   function submit_group_input(title: string) {
-    const id = gs_short_id();
+    const id = get_group_id();
 
     actions.output(
       <FormatText

src/command.ts

@@ -111,6 +111,12 @@ const DefaultOptions = {
     description: "Open all PRs as drafts",
   },
 
+  "branch-prefix": {
+    type: "string",
+    default: "",
+    description: "Prefix for generated branch names, e.g. dev/magus/",
+  },
+
   "template": {
     type: "boolean",
     default: true,

src/types/global.d.ts

@@ -5,5 +5,6 @@ declare namespace NodeJS {
     CLI_VERSION?: string;
     GIT_STACK_STANDALONE?: "true" | "false";
     GIT_SEQUENCE_EDITOR_SCRIPT?: string;
+    GIT_STACK_BRANCH_PREFIX?: string;
   }
 }