@quickcall/all-configs 0.0.0-stage → 1.0.0

package/runtime/modules/fonts/install.sh

@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
+source "$ROOT_DIR/lib/common.sh"
+
+FONT_VERSION="v3.2.1"
+FONT_NAME="Meslo"
+ZIP_URL="https://github.com/ryanoasis/nerd-fonts/releases/download/${FONT_VERSION}/${FONT_NAME}.zip"
+
+step "Ensuring font dependencies"
+ensure_cmd unzip unzip
+if ! command -v fc-cache &> /dev/null; then
+    warn "fontconfig not found — installing"
+    if [[ "$PLATFORM" == "mac" ]]; then
+        ensure_cmd brew brew
+        brew_install_formula fontconfig
+    else
+        sudo apt-get update -qq && sudo apt-get install -y -qq fontconfig
+    fi
+    if command -v fc-cache &> /dev/null; then
+        ok "fontconfig installed"
+    else
+        warn "fontconfig install may have failed - continuing without font cache refresh"
+    fi
+else
+    ok "fontconfig"
+fi
+
+step "Installing ${FONT_NAME} Nerd Font"
+
+if [[ "$PLATFORM" == "mac" ]]; then
+    FONT_DIR="$HOME/Library/Fonts"
+else
+    FONT_DIR="$HOME/.local/share/fonts"
+fi
+
+mkdir -p "$FONT_DIR"
+
+TMP_DIR="$(mktemp -d)"
+trap 'rm -rf "$TMP_DIR"' EXIT
+
+step "Downloading ${FONT_NAME} Nerd Font"
+curl -fsSL "$ZIP_URL" -o "$TMP_DIR/${FONT_NAME}.zip"
+
+step "Extracting fonts"
+unzip -q "$TMP_DIR/${FONT_NAME}.zip" -d "$TMP_DIR/fonts"
+
+step "Copying fonts to ${FONT_DIR}"
+find "$TMP_DIR/fonts" -maxdepth 1 -type f \( -iname "*.ttf" -o -iname "*.otf" \) -exec cp {} "$FONT_DIR/" \;
+
+if [[ "$PLATFORM" == "linux" ]]; then
+    step "Refreshing font cache"
+    if command -v fc-cache &> /dev/null; then
+        fc-cache -fv "$FONT_DIR"
+    else
+        warn "fc-cache not found — font cache not refreshed"
+    fi
+fi
+
+ok "${FONT_NAME} Nerd Font installed"

package/runtime/modules/fonts/module.toml

@@ -0,0 +1,8 @@
+name = "fonts"
+description = "Meslo Nerd Font for terminal and editor icons"
+platforms = ["mac", "linux"]
+kind = "config"
+
+[detect]
+paths_mac = ["~/Library/Fonts/MesloLGSNerdFont-Regular.ttf"]
+paths_linux = ["~/.local/share/fonts/MesloLGSNerdFont-Regular.ttf"]

package/runtime/modules/ghostty/config

@@ -0,0 +1,44 @@
+# ============================================
+# GHOSTTY CONFIG
+# ============================================
+# Symlinked: ~/.config/ghostty/config -> this file
+# ============================================
+
+# --------------------------------------------
+# THEME
+# --------------------------------------------
+
+theme = visual-studio-light
+
+# --------------------------------------------
+# FONT
+# --------------------------------------------
+
+font-family = MesloLGS Nerd Font Mono
+font-size = 14
+
+# --------------------------------------------
+# WINDOW
+# --------------------------------------------
+
+window-padding-x = 12
+window-padding-y = 10
+window-padding-balance = true
+scrollback-limit = 100000
+
+# --------------------------------------------
+# BEHAVIOR
+# --------------------------------------------
+
+mouse-hide-while-typing = true
+copy-on-select = clipboard
+
+# Send Option as Alt so Meta keybindings work in tmux
+macos-option-as-alt = true
+
+# Forward palette shortcuts to tmux
+keybind = cmd+p=text:\x1bp
+# Forward Alt-Backspace to tmux/pi instead of handling it locally
+keybind = alt+backspace=text:\x1b\x7f
+
+shell-integration = detect

package/runtime/modules/ghostty/install.sh

@@ -0,0 +1,64 @@
+#!/usr/bin/env bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
+source "$ROOT_DIR/lib/common.sh"
+
+step "Installing Ghostty"
+
+# ─── Install ───
+
+if [[ "$PLATFORM" == "mac" ]]; then
+    if command -v ghostty &>/dev/null; then
+        ok "ghostty ${D}$(command -v ghostty)${R}"
+    else
+        warn "ghostty not found — installing via brew cask"
+        brew_install_cask ghostty
+        ok "ghostty installed"
+    fi
+else
+    warn "Linux: ghostty binary not available via package manager"
+    step "Installing ghostty terminfo for xterm-ghostty"
+    ensure_cmd tic ncurses-bin
+    mkdir -p "$HOME/.terminfo"
+    tic -x -o "$HOME/.terminfo" "$SCRIPT_DIR/xterm-ghostty.terminfo"
+    ok "ghostty terminfo installed to ~/.terminfo"
+fi
+
+# ─── Config ───
+
+CONFIG_TARGETS=(
+    "$HOME/.config/ghostty/config"
+    "$HOME/.config/ghostty/config.ghostty"
+    "$HOME/Library/Application Support/com.mitchellh.ghostty/config.ghostty"
+)
+
+for DEST in "${CONFIG_TARGETS[@]}"; do
+    mkdir -p "$(dirname "$DEST")"
+    backup_file "$DEST"
+    [[ -L "$DEST" ]] && rm "$DEST"
+    ln -sf "$SCRIPT_DIR/config" "$DEST"
+    ok "ghostty config ${D}→ $DEST (symlinked)${R}"
+done
+
+# ─── Themes ───
+
+THEME_TARGETS=(
+    "$HOME/.config/ghostty/themes"
+    "$HOME/Library/Application Support/com.mitchellh.ghostty/themes"
+)
+
+for THEMES_DEST in "${THEME_TARGETS[@]}"; do
+    mkdir -p "$THEMES_DEST"
+    for theme in "$SCRIPT_DIR/themes/"*; do
+        [[ -f "$theme" ]] || continue
+        ln -sf "$theme" "$THEMES_DEST/$(basename "$theme")"
+        ok "theme ${D}$(basename "$theme") → $THEMES_DEST/${R}"
+    done
+done
+
+echo ""
+echo -e "  ${GRN}Done!${R} Open Ghostty to apply"
+echo -e "  ${D}Theme: vscode-light  |  Font: MesloLGS Nerd Font Mono 14${R}"
+echo ""

package/runtime/modules/ghostty/module.toml

@@ -0,0 +1,9 @@
+name = "ghostty"
+description = "Ghostty terminal config + themes"
+platforms = ["mac", "linux"]
+kind = "config"
+
+[detect]
+commands = ["ghostty"]
+apps = ["Ghostty"]
+paths = ["~/.config/ghostty/config"]

package/runtime/modules/ghostty/themes/ayu-dark

@@ -0,0 +1,22 @@
+background = #0b0e14
+foreground = #bfbdb6
+selection-background = #1b3a5b
+selection-foreground = #bfbdb6
+cursor-color = #bfbdb6
+cursor-text = #0b0e14
+palette = 0=#1e232b
+palette = 1=#ea6c73
+palette = 2=#7fd962
+palette = 3=#f9af4f
+palette = 4=#53bdfa
+palette = 5=#cda1fa
+palette = 6=#90e1c6
+palette = 7=#c7c7c7
+palette = 8=#686868
+palette = 9=#f07178
+palette = 10=#aad94c
+palette = 11=#ffb454
+palette = 12=#59c2ff
+palette = 13=#d2a6ff
+palette = 14=#95e6cb
+palette = 15=#ffffff

package/runtime/modules/ghostty/themes/catppuccin-frappe

@@ -0,0 +1,23 @@
+palette = 0=#51576d
+palette = 1=#e78284
+palette = 2=#a6d189
+palette = 3=#e5c890
+palette = 4=#8caaee
+palette = 5=#f4b8e4
+palette = 6=#81c8be
+palette = 7=#a5adce
+palette = 8=#626880
+palette = 9=#e78284
+palette = 10=#a6d189
+palette = 11=#e5c890
+palette = 12=#8caaee
+palette = 13=#f4b8e4
+palette = 14=#81c8be
+palette = 15=#b5bfe2
+background = 303446
+foreground = c6d0f5
+cursor-color = f2d5cf
+cursor-text = 232634
+selection-background = 44495d
+selection-foreground = c6d0f5
+split-divider-color = 414559

package/runtime/modules/ghostty/themes/catppuccin-latte

@@ -0,0 +1,23 @@
+palette = 0=#5c5f77
+palette = 1=#d20f39
+palette = 2=#40a02b
+palette = 3=#df8e1d
+palette = 4=#1e66f5
+palette = 5=#ea76cb
+palette = 6=#179299
+palette = 7=#acb0be
+palette = 8=#6c6f85
+palette = 9=#d20f39
+palette = 10=#40a02b
+palette = 11=#df8e1d
+palette = 12=#1e66f5
+palette = 13=#ea76cb
+palette = 14=#179299
+palette = 15=#bcc0cc
+background = eff1f5
+foreground = 4c4f69
+cursor-color = dc8a78
+cursor-text = eff1f5
+selection-background = d8dae1
+selection-foreground = 4c4f69
+split-divider-color = ccd0da

package/runtime/modules/ghostty/themes/catppuccin-latte.conf

@@ -0,0 +1,23 @@
+palette = 0=#5c5f77
+palette = 1=#d20f39
+palette = 2=#40a02b
+palette = 3=#df8e1d
+palette = 4=#1e66f5
+palette = 5=#ea76cb
+palette = 6=#179299
+palette = 7=#acb0be
+palette = 8=#6c6f85
+palette = 9=#d20f39
+palette = 10=#40a02b
+palette = 11=#df8e1d
+palette = 12=#1e66f5
+palette = 13=#ea76cb
+palette = 14=#179299
+palette = 15=#bcc0cc
+background = eff1f5
+foreground = 4c4f69
+cursor-color = dc8a78
+cursor-text = eff1f5
+selection-background = d8dae1
+selection-foreground = 4c4f69
+split-divider-color = ccd0da

package/runtime/modules/ghostty/themes/catppuccin-macchiato

@@ -0,0 +1,23 @@
+palette = 0=#494d64
+palette = 1=#ed8796
+palette = 2=#a6da95
+palette = 3=#eed49f
+palette = 4=#8aadf4
+palette = 5=#f5bde6
+palette = 6=#8bd5ca
+palette = 7=#a5adcb
+palette = 8=#5b6078
+palette = 9=#ed8796
+palette = 10=#a6da95
+palette = 11=#eed49f
+palette = 12=#8aadf4
+palette = 13=#f5bde6
+palette = 14=#8bd5ca
+palette = 15=#b8c0e0
+background = 24273a
+foreground = cad3f5
+cursor-color = f4dbd6
+cursor-text = 181926
+selection-background = 3a3e53
+selection-foreground = cad3f5
+split-divider-color = 363a4f

package/runtime/modules/ghostty/themes/catppuccin-mocha

@@ -0,0 +1,23 @@
+palette = 0=#45475a
+palette = 1=#f38ba8
+palette = 2=#a6e3a1
+palette = 3=#f9e2af
+palette = 4=#89b4fa
+palette = 5=#f5c2e7
+palette = 6=#94e2d5
+palette = 7=#a6adc8
+palette = 8=#585b70
+palette = 9=#f38ba8
+palette = 10=#a6e3a1
+palette = 11=#f9e2af
+palette = 12=#89b4fa
+palette = 13=#f5c2e7
+palette = 14=#94e2d5
+palette = 15=#bac2de
+background = 1e1e2e
+foreground = cdd6f4
+cursor-color = f5e0dc
+cursor-text = 11111b
+selection-background = 353749
+selection-foreground = cdd6f4
+split-divider-color = 313244

package/runtime/modules/ghostty/themes/visual-studio-light

@@ -0,0 +1,27 @@
+# VS Code "Visual Studio Light" — exact colors from the app bundle
+# Sources:
+#   theme-defaults/themes/light_vs.json (token colors)
+#   platform light color registry (workbench/terminal defaults)
+# Only deviation: terminal magenta #bc05bc -> editor purple #800080 (no pink)
+palette = 0=#000000
+palette = 1=#cd3131
+palette = 2=#008000
+palette = 3=#795e26
+palette = 4=#0451a5
+palette = 5=#800080
+palette = 6=#098658
+palette = 7=#555555
+palette = 8=#666666
+palette = 9=#e81123
+palette = 10=#107c10
+palette = 11=#b8860b
+palette = 12=#007acc
+palette = 13=#af00db
+palette = 14=#00b7c3
+palette = 15=#a5a5a5
+background = #ffffff
+foreground = #000000
+cursor-color = #000000
+cursor-text = #ffffff
+selection-background = #add6ff
+selection-foreground = #000000

package/runtime/modules/ghostty/themes/vscode-light

@@ -0,0 +1,24 @@
+# VS Code "Default Light+" — official colors
+# Source: microsoft/vscode terminalColorRegistry.ts (light defaults) + light_vs.json
+palette = 0=#000000
+palette = 1=#cd3131
+palette = 2=#107C10
+palette = 3=#949800
+palette = 4=#0451a5
+palette = 5=#bc05bc
+palette = 6=#0598bc
+palette = 7=#555555
+palette = 8=#666666
+palette = 9=#cd3131
+palette = 10=#14CE14
+palette = 11=#b5ba00
+palette = 12=#0451a5
+palette = 13=#bc05bc
+palette = 14=#0598bc
+palette = 15=#a5a5a5
+background = #ffffff
+foreground = #333333
+cursor-color = #333333
+cursor-text = #ffffff
+selection-background = #add6ff
+selection-foreground = #333333

package/runtime/modules/ghostty/themes/vscode-light-soft

@@ -0,0 +1,24 @@
+# VS Code Light+ softened variant — same hues, easier on the eyes
+# (magenta swapped for purple, white toned down to cool gray)
+palette = 0=#000000
+palette = 1=#cd3131
+palette = 2=#107C10
+palette = 3=#949800
+palette = 4=#0451a5
+palette = 5=#8250df
+palette = 6=#0598bc
+palette = 7=#555555
+palette = 8=#666666
+palette = 9=#cd3131
+palette = 10=#14CE14
+palette = 11=#b5ba00
+palette = 12=#0451a5
+palette = 13=#b083f0
+palette = 14=#0598bc
+palette = 15=#a5a5a5
+background = #f2f4f7
+foreground = #3b3b3b
+cursor-color = #0451a5
+cursor-text = #f2f4f7
+selection-background = #c7ddf2
+selection-foreground = #333333

package/runtime/modules/ghostty/xterm-ghostty.terminfo

@@ -0,0 +1,81 @@
+#	Reconstructed via infocmp from file: /Applications/Ghostty.app/Contents/Resources/terminfo/78/xterm-ghostty
+xterm-ghostty|ghostty|Ghostty,
+	am, bce, ccc, hs, km, mc5i, mir, msgr, npc, xenl, AX, Su, Tc, XT, fullkbd,
+	colors#256, cols#80, it#8, lines#24, pairs#32767,
+	acsc=++\,\,--..00``aaffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz{{||}}~~,
+	bel=^G, blink=\E[5m, bold=\E[1m, cbt=\E[Z, civis=\E[?25l,
+	clear=\E[H\E[2J, cnorm=\E[?12l\E[?25h, cr=^M,
+	csr=\E[%i%p1%d;%p2%dr, cub=\E[%p1%dD, cub1=^H,
+	cud=\E[%p1%dB, cud1=^J, cuf=\E[%p1%dC, cuf1=\E[C,
+	cup=\E[%i%p1%d;%p2%dH, cuu=\E[%p1%dA, cuu1=\E[A,
+	cvvis=\E[?12;25h, dch=\E[%p1%dP, dch1=\E[P, dim=\E[2m,
+	dl=\E[%p1%dM, dl1=\E[M, dsl=\E]2;\007, ech=\E[%p1%dX,
+	ed=\E[J, el=\E[K, el1=\E[1K, flash=\E[?5h$<100/>\E[?5l,
+	fsl=^G, home=\E[H, hpa=\E[%i%p1%dG, ht=^I, hts=\EH,
+	ich=\E[%p1%d@, ich1=\E[@, il=\E[%p1%dL, il1=\E[L, ind=^J,
+	indn=\E[%p1%dS,
+	initc=\E]4;%p1%d;rgb\:%p2%{255}%*%{1000}%/%2.2X/%p3%{255}%*%{1000}%/%2.2X/%p4%{255}%*%{1000}%/%2.2X\E\\,
+	invis=\E[8m, kDC=\E[3;2~, kEND=\E[1;2F, kHOM=\E[1;2H,
+	kIC=\E[2;2~, kLFT=\E[1;2D, kNXT=\E[6;2~, kPRV=\E[5;2~,
+	kRIT=\E[1;2C, kbs=\177, kcbt=\E[Z, kcub1=\EOD, kcud1=\EOB,
+	kcuf1=\EOC, kcuu1=\EOA, kdch1=\E[3~, kend=\EOF, kent=\EOM,
+	kf1=\EOP, kf10=\E[21~, kf11=\E[23~, kf12=\E[24~,
+	kf13=\E[1;2P, kf14=\E[1;2Q, kf15=\E[1;2R, kf16=\E[1;2S,
+	kf17=\E[15;2~, kf18=\E[17;2~, kf19=\E[18;2~, kf2=\EOQ,
+	kf20=\E[19;2~, kf21=\E[20;2~, kf22=\E[21;2~,
+	kf23=\E[23;2~, kf24=\E[24;2~, kf25=\E[1;5P, kf26=\E[1;5Q,
+	kf27=\E[1;5R, kf28=\E[1;5S, kf29=\E[15;5~, kf3=\EOR,
+	kf30=\E[17;5~, kf31=\E[18;5~, kf32=\E[19;5~,
+	kf33=\E[20;5~, kf34=\E[21;5~, kf35=\E[23;5~,
+	kf36=\E[24;5~, kf37=\E[1;6P, kf38=\E[1;6Q, kf39=\E[1;6R,
+	kf4=\EOS, kf40=\E[1;6S, kf41=\E[15;6~, kf42=\E[17;6~,
+	kf43=\E[18;6~, kf44=\E[19;6~, kf45=\E[20;6~,
+	kf46=\E[21;6~, kf47=\E[23;6~, kf48=\E[24;6~,
+	kf49=\E[1;3P, kf5=\E[15~, kf50=\E[1;3Q, kf51=\E[1;3R,
+	kf52=\E[1;3S, kf53=\E[15;3~, kf54=\E[17;3~,
+	kf55=\E[18;3~, kf56=\E[19;3~, kf57=\E[20;3~,
+	kf58=\E[21;3~, kf59=\E[23;3~, kf6=\E[17~, kf60=\E[24;3~,
+	kf61=\E[1;4P, kf62=\E[1;4Q, kf63=\E[1;4R, kf7=\E[18~,
+	kf8=\E[19~, kf9=\E[20~, khome=\EOH, kich1=\E[2~,
+	kind=\E[1;2B, kmous=\E[<, knp=\E[6~, kpp=\E[5~,
+	kri=\E[1;2A, oc=\E]104\007, op=\E[39;49m, rc=\E8,
+	rep=%p1%c\E[%p2%{1}%-%db, rev=\E[7m, ri=\EM,
+	rin=\E[%p1%dT, ritm=\E[23m, rmacs=\E(B, rmam=\E[?7l,
+	rmcup=\E[?1049l, rmir=\E[4l, rmkx=\E[?1l\E>, rmso=\E[27m,
+	rmul=\E[24m, rs1=\E]\E\\\Ec, sc=\E7,
+	setab=\E[%?%p1%{8}%<%t4%p1%d%e%p1%{16}%<%t10%p1%{8}%-%d%e48;5;%p1%d%;m,
+	setaf=\E[%?%p1%{8}%<%t3%p1%d%e%p1%{16}%<%t9%p1%{8}%-%d%e38;5;%p1%d%;m,
+	sgr=%?%p9%t\E(0%e\E(B%;\E[0%?%p6%t;1%;%?%p5%t;2%;%?%p2%t;4%;%?%p1%p3%|%t;7%;%?%p4%t;5%;%?%p7%t;8%;m,
+	sgr0=\E(B\E[m, sitm=\E[3m, smacs=\E(0, smam=\E[?7h,
+	smcup=\E[?1049h, smir=\E[4h, smkx=\E[?1h\E=, smso=\E[7m,
+	smul=\E[4m, tbc=\E[3g, tsl=\E]2;, u6=\E[%i%d;%dR, u7=\E[6n,
+	u8=\E[?%[;0123456789]c, u9=\E[c, vpa=\E[%i%p1%dd,
+	BD=\E[?2004l, BE=\E[?2004h, Clmg=\E[s,
+	Cmg=\E[%i%p1%d;%p2%ds, Dsmg=\E[?69l, E3=\E[3J,
+	Enmg=\E[?69h, Ms=\E]52;%p1%s;%p2%s\007, PE=\E[201~,
+	PS=\E[200~, RV=\E[>c, Se=\E[2 q,
+	Setulc=\E[58\:2\:\:%p1%{65536}%/%d\:%p1%{256}%/%{255}%&%d\:%p1%{255}%&%d%;m,
+	Smulx=\E[4\:%p1%dm, Ss=\E[%p1%d q,
+	Sync=\E[?2026%?%p1%{1}%-%tl%eh%;,
+	XM=\E[?1006;1000%?%p1%{1}%=%th%el%;, XR=\E[>0q,
+	fd=\E[?1004l, fe=\E[?1004h, kDC3=\E[3;3~, kDC4=\E[3;4~,
+	kDC5=\E[3;5~, kDC6=\E[3;6~, kDC7=\E[3;7~, kDN=\E[1;2B,
+	kDN3=\E[1;3B, kDN4=\E[1;4B, kDN5=\E[1;5B, kDN6=\E[1;6B,
+	kDN7=\E[1;7B, kEND3=\E[1;3F, kEND4=\E[1;4F,
+	kEND5=\E[1;5F, kEND6=\E[1;6F, kEND7=\E[1;7F,
+	kHOM3=\E[1;3H, kHOM4=\E[1;4H, kHOM5=\E[1;5H,
+	kHOM6=\E[1;6H, kHOM7=\E[1;7H, kIC3=\E[2;3~, kIC4=\E[2;4~,
+	kIC5=\E[2;5~, kIC6=\E[2;6~, kIC7=\E[2;7~, kLFT3=\E[1;3D,
+	kLFT4=\E[1;4D, kLFT5=\E[1;5D, kLFT6=\E[1;6D,
+	kLFT7=\E[1;7D, kNXT3=\E[6;3~, kNXT4=\E[6;4~,
+	kNXT5=\E[6;5~, kNXT6=\E[6;6~, kNXT7=\E[6;7~,
+	kPRV3=\E[5;3~, kPRV4=\E[5;4~, kPRV5=\E[5;5~,
+	kPRV6=\E[5;6~, kPRV7=\E[5;7~, kRIT3=\E[1;3C,
+	kRIT4=\E[1;4C, kRIT5=\E[1;5C, kRIT6=\E[1;6C,
+	kRIT7=\E[1;7C, kUP=\E[1;2A, kUP3=\E[1;3A, kUP4=\E[1;4A,
+	kUP5=\E[1;5A, kUP6=\E[1;6A, kUP7=\E[1;7A, kxIN=\E[I,
+	kxOUT=\E[O, rmxx=\E[29m, rv=\E\\[[0-9]+;[0-9]+;[0-9]+c,
+	setrgbb=\E[48\:2\:%p1%d\:%p2%d\:%p3%dm,
+	setrgbf=\E[38\:2\:%p1%d\:%p2%d\:%p3%dm, smxx=\E[9m,
+	xm=\E[<%i%p3%d;%p1%d;%p2%d;%?%p4%tM%em%;,
+	xr=\EP>\\|[ -~]+a\E\\,

package/runtime/modules/github/install.sh

@@ -0,0 +1,101 @@
+#!/usr/bin/env bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
+source "$ROOT_DIR/lib/common.sh"
+
+usage() {
+  cat << USAGE
+Usage: ${0##*/} [options]
+
+Options:
+  -n, --name <name>      Git user.name
+  -e, --email <email>    Git user.email
+  -E, --editor <editor>  Git core.editor (optional)
+  -h, --help             Show this help
+
+Environment variables:
+  GIT_NAME, GIT_EMAIL, GIT_EDITOR
+
+Examples:
+  ${0##*/} -n "Sagar Sarkale" -e sagar@example.com
+  GIT_NAME="Sagar" GIT_EMAIL="sagar@example.com" ${0##*/}
+USAGE
+  exit 0
+}
+
+GIT_NAME="${GIT_NAME:-}"
+GIT_EMAIL="${GIT_EMAIL:-}"
+GIT_EDITOR="${GIT_EDITOR:-}"
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -n|--name) GIT_NAME="$2"; shift 2 ;;
+    -e|--email) GIT_EMAIL="$2"; shift 2 ;;
+    -E|--editor) GIT_EDITOR="$2"; shift 2 ;;
+    -h|--help) usage ;;
+    *) fail "Unknown option: $1"; exit 1 ;;
+  esac
+done
+
+step "Installing GitHub CLI"
+
+if ! command -v gh &>/dev/null; then
+  warn "gh not found — installing"
+  if [[ "$PLATFORM" == "mac" ]]; then
+    ensure_cmd brew brew
+    brew_install_formula gh
+  else
+    if command -v apt-get &>/dev/null; then
+      sudo apt-get update -qq
+      sudo apt-get install -y -qq curl gnupg
+      curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
+      sudo chmod go+r /usr/share/keyrings/githubcli-archive-keyring.gpg
+      echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list >/dev/null
+      sudo apt-get update -qq
+      sudo apt-get install -y -qq gh
+    elif command -v dnf &>/dev/null; then
+      sudo dnf config-manager --add-repo https://cli.github.com/packages/rpm/gh-cli.repo
+      sudo dnf install -y gh
+    else
+      fail "No supported package manager for gh"
+      exit 1
+    fi
+  fi
+  ok "gh installed"
+else
+  ok "gh ${D}$(gh --version 2>/dev/null | head -1)${R}"
+fi
+
+step "Configuring git"
+
+backup_file "$HOME/.gitconfig"
+
+if [[ -n "$GIT_NAME" ]]; then
+  git config --global user.name "$GIT_NAME"
+  ok "git user.name ${D}→ $GIT_NAME${R}"
+else
+  warn "git user.name unchanged (pass -n or set GIT_NAME)"
+fi
+
+if [[ -n "$GIT_EMAIL" ]]; then
+  git config --global user.email "$GIT_EMAIL"
+  ok "git user.email ${D}→ $GIT_EMAIL${R}"
+else
+  warn "git user.email unchanged (pass -e or set GIT_EMAIL)"
+fi
+
+git config --global init.defaultBranch main
+git config --global push.default simple
+ok "git init.defaultBranch = main, push.default = simple"
+
+if [[ -n "$GIT_EDITOR" ]]; then
+  git config --global core.editor "$GIT_EDITOR"
+  ok "git core.editor ${D}→ $GIT_EDITOR${R}"
+fi
+
+echo ""
+echo -e "  ${GRN}Done!${R} Run ${CYN}gh auth login${R} to authenticate"
+echo -e "  ${D}Git config: ~/.gitconfig${R}"
+echo ""

package/runtime/modules/github/module.toml

@@ -0,0 +1,8 @@
+name = "github"
+description = "GitHub CLI and global git config without credentials"
+platforms = ["mac", "linux"]
+kind = "config"
+
+[detect]
+commands = ["gh"]
+paths = ["~/.gitconfig"]