@errhythm/gitmux 1.6.2

package/src/main.js

@@ -0,0 +1,418 @@
+import { basename } from "path";
+import { execSync } from "child_process";
+import chalk from "chalk";
+import boxen from "boxen";
+import { input, confirm, select } from "@inquirer/prompts";
+
+import { VERSION, DEFAULT_DEPTH, SUBCOMMANDS } from "./constants.js";
+import { findRepos } from "./git/core.js";
+import { getSwitchBranchSuggestions } from "./git/templates.js";
+import { loadConfig, saveConfig } from "./config/index.js";
+import { printLogo, printHelp, printAbout } from "./ui/print.js";
+import { p, THEME } from "./ui/theme.js";
+import { colorBranch } from "./ui/colors.js";
+import { cmdStatus } from "./commands/status.js";
+import { cmdFetch } from "./commands/fetch.js";
+import { cmdSwitch } from "./commands/switch.js";
+import { cmdMr } from "./commands/mr.js";
+import { cmdPortal } from "./commands/portal.js";
+import { cmdSettings } from "./commands/settings.js";
+
+// ── Dependency checks ─────────────────────────────────────────────────────────
+
+function checkRequiredDeps() {
+  // git — required by every command
+  try { execSync("git --version", { stdio: "pipe" }); } catch {
+    const isMac   = process.platform === "darwin";
+    const isWin   = process.platform === "win32";
+    const isLinux = process.platform === "linux";
+
+    const installLines = isMac
+      ? p.muted("  brew   ") + p.cyan("brew install git") + "\n" +
+        p.muted("  direct ") + p.cyan("https://git-scm.com/download/mac")
+      : isWin
+      ? p.muted("  winget ") + p.cyan("winget install --id Git.Git") + "\n" +
+        p.muted("  direct ") + p.cyan("https://git-scm.com/download/win")
+      : isLinux
+      ? p.muted("  apt    ") + p.cyan("sudo apt install git") + "\n" +
+        p.muted("  dnf    ") + p.cyan("sudo dnf install git") + "\n" +
+        p.muted("  pacman ") + p.cyan("sudo pacman -S git")
+      : p.muted("  ") + p.cyan("https://git-scm.com/downloads");
+
+    console.log(
+      boxen(
+        chalk.bold(p.red("git not found")) + "\n\n" +
+        p.white("gitmux requires git. Install it:\n\n") +
+        installLines,
+        {
+          padding:        { top: 1, bottom: 1, left: 3, right: 3 },
+          borderStyle:    "round",
+          borderColor:    "#f87171",
+          title:          p.red(" missing dependency: git "),
+          titleAlignment: "center",
+        },
+      ),
+    );
+    process.exit(1);
+  }
+}
+
+// ── Argument parser ───────────────────────────────────────────────────────────
+
+// Options that take a value argument
+const VALUE_OPTIONS = new Set([
+  "--depth", "--exclude", "--filter",
+  // mr
+  "--target", "-t", "--repo", "--title", "--description", "--labels",
+  // portal
+  "--epic", "--issue-project", "--issue-title", "--issue-description",
+  "--issue-labels", "--branch-name", "--base-branch",
+]);
+
+function parseArgs(rawArgs) {
+  const flags = new Set();
+  const options = {};
+  const positional = [];
+  // Multi-value: --repo can appear multiple times
+  const repos = [];
+
+  for (let i = 0; i < rawArgs.length; i++) {
+    const arg = rawArgs[i];
+
+    if (VALUE_OPTIONS.has(arg) && rawArgs[i + 1] !== undefined) {
+      const key = arg.replace(/^-+/, "").replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+      if (arg === "--repo") {
+        repos.push(rawArgs[++i]);
+      } else {
+        options[key] = rawArgs[++i];
+      }
+    } else if (arg.includes("=") && arg.startsWith("--")) {
+      const eqIdx = arg.indexOf("=");
+      const key = arg.slice(2, eqIdx).replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+      options[key] = arg.slice(eqIdx + 1);
+    } else if (!arg.startsWith("--") && arg.startsWith("-") && arg.length > 2 && arg !== "-t") {
+      for (const c of arg.slice(1)) flags.add(`-${c}`);
+    } else if (arg.startsWith("-")) {
+      flags.add(arg);
+    } else {
+      positional.push(arg);
+    }
+  }
+
+  const first = positional[0] ?? "";
+  const isSubcmd = SUBCOMMANDS.has(first);
+
+  return {
+    // ── Core ────────────────────────────────────────────────────────────────
+    subcommand: isSubcmd ? first : null,
+    branch: isSubcmd ? (positional[1] ?? "") : first,
+
+    // ── Switch flags ────────────────────────────────────────────────────────
+    pull:     flags.has("--pull")    || flags.has("-p"),
+    fuzzy:    flags.has("--fuzzy")   || flags.has("-f"),
+    create:   flags.has("--create")  || flags.has("-c"),
+    stash:    flags.has("--stash")   || flags.has("-s"),
+    fetch:    flags.has("--fetch"),
+    dryRun:   flags.has("--dry-run"),
+
+    // ── Global ──────────────────────────────────────────────────────────────
+    version:  flags.has("--version") || flags.has("-v"),
+    help:     flags.has("--help")    || flags.has("-h"),
+    settings: flags.has("--settings"),
+    debug:    flags.has("--debug"),
+    yes:      flags.has("--yes")     || flags.has("-y"),
+    depth:    parseInt(options.depth ?? String(DEFAULT_DEPTH), 10) || DEFAULT_DEPTH,
+    exclude:  options.exclude ?? null,
+    filter:   options.filter ?? null,
+
+    // ── MR flags ─────────────────────────────────────────────────────────────
+    // --target / -t <branch>  — MR target branch
+    target:      options.target ?? options.t ?? null,
+    // --repo <name>  (repeatable) — restrict MR to these repos
+    mrRepos:     repos.length > 0 ? repos : null,
+    // --title / --description / --labels — MR or issue metadata
+    title:       options.title       ?? null,
+    description: options.description ?? null,
+    labels:      options.labels      ?? null,
+    // --draft  — mark MR as draft
+    draft:       flags.has("--draft"),
+    // --no-push  — skip git push before MR
+    noPush:      flags.has("--no-push"),
+
+    // ── Portal flags ──────────────────────────────────────────────────────────
+    // --epic <iid>  — select epic by IID non-interactively
+    epic:             options.epic             ?? null,
+    // --checkout  — run epic checkout without menus
+    checkout:         flags.has("--checkout"),
+    // --create-mr  — create bulk MRs for epic without menus
+    createMr:         flags.has("--create-mr"),
+    // --create-issue  — go straight to issue creation
+    createIssue:      flags.has("--create-issue"),
+    // --review  — run cr review on all primary branches of the epic
+    review:           flags.has("--review"),
+    // Issue creation params
+    issueProject:     options.issueProject     ?? null,
+    issueTitle:       options.issueTitle       ?? null,
+    issueDescription: options.issueDescription ?? null,
+    issueLabels:      options.issueLabels      ?? null,
+    branchName:       options.branchName       ?? null,
+    baseBranch:       options.baseBranch       ?? null,
+  };
+}
+
+// ── Entry point ───────────────────────────────────────────────────────────────
+
+export async function main() {
+  process.on("SIGINT", () => { console.log("\n\n" + p.muted("  Interrupted.") + "\n"); process.exit(0); });
+  process.on("SIGTERM", () => { console.log("\n\n" + p.muted("  Terminated.") + "\n"); process.exit(0); });
+
+  const opts = parseArgs(process.argv.slice(2));
+  if (opts.debug) process.env.GITMUX_DEBUG = "1";  // set before any module uses it
+  const config = loadConfig();
+
+  if (opts.version) {
+    console.log(`gitmux v${VERSION}`);
+    return 0;
+  }
+
+  if (opts.help) {
+    printHelp();
+    return 0;
+  }
+
+  if (opts.subcommand === "about") {
+    printAbout();
+    return 0;
+  }
+
+  process.stdout.write("\x1Bc");
+  printLogo();
+  checkRequiredDeps();
+
+  const cwd = process.cwd();
+  let repos = findRepos(cwd, opts.depth);
+
+  if (repos.length === 0) {
+    console.log(
+      boxen(p.red("No git repositories found in the current directory."), {
+        padding: { top: 0, bottom: 0, left: 2, right: 2 },
+        borderStyle: "round",
+        borderColor: "red",
+      }),
+    );
+    return 1;
+  }
+
+  if (opts.filter) {
+    const pat = opts.filter.toLowerCase();
+    const before = repos.length;
+    repos = repos.filter((r) => basename(r).toLowerCase().includes(pat));
+    if (repos.length === 0) {
+      console.log(p.yellow(`  No repos matched --filter "${opts.filter}". Nothing to do.\n`));
+      return 0;
+    }
+    console.log(
+      p.muted(`  ${repos.length} repos matched --filter "${opts.filter}" (${before - repos.length} hidden)\n`),
+    );
+  }
+
+  if (opts.exclude) {
+    const pat = opts.exclude.toLowerCase();
+    const before = repos.length;
+    repos = repos.filter((r) => !basename(r).toLowerCase().includes(pat));
+    if (repos.length === 0) {
+      console.log(
+        p.yellow(`  All ${before} repos matched --exclude "${opts.exclude}". Nothing to do.\n`),
+      );
+      return 0;
+    }
+    console.log(
+      p.muted(`  ${repos.length} repos · ${before - repos.length} excluded via "${opts.exclude}"\n`),
+    );
+  }
+
+  // ── Subcommands ───────────────────────────────────────────────────────────
+
+  if (opts.subcommand === "status") {
+    await cmdStatus(repos);
+    return 0;
+  }
+
+  if (opts.subcommand === "fetch") {
+    console.log();
+    await cmdFetch(repos);
+    return 0;
+  }
+
+  if (opts.subcommand === "mr") {
+    return await cmdMr(repos, {
+      target:      opts.target,
+      mrRepos:     opts.mrRepos,
+      title:       opts.title,
+      description: opts.description,
+      labels:      opts.labels,
+      draft:       opts.draft,
+      noPush:      opts.noPush,
+      yes:         opts.yes,
+    });
+  }
+
+  if (opts.subcommand === "portal") {
+    return await cmdPortal(repos, {
+      settings:         opts.settings,
+      epic:             opts.epic,
+      checkout:         opts.checkout,
+      createMr:         opts.createMr,
+      createIssue:      opts.createIssue,
+      review:           opts.review,
+      target:           opts.target,
+      title:            opts.title,
+      description:      opts.description,
+      labels:           opts.labels,
+      draft:            opts.draft,
+      noPush:           opts.noPush,
+      issueProject:     opts.issueProject,
+      issueTitle:       opts.issueTitle,
+      issueDescription: opts.issueDescription,
+      issueLabels:      opts.issueLabels,
+      branchName:       opts.branchName,
+      baseBranch:       opts.baseBranch,
+      yes:              opts.yes,
+    });
+  }
+
+  if (opts.subcommand === "settings") {
+    return await cmdSettings(repos);
+  }
+
+  // ── Interactive switch mode ────────────────────────────────────────────────
+
+  let {
+    branch: targetBranch,
+    pull: pullChanges,
+    fuzzy: fuzzyMode,
+    create: createBranch,
+    stash: autoStash,
+    fetch: doFetch,
+    dryRun,
+  } = opts;
+
+  if (!targetBranch) {
+    console.log(
+      "  " + p.muted("Found ") + p.white(String(repos.length)) +
+      p.muted(` ${repos.length === 1 ? "repo" : "repos"} in scope\n`),
+    );
+
+    // Mode selector — loop so "go back" from sub-commands returns here
+    modeLoop: while (true) {
+      const mode = await select({
+        message: p.white("What do you want to do?"),
+        choices: [
+          {
+            value: "switch",
+            name: p.cyan("⇌  Switch branches") + p.muted("   checkout a branch across all repos"),
+          },
+          {
+            value: "portal",
+            name: chalk.hex("#FC6D26")("◈  GitLab") + p.muted("   development portal — epics, MRs & branches"),
+          },
+        ],
+        theme: THEME,
+      });
+
+      console.log();
+
+      if (mode === "portal") {
+        const result = await cmdPortal(repos);
+        if (result !== "__back__") return result;
+        continue;
+      }
+
+      // ── Switch branch flow (with back support) ─────────────────────────────
+      const branchSuggestions = getSwitchBranchSuggestions(config);
+
+      if (branchSuggestions.length > 0) {
+        const branchChoice = await select({
+          message: p.white("Suggested branch:"),
+          choices: [
+            { value: "__back__", name: p.yellow("← Go back"), description: p.muted("return to main menu") },
+            ...branchSuggestions.map((item) => ({
+              value: item.value,
+              name: colorBranch(item.value),
+              description: p.muted(item.template),
+            })),
+            {
+              value: "__custom__",
+              name: p.white("Custom branch..."),
+              description: p.muted("type any branch name or partial"),
+            },
+          ],
+          theme: THEME,
+        });
+
+        console.log();
+
+        if (branchChoice === "__back__") continue modeLoop;
+
+        if (branchChoice === "__custom__") {
+          targetBranch = await input({
+            message: p.white("Branch name") + p.muted(" (or partial):"),
+            theme: THEME,
+            validate: (v) => v.trim() !== "" || "Branch name cannot be empty",
+          });
+        } else {
+          targetBranch = branchChoice;
+        }
+      } else {
+        targetBranch = await input({
+          message: p.white("Branch name") + p.muted(" (or partial):"),
+          theme: THEME,
+          validate: (v) => v.trim() !== "" || "Branch name cannot be empty",
+        });
+      }
+
+      break modeLoop; // branch was chosen — proceed to confirm prompts
+    }
+
+    const switchDefaults = config.switch?.lastOptions ?? {};
+
+    pullChanges = await confirm({
+      message: p.white("Pull") + p.muted(" after switching?"),
+      default: switchDefaults.pull ?? false,
+      theme: THEME,
+    });
+
+    fuzzyMode = await confirm({
+      message: p.white("Fuzzy") + p.muted(" / partial branch matching?"),
+      default: switchDefaults.fuzzy ?? false,
+      theme: THEME,
+    });
+
+    autoStash = await confirm({
+      message: p.white("Auto-stash") + p.muted(" dirty repos before switching?"),
+      default: switchDefaults.stash ?? false,
+      theme: THEME,
+    });
+
+    saveConfig({
+      ...config,
+      switch: {
+        ...config.switch,
+        lastOptions: { pull: pullChanges, fuzzy: fuzzyMode, stash: autoStash },
+      },
+    });
+
+    console.log();
+  }
+
+
+  return await cmdSwitch(repos, {
+    targetBranch,
+    pullChanges,
+    fuzzyMode,
+    createBranch,
+    autoStash,
+    doFetch,
+    dryRun,
+  });
+}

package/src/ui/colors.js

@@ -0,0 +1,54 @@
+import chalk from "chalk";
+import { p } from "./theme.js";
+
+// Convert HSL (h: 0-360, s: 0-100, l: 0-100) to a hex colour string
+function hslToHex(h, s, l) {
+  s /= 100;
+  l /= 100;
+  const k = (n) => (n + h / 30) % 12;
+  const a = s * Math.min(l, 1 - l);
+  const f = (n) =>
+    l - a * Math.max(-1, Math.min(k(n) - 3, Math.min(9 - k(n), 1)));
+  const hex = (x) =>
+    Math.round(x * 255)
+      .toString(16)
+      .padStart(2, "0");
+  return `#${hex(f(0))}${hex(f(8))}${hex(f(4))}`;
+}
+
+// Deterministically map a prefix string to a hue (0–359)
+function prefixHue(str) {
+  let h = 0;
+  for (let i = 0; i < str.length; i++) h = (h * 31 + str.charCodeAt(i)) >>> 0;
+  return h % 360;
+}
+
+// Colour a GitLab label by hashing its namespace prefix (e.g. "STA", "PRI", "TECH")
+// Works for any prefix — same prefix always gets the same colour.
+export function colorLabel(label) {
+  const prefix = label.split("::")[0].trim();
+  const hex = hslToHex(prefixHue(prefix.toUpperCase()), 65, 72);
+  return chalk.hex(hex)(label);
+}
+
+export function colorBranch(name) {
+  const n = name.trimEnd();
+  const pad = name.slice(n.length);
+  const color =
+    n === "main" || n === "master"
+      ? p.red
+      : /^(feature|feat)/.test(n)
+        ? p.cyan
+        : /^(hotfix|fix|bugfix)/.test(n)
+          ? p.orange
+          : /^(release|rel)/.test(n)
+            ? p.teal
+            : /^(develop|dev)$/.test(n)
+              ? p.purple
+              : /^sprint/.test(n)
+                ? p.yellow
+                : /^(chore|refactor|docs|test)/.test(n)
+                  ? p.muted
+                  : p.white;
+  return color(n) + pad;
+}

package/src/ui/print.js

@@ -0,0 +1,177 @@
+import figlet from "figlet";
+import boxen from "boxen";
+import chalk from "chalk";
+
+import { p } from "./theme.js";
+import { VERSION } from "../constants.js";
+
+export function printLogo() {
+  const art = figlet.textSync("gitmux", { font: "ANSI Shadow" });
+  console.log();
+  console.log(chalk.white(art));
+  console.log(
+    "  " + p.slate("─".repeat(3)) +
+    "  " + p.muted(`v${VERSION}`) +
+    "  " + p.slate("─".repeat(3)),
+  );
+  console.log();
+}
+
+export function printAbout() {
+  printLogo();
+
+  const hr = "  " + p.dim("─".repeat(58));
+  const gap = "";
+
+  const features = [
+    [p.cyan("⇌  Branch switching"), "checkout any branch across all repos instantly"],
+    [p.teal("↓  Pull & stash"), "pull latest or auto-stash dirty repos on switch"],
+    [p.purple("~  Fuzzy matching"), "partial branch name matching across all repos"],
+    [p.cyan("↺  Parallel fetch"), "fetch all remotes concurrently"],
+    [chalk.hex("#FC6D26")("◈  GitLab portal"), "browse epics, issues & primary branches"],
+    [p.purple("⎇  Merge requests"), "open MRs straight from the CLI via glab"],
+    [p.green("✚  Issue creation"), "create GitLab issues linked to epics"],
+    [p.teal("★  Primary branches"), "pin a branch per issue for fast checkout"],
+  ];
+
+  const lines = [
+    // About
+    "  " + chalk.bold(p.white("ABOUT")),
+    gap,
+    "  " + p.muted("gitmux is a multi-repo Git workflow CLI."),
+    "  " + p.muted("Run it from any directory to operate across all git"),
+    "  " + p.muted("repositories found within the configured search depth."),
+    gap,
+    hr,
+    gap,
+
+    // Features
+    "  " + chalk.bold(p.white("FEATURES")),
+    gap,
+    ...features.map(([label, desc]) =>
+      "  " + label + "  " + p.muted(desc),
+    ),
+    gap,
+    hr,
+    gap,
+
+    // Commands
+    "  " + chalk.bold(p.white("COMMANDS")),
+    gap,
+    `  ${p.cyan("gitmux <branch>")}    ${p.muted("Switch branch across all repos")}`,
+    `  ${p.cyan("gitmux status")}      ${p.muted("Show branch & dirty state for all repos")}`,
+    `  ${p.cyan("gitmux fetch")}       ${p.muted("Fetch all remotes in parallel")}`,
+    `  ${p.cyan("gitmux mr")}          ${p.muted("Create merge requests via glab")}`,
+    `  ${p.cyan("gitmux portal")}      ${p.muted("GitLab development portal")}`,
+    `  ${p.cyan("gitmux settings")}    ${p.muted("Configure portal & workflow defaults")}`,
+    `  ${p.cyan("gitmux about")}       ${p.muted("This page")}`,
+    gap,
+    hr,
+    gap,
+
+    // Meta
+    "  " + chalk.bold(p.white("VERSION")) + "   " + p.white(`v${VERSION}`),
+    gap,
+    "  " + chalk.bold(p.white("AUTHOR")) + "   " + p.white("E.R.Rhythm"),
+    "  " + chalk.bold(p.white("EMAIL")) + "    " + p.muted("errhythm.me@gmail.com"),
+    "  " + chalk.bold(p.white("GITHUB")) + "   " + p.muted("github.com/") + p.cyan("e.r.rhythm"),
+    gap,
+  ];
+
+  for (const line of lines) console.log(line);
+}
+
+
+export function printHelp() {
+  printLogo();
+  const hr = p.dim("─".repeat(52));
+  console.log(
+    boxen(
+      [
+        chalk.bold(p.white("USAGE")),
+        `  ${p.cyan("gitmux")} ${p.muted("[branch] [options]")}`,
+        `  ${p.cyan("gitmux status")}`,
+        `  ${p.cyan("gitmux fetch")}`,
+        `  ${p.cyan("gitmux mr     [options]")}`,
+        `  ${p.cyan("gitmux portal [options]")}`,
+        `  ${p.cyan("gitmux settings")}`,
+        `  ${p.cyan("gitmux about")}`,
+        "",
+        hr,
+        "",
+        chalk.bold(p.white("COMMANDS")),
+        `  ${p.cyan("status")}          ${p.muted("Show branch & dirty status for all repos")}`,
+        `  ${p.cyan("fetch")}           ${p.muted("Fetch all remotes across repos in parallel")}`,
+        `  ${p.cyan("mr")}              ${p.muted("Create GitLab merge requests directly (via glab)")}`,
+        `  ${p.cyan("portal")}          ${p.muted("GitLab Portal — epics, MRs, issues & branches")}`,
+        `  ${p.cyan("settings")}        ${p.muted("Configure portal, switch & MR defaults")}`,
+        `  ${p.cyan("about")}           ${p.muted("Show version, features & author info")}`,
+        "",
+        hr,
+        "",
+        chalk.bold(p.white("SWITCH OPTIONS")),
+        `  ${p.purple("-p, --pull")}       ${p.muted("Pull latest on the target branch after switching")}`,
+        `  ${p.purple("-f, --fuzzy")}      ${p.muted("Fuzzy / partial branch name matching")}`,
+        `  ${p.purple("-c, --create")}     ${p.muted("Create branch if it doesn't exist")}`,
+        `  ${p.purple("-s, --stash")}      ${p.muted("Auto-stash dirty repos before switching")}`,
+        `  ${p.purple("    --fetch")}      ${p.muted("Fetch all remotes before switching")}`,
+        `  ${p.purple("    --dry-run")}    ${p.muted("Preview what would happen, no changes made")}`,
+        "",
+        chalk.bold(p.white("MR OPTIONS")),
+        `  ${p.purple("-t, --target <b>")}  ${p.muted("Target branch to merge into (skips scope picker)")}`,
+        `  ${p.purple("    --repo <name>")} ${p.muted("Restrict to this repo (repeatable)")}`,
+        `  ${p.purple("    --title <s>")}   ${p.muted("MR title (skips prompt)")}`,
+        `  ${p.purple("    --description")} ${p.muted("MR description (skips prompt)")}`,
+        `  ${p.purple("    --labels <csv>")}${p.muted("Comma-separated labels")}`,
+        `  ${p.purple("    --draft")}       ${p.muted("Mark MR as draft")}`,
+        `  ${p.purple("    --no-push")}     ${p.muted("Skip git push before creating MR")}`,
+        "",
+        chalk.bold(p.white("PORTAL OPTIONS")),
+        `  ${p.purple("    --epic <iid>")}           ${p.muted("Select epic by IID (skips epic picker)")}`,
+        `  ${p.purple("    --checkout")}              ${p.muted("Checkout primary branches for epic's repos")}`,
+        `  ${p.purple("    --create-mr")}             ${p.muted("Bulk-create MRs for epic issues")}`,
+        `  ${p.purple("    --create-issue")}          ${p.muted("Create a new issue in the epic")}`,
+        `  ${p.purple("    --issue-project <path>")}  ${p.muted("Project name or path for issue creation")}`,
+        `  ${p.purple("    --issue-title <text>")}    ${p.muted("Issue title")}`,
+        `  ${p.purple("    --issue-description")}     ${p.muted("Issue description")}`,
+        `  ${p.purple("    --issue-labels <csv>")}    ${p.muted("Issue labels")}`,
+        `  ${p.purple("    --branch-name <name>")}    ${p.muted("Create this branch for the new issue")}`,
+        `  ${p.purple("    --base-branch <name>")}    ${p.muted("Base branch for branch/MR creation")}`,
+        "",
+        chalk.bold(p.white("GLOBAL OPTIONS")),
+        `  ${p.purple("-y, --yes")}        ${p.muted("Auto-confirm all prompts (non-interactive)")}`,
+        `  ${p.purple("    --depth n")}    ${p.muted("Repo search depth (default: 4)")}`,
+        `  ${p.purple("    --filter p")}   ${p.muted("Only include repos whose name contains pattern")}`,
+        `  ${p.purple("    --exclude p")}  ${p.muted("Exclude repos whose name contains pattern")}`,
+        `  ${p.purple("    --settings")}   ${p.muted("Open portal settings (group, milestone, iteration…)")}`,
+        `  ${p.purple("-v, --version")}    ${p.muted("Show version number")}`,
+        `  ${p.purple("-h, --help")}       ${p.muted("Show this help")}`,
+        "",
+        hr,
+        "",
+        chalk.bold(p.white("EXAMPLES")),
+        `  ${p.muted("$")} ${p.cyan("gitmux develop")}`,
+        `  ${p.muted("$")} ${p.cyan("gitmux main --pull")}`,
+        `  ${p.muted("$")} ${p.cyan("gitmux feature/auth --stash --pull")}`,
+        `  ${p.muted("$")} ${p.cyan("gitmux feat --fuzzy")}`,
+        `  ${p.muted("$")} ${p.cyan("gitmux main --create")}`,
+        `  ${p.muted("$")} ${p.cyan("gitmux --dry-run develop")}`,
+        `  ${p.muted("$")} ${p.cyan("gitmux --exclude legacy develop")}`,
+        `  ${p.muted("$")} ${p.cyan("gitmux status")}`,
+        `  ${p.muted("$")} ${p.cyan("gitmux fetch")}`,
+        `  ${p.muted("$")} ${p.cyan("gitmux mr --target develop --title \"Fix auth\" --labels \"bug\" --yes")}`,
+        `  ${p.muted("$")} ${p.cyan("gitmux portal --epic 42 --checkout --yes")}`,
+        `  ${p.muted("$")} ${p.cyan("gitmux portal --epic 42 --create-mr --target develop --yes")}`,
+        `  ${p.muted("$")} ${p.cyan("gitmux portal --epic 42 --create-issue --issue-project group/repo --issue-title \"Task\" --yes")}`,
+      ].join("\n"),
+      {
+        padding: { top: 1, bottom: 1, left: 3, right: 3 },
+        borderStyle: "round",
+        borderColor: "#334155",
+        title: p.muted(" help "),
+        titleAlignment: "right",
+      },
+    ),
+  );
+  console.log();
+}

package/src/ui/theme.js

@@ -0,0 +1,26 @@
+import chalk from "chalk";
+
+export const p = {
+  cyan:   chalk.hex("#67e8f9"),
+  teal:   chalk.hex("#4ecdc4"),
+  purple: chalk.hex("#c084fc"),
+  green:  chalk.hex("#4ade80"),
+  yellow: chalk.hex("#fbbf24"),
+  red:    chalk.hex("#f87171"),
+  orange: chalk.hex("#fb923c"),
+  muted:  chalk.hex("#64748b"),
+  slate:  chalk.hex("#475569"),
+  dim:    chalk.hex("#1e293b"),
+  white:  chalk.hex("#f1f5f9"),
+  bold:   chalk.bold,
+};
+
+export const THEME = {
+  prefix: p.purple("◆"),
+  icon:   { cursor: " " },
+  style: {
+    highlight:     (s) => chalk.bgHex("#5b21b6").white.bold(s.replace(/\x1B\[[0-9;]*[a-zA-Z]/g, "")),
+    answer:        (s) => p.cyan(s),
+    defaultAnswer: (s) => p.muted(s),
+  },
+};

package/src/utils/exec.js

@@ -0,0 +1,12 @@
+import { exec, execFile } from "child_process";
+import { promisify } from "util";
+
+export const execAsync     = promisify(exec);
+export const execFileAsync = promisify(execFile);
+
+export function extractMsg(e) {
+  return (e.stderr || e.stdout || e.message || "")
+    .toString()
+    .replace(/\n/g, " ")
+    .trim();
+}