# Bash Script Installer for Zsh The "Bash Script Installer" simplifies the setup of Zsh. ## Zsh ### Ubuntu ```zsh bash -c "$(curl -fsSL https://tinyurl.com/y6fhb594)" ``` ### WSL ```zsh bash -c "$(curl -fsSL https://tinyurl.com/ycyct6wp)" ``` ### MacOS ```zsh bash -c "$(curl -fsSL https://tinyurl.com/yptybtpa)" ``` ### Configuration ```zsh bash -c "$(curl -fsSL https://tinyurl.com/y8vf753j)" ``` ### Shell framework and prompt The installers use Oh My Zsh for framework features and plugins, with the OMZ theme disabled: ```zsh ZSH_THEME="" source "$ZSH/oh-my-zsh.sh" eval "$(starship init zsh)" ``` Starship owns the prompt and loads after Oh My Zsh. The managed Starship config is installed at `~/.config/starship.toml`. A Nerd Font is required for the Powerline symbols.

# ============================================================================= # OS-SPECIFIC ALIASES # ============================================================================= if [[ "$OSTYPE" == "linux-gnu"* ]] && command -v apt-get >/dev/null 2>&1; then # Linux Only System update & cleanup alias uu='sudo apt-get update && \ sudo apt-get upgrade -y && \ sudo apt-get full-upgrade -y && \ sudo apt-get autoremove -y && \ sudo apt-get autoclean -y && \ sudo apt-get clean' elif [[ "$OSTYPE" == "darwin"* ]]; then # macOS Only alias flushdns='sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder' fi # ============================================================================= # UNIVERSAL GIT ALIASES (Fixed: Removed broken "$@" from aliases) # ============================================================================= alias gph='git push' alias gco='git checkout' alias gbh='git branch' alias gmt='git commit' alias gpl='git pull' alias grb='git rebase' alias grt='git reset' alias gst='git status' alias grmrf='git checkout -- . && git clean -fd'

#!/bin/bash set -euo pipefail # Configuration GIST_RAW_BASE="https://opengist.resetrix.work/weehong/f0d940c3c1214bf5b7996195199fdc09/raw/HEAD" CONFIG_FILES=( ".alias" ".func" ".pathrc" ".sourcerc" ".vimrc" ".zshrc" ".config/starship.toml" ) echo "Starting configuration download..." for f in "${CONFIG_FILES[@]}"; do # Remove the leading dot for the URL path remote_name="${f#.}" [[ "$f" == ".config/starship.toml" ]] && remote_name="starship.toml" url="$GIST_RAW_BASE/$remote_name" target="$HOME/$f" echo "Downloading $f..." mkdir -p "$(dirname "$target")" # Use -f to fail silently on server errors, -s for silent, -L to follow redirects if curl -fsSL "$url" -o "$target"; then echo "Successfully updated $target" else echo "Error: Failed to download $f from $url" >&2 fi done echo "Done! All configuration files have been replaced."

# ============================================================================= # CUSTOM FUNCTIONS # ============================================================================= # ----------------------------------------------------------------------------- # Function: funcs (List available .func functions) # ----------------------------------------------------------------------------- funcs() { local func_file="${1:-$HOME/.func}" if [ ! -f "$func_file" ]; then printf "Error: Function file '%s' not found.\n" "$func_file" >&2 return 1 fi printf "Available functions in %s:\n" "$func_file" awk ' /^# Function: / { line = $0 sub(/^# Function: /, "", line) name = line sub(/ .*/, "", name) desc = "" if (line ~ / \(.+\)$/) { desc = line sub(/^[^ ]+ \(/, "", desc) sub(/\)$/, "", desc) } if (desc != "") { printf " %-22s %s\n", name, desc } else { printf " %s\n", name } } ' "$func_file" } # ----------------------------------------------------------------------------- # Function: clip (Cross-platform clipboard) # ----------------------------------------------------------------------------- clip() { local cmd local args=() if command -v pbcopy >/dev/null 2>&1; then cmd="pbcopy" # macOS elif grep -qi "microsoft" /proc/version 2>/dev/null && command -v clip.exe >/dev/null 2>&1; then cmd="clip.exe" # WSL elif [ "$XDG_SESSION_TYPE" = "wayland" ] && command -v wl-copy >/dev/null 2>&1; then cmd="wl-copy" # Linux Wayland elif command -v xclip >/dev/null 2>&1; then cmd="xclip" # Linux X11 (Fallback 1) args=("-selection" "clipboard") elif command -v xsel >/dev/null 2>&1; then cmd="xsel" # Linux X11 (Fallback 2) args=("--clipboard" "--input") else printf "Error: No supported clipboard utility found.\n" >&2 return 1 fi if [ $# -gt 0 ]; then if [ -f "$1" ]; then "$cmd" "${args[@]}" < "$1" echo "Copied contents of '$1' to clipboard." else printf "Error: File '%s' not found.\n" "$1" >&2 return 1 fi else "$cmd" "${args[@]}" fi } # ----------------------------------------------------------------------------- # Function: open_file (Cross-platform file/directory opener) # ----------------------------------------------------------------------------- open_file() { local target="${1:-.}" if [[ "$OSTYPE" == "darwin"* ]]; then command open "$target" elif grep -qi "microsoft" /proc/version 2>/dev/null; then if command -v wslpath >/dev/null 2>&1 && command -v explorer.exe >/dev/null 2>&1; then explorer.exe "$(wslpath -w "$target")" else printf "Error: 'wslpath' or 'explorer.exe' not found.\n" >&2 return 1 fi elif [[ "$OSTYPE" == "linux-gnu"* ]]; then if command -v xdg-open >/dev/null 2>&1; then xdg-open "$target" else printf "Error: 'xdg-open' not found.\n" >&2 return 1 fi fi } alias open='open_file' # ----------------------------------------------------------------------------- # Function: clear_history (Supports shell, Claude, Codex, and OpenCode) # ----------------------------------------------------------------------------- clear_history() { case "${1:-}" in claude) if [ -d "$HOME/.claude/projects" ]; then # Use 'yes' to skip prompts and -f to ignore non-existent files yes | rm -rf "$HOME/.claude/projects"/* echo "Claude project history/cache cleared." fi ;; codex) local codex_home="${CODEX_HOME:-$HOME/.codex}" local codex_session_file local codex_session_id mkdir -p "$codex_home" : > "$codex_home/history.jsonl" if command -v codex >/dev/null 2>&1; then find "$codex_home/sessions" "$codex_home/archived_sessions" -type f -name '*.jsonl' -print 2>/dev/null | while IFS= read -r codex_session_file; do codex_session_id="$(sed -n 's/.*"session_id":"\([^"]*\)".*/\1/p; q' "$codex_session_file")" if [ -n "$codex_session_id" ]; then codex delete --force "$codex_session_id" >/dev/null 2>&1 || true fi done fi rm -rf "$codex_home/sessions" "$codex_home/archived_sessions" "$codex_home/shell_snapshots" mkdir -p "$codex_home/sessions" "$codex_home/archived_sessions" "$codex_home/shell_snapshots" echo "Codex history cleared." ;; opencode) local opencode_state_home="${XDG_STATE_HOME:-$HOME/.local/state}/opencode" local opencode_data_home="${XDG_DATA_HOME:-$HOME/.local/share}/opencode" mkdir -p "$opencode_state_home" "$opencode_data_home" : > "$opencode_state_home/prompt-history.jsonl" rm -f \ "$opencode_data_home/opencode.db" \ "$opencode_data_home/opencode.db-shm" \ "$opencode_data_home/opencode.db-wal" rm -rf "$opencode_data_home/repos" "$opencode_data_home/log" mkdir -p "$opencode_data_home/repos" "$opencode_data_home/log" echo "OpenCode history cleared." ;; *) # 1. Truncate the file : > "$HISTFILE" # 2. Clear RAM by briefly setting history size to 0 local old_histsize=$HISTSIZE HISTSIZE=0 HISTSIZE=$old_histsize echo "Shell history cleared." ;; esac } # ----------------------------------------------------------------------------- # Function: require_cli (Check external CLI availability) # ----------------------------------------------------------------------------- require_cli() { local binary="$1" local label="$2" local resolved if command -v whence >/dev/null 2>&1; then if whence -p "$binary" >/dev/null 2>&1; then return 0 fi else resolved="$(command -v "$binary" 2>/dev/null)" || resolved="" if [ -n "$resolved" ] && [ -x "$resolved" ]; then return 0 fi fi printf "Error: %s ('%s') is not installed or not in your PATH.\n" "$label" "$binary" >&2 return 1 } # ----------------------------------------------------------------------------- # Function: claude (Includes --yolo and clear shortcuts) # ----------------------------------------------------------------------------- claude() { # Shortcut for clearing cache if [[ "$1" == "clear" ]]; then clear_history claude return 0 fi # Check if binary exists require_cli claude "Claude Code CLI" || return 1 # Handle --yolo mode if [[ "$1" == "--yolo" ]]; then shift command claude --dangerously-skip-permissions "$@" return $? fi command claude "$@" } # ----------------------------------------------------------------------------- # Internal: _prompt_confirm_indexing (Confirm project indexing via the terminal) # ----------------------------------------------------------------------------- _prompt_confirm_indexing() { local project_root="$1" local reply if ! (: </dev/tty) 2>/dev/null; then printf "Notice: No interactive terminal available; enhancing without project indexing.\n" >&2 return 1 fi printf "Allow Auggie to index and use project context from '%s'? (y/N) " "$project_root" >/dev/tty if ! IFS= read -r reply </dev/tty; then printf "\nNotice: Unable to read confirmation; enhancing without project indexing.\n" >&2 return 1 fi case "$reply" in y|Y|yes|YES|Yes) return 0 ;; *) return 1 ;; esac } # ----------------------------------------------------------------------------- # Internal: _enhance_prompt (Run Auggie and write only the enhanced prompt) # ----------------------------------------------------------------------------- _enhance_prompt() { local prompt="$1" local output_file="$2" local run_dir local prompt_file local workspace local cache_dir local auth_file local log_file local parsed_file local project_root local use_project_context local script_pid local waited local timeout_seconds local monitor_status if [ -z "$prompt" ]; then printf "Error: Prompt was empty.\n" >&2 return 1 fi if [ ! -s "$HOME/.augment/session.json" ]; then printf "Error: Auggie session file not found. Run 'auggie login' first.\n" >&2 return 1 fi run_dir="$(mktemp -d "${TMPDIR:-/tmp}/auggie-enhance.XXXXXX")" || return 1 prompt_file="$run_dir/prompt.txt" workspace="$run_dir/workspace" cache_dir="$run_dir/cache" auth_file="$HOME/.augment/session.json" log_file="$run_dir/auggie.log" parsed_file="$run_dir/enhanced.txt" mkdir -p "$workspace" "$cache_dir" printf "%s\n" "$prompt" > "$prompt_file" project_root="$(git rev-parse --show-toplevel 2>/dev/null)" || project_root="$PWD" use_project_context=0 timeout_seconds=90 if _prompt_confirm_indexing "$project_root"; then use_project_context=1 timeout_seconds=300 workspace="$project_root" cache_dir="$HOME/.augment" printf "Indexing approved; enhancing with project context from '%s'.\n" "$project_root" >&2 else printf "Enhancing without project indexing.\n" >&2 fi ( if [ "$use_project_context" -eq 1 ]; then AUGGIE_PROMPT_FILE="$prompt_file" \ AUGGIE_WORKSPACE="$workspace" \ AUGGIE_CACHE_DIR="$cache_dir" \ AUGGIE_AUTH_FILE="$auth_file" \ script -q -f -O "$log_file" -c 'auggie --print --enhance-prompt --workspace-root "$AUGGIE_WORKSPACE" --augment-cache-dir "$AUGGIE_CACHE_DIR" --augment-session-json "$AUGGIE_AUTH_FILE" --allow-indexing --wait-for-indexing --dont-save-session --instruction-file "$AUGGIE_PROMPT_FILE"' </dev/null >/dev/null 2>&1 & else AUGGIE_PROMPT_FILE="$prompt_file" \ AUGGIE_WORKSPACE="$workspace" \ AUGGIE_CACHE_DIR="$cache_dir" \ AUGGIE_AUTH_FILE="$auth_file" \ script -q -f -O "$log_file" -c 'auggie --print --enhance-prompt --no-discover-workspaces --workspace-root "$AUGGIE_WORKSPACE" --augment-cache-dir "$AUGGIE_CACHE_DIR" --augment-session-json "$AUGGIE_AUTH_FILE" --dont-save-session --instruction-file "$AUGGIE_PROMPT_FILE"' </dev/null >/dev/null 2>&1 & fi script_pid=$! waited=0 while kill -0 "$script_pid" >/dev/null 2>&1; do if grep -aq "🤖" "$log_file" 2>/dev/null || grep -aq "Tool call:" "$log_file" 2>/dev/null; then kill "$script_pid" >/dev/null 2>&1 || true wait "$script_pid" >/dev/null 2>&1 || true exit 0 fi if [ "$waited" -ge "$timeout_seconds" ]; then kill "$script_pid" >/dev/null 2>&1 || true wait "$script_pid" >/dev/null 2>&1 || true exit 124 fi sleep 1 waited=$((waited + 1)) done wait "$script_pid" >/dev/null 2>&1 || true exit 0 ) monitor_status=$? if [ "$monitor_status" -eq 124 ]; then printf "Error: Timed out waiting for Auggie to enhance the prompt.\n" >&2 rm -rf "$run_dir" return 124 fi perl -ne ' # Auggie redraws streamed terminal lines with carriage returns. Keep only # the final rendered segment so stale text cannot corrupt the prompt. s/\r$//; s/.*\r//; 1 while s/[^\x08]\x08//g; s/\x08//g; s/\e\][^\a]*(?:\a|\e\\)//g; s/\e\[[0-?]*[ -\/]*[@-~]//g; next if /Script started on/ || /Script done on/; if (/^(?:✨\s*)?Enhanced prompt:\s*(.*)$/) { $capturing = 1; $output .= "$1\n" if length $1; next; } next unless $capturing; exit if /^🤖/ || /Tool call:/ || /Session terminated/; $output .= $_; END { $output =~ s/^\s*\n//; $output =~ s/\s+\z//; print "$output\n" if length $output; } ' "$log_file" > "$parsed_file" if [ ! -s "$parsed_file" ]; then printf "Error: Auggie did not return an enhanced prompt.\n" >&2 rm -rf "$run_dir" return 1 fi if ! command cp "$parsed_file" "$output_file"; then printf "Error: Unable to save the enhanced prompt.\n" >&2 rm -rf "$run_dir" return 1 fi rm -rf "$run_dir" } # ----------------------------------------------------------------------------- # Function: prompt (Enhance a prompt with Auggie and optional project context) # ----------------------------------------------------------------------------- prompt() { local prompt local line local output_file require_cli auggie "Auggie CLI" || return 1 require_cli script "script utility" || return 1 if [ $# -gt 0 ]; then prompt="$*" elif [ ! -t 0 ]; then prompt="$(cat)" else echo "Reading prompt... Type 'EOF' on a new line and press Enter when finished." prompt="" while IFS= read -r line; do [ "$line" = "EOF" ] && break if [ -z "$prompt" ]; then prompt="$line" else prompt="${prompt}"$'\n'"${line}" fi done fi if [ -z "$prompt" ]; then printf "Error: Prompt was empty.\n" >&2 return 1 fi output_file="$(mktemp "${TMPDIR:-/tmp}/auggie-enhanced-prompt.XXXXXX")" || return 1 if ! _enhance_prompt "$prompt" "$output_file"; then rm -f "$output_file" return 1 fi printf "Enhanced prompt:\n" command cat "$output_file" rm -f "$output_file" command auggie account status } # ----------------------------------------------------------------------------- # Function: plan_build (Claude Code multi-agent workflow orchestrator) # ----------------------------------------------------------------------------- plan_build() { local claude_args=() local use_yolo=0 local enhance_payload=0 while [ $# -gt 0 ]; do case "$1" in --yolo) if [ "$use_yolo" -eq 1 ]; then echo "Error: Duplicate argument: --yolo" echo "Usage: plan_build [--yolo] [--prompt]" return 1 fi use_yolo=1 claude_args=(--yolo) ;; --prompt) if [ "$enhance_payload" -eq 1 ]; then echo "Error: Duplicate argument: --prompt" echo "Usage: plan_build [--yolo] [--prompt]" return 1 fi enhance_payload=1 ;; *) echo "Error: Unknown argument: $1" echo "Usage: plan_build [--yolo] [--prompt]" return 1 ;; esac shift done require_cli claude "Claude Code CLI" || return 1 require_cli codex "Codex CLI" || return 1 require_cli coderabbit "CodeRabbit CLI" || return 1 if [ "$enhance_payload" -eq 1 ]; then require_cli auggie "Auggie CLI" || return 1 require_cli script "script utility" || return 1 fi echo "📥 Reading payload... Type 'EOF' on a new line and press Enter when finished." local payload local line payload="" while IFS= read -r line; do [ "$line" = "EOF" ] && break if [ -z "$payload" ]; then payload="$line" else payload="${payload}"$'\n'"${line}" fi done if [ -z "$payload" ]; then echo "❌ Error: Payload was empty." return 1 fi if [ "$enhance_payload" -eq 1 ]; then local enhanced_file enhanced_file="$(mktemp "${TMPDIR:-/tmp}/plan-build-enhanced.XXXXXX")" || return 1 echo "✨ Enhancing payload with Auggie..." if ! _enhance_prompt "$payload" "$enhanced_file"; then rm -f "$enhanced_file" echo "❌ Error: Prompt enhancement failed; Claude was not launched." return 1 fi payload="$(cat "$enhanced_file")" rm -f "$enhanced_file" if [ -z "$payload" ]; then echo "❌ Error: Enhanced payload was empty; Claude was not launched." return 1 fi fi echo "🚀 Launching Claude Code with your multi-agent workflow..." claude "${claude_args[@]}" "Please read \`~/.claude/skills/plan-build/SKILL.md\` and strictly follow the 7-step multi-agent workflow to implement the following task: $payload" } # ----------------------------------------------------------------------------- # Function: aicommit (Automated Conventional Commit Engine Wrapper) # ----------------------------------------------------------------------------- aicommit() { local diff engine prompt # 1. Get diff safely: exclude lock files/minified files and cap at ~100k characters to prevent CLI crashes diff=$(git diff --cached -- . ":(exclude)*.lock" ":(exclude)*-lock.json" ":(exclude)*.min.js" | head -c 100000) if [ -z "$diff" ]; then printf "❌ Error: Nothing staged to commit.\n" >&2 return 1 fi if [ ! -f "$HOME/.config/ai-commit-prompt.txt" ]; then printf "❌ Error: Configuration file not found at ~/.config/ai-commit-prompt.txt\n" >&2 printf "Please create it and paste your system prompt inside.\n" >&2 return 1 fi engine=${1:-claude} prompt=$(cat "$HOME/.config/ai-commit-prompt.txt") case "$engine" in claude) echo "🤖 Claude is analyzing staged changes..." cat "$HOME/.config/ai-commit-prompt.txt" <(echo -e "\n\nHere is the git diff:\n$diff") | command claude -p "Read the provided instructions and diff, then generate and execute the commit." ;; codex) echo "🤖 Codex is analyzing staged changes..." cat "$HOME/.config/ai-commit-prompt.txt" <(echo -e "\n\nHere is the git diff:\n$diff") \ | command codex --ask-for-approval never exec --sandbox workspace-write --ephemeral \ "Read the provided instructions and diff, then generate and execute the commit." ;; copilot) echo "🤖 Copilot is analyzing staged changes..." copilot -p "$prompt Here is the git diff: $diff" -s --no-ask-user --allow-tool='shell(git:*)' ;; opencode) echo "🤖 OpenCode is analyzing staged changes..." cat "$HOME/.config/ai-commit-prompt.txt" <(echo -e "\n\nHere is the git diff:\n$diff") | opencode run ;; *) printf "❌ Error: Invalid engine '%s'\n" "$engine" >&2 printf "Usage: aicommit [claude | codex | copilot | opencode]\n" >&2 return 1 ;; esac } # ----------------------------------------------------------------------------- # Function: create (Efficiently create file + parent dirs) # ----------------------------------------------------------------------------- create() { if ! command -v install >/dev/null 2>&1; then printf "Error: 'install' coreutil is not available.\n" >&2 return 1 fi if [ $# -eq 0 ]; then printf "Usage: create <file> [file ...]\n" >&2 return 2 fi for p in "$@"; do # Expand tilde manually if shell doesn't [[ "$p" == "~/"* ]] && p="${HOME}/${p#\~/}" if [ -z "$p" ] || [ "$p" = "/" ]; then printf "create: refusing to operate on '%s'\n" "$p" >&2 continue fi if [ -e "$p" ]; then printf "create: '%s' already exists. Skipping.\n" "$p" >&2 continue fi if install -D /dev/null "$p"; then echo "Created '$p'" fi done } # ----------------------------------------------------------------------------- # Function: kill_port (Kill or check the process using a port) # ----------------------------------------------------------------------------- kill_port() { local action="kill" local signal="TERM" local port local pids local pid case "${1:-}" in -c|--check) action="check" shift ;; -k|--kill) action="kill" shift ;; -f|--force) action="kill" signal="KILL" shift ;; -h|--help|"") printf "Usage: kill_port [--check|-c|--kill|-k|--force|-f] <port_number>\n" >&2 return 1 ;; esac port="${1:-}" if [[ ! "$port" =~ ^[0-9]+$ ]] || [ "$port" -lt 1 ] || [ "$port" -gt 65535 ]; then printf "Error: port must be a number between 1 and 65535.\n" >&2 printf "Usage: kill_port [--check|-c|--kill|-k|--force|-f] <port_number>\n" >&2 return 1 fi if [[ "$OSTYPE" == "darwin"* ]]; then pids="$( { lsof -nP -tiTCP:"$port" -sTCP:LISTEN 2>/dev/null lsof -nP -tiUDP:"$port" 2>/dev/null } | sort -u )" if [ -z "$pids" ]; then printf "Port %s is FREE\n" "$port" return 0 fi printf "Port %s is in use:\n" "$port" lsof -nP -iTCP:"$port" -sTCP:LISTEN -iUDP:"$port" 2>/dev/null else local port_hex local inodes port_hex="$(printf "%04X" "$port")" inodes="$( awk -v port="$port_hex" ' NR > 1 { split($2, local_addr, ":") if (toupper(local_addr[length(local_addr)]) == port && ($4 == "0A" || FILENAME ~ /udp/)) { print $10 } } ' /proc/net/tcp /proc/net/tcp6 /proc/net/udp /proc/net/udp6 2>/dev/null | sort -u )" if [ -z "$inodes" ]; then printf "Port %s is FREE\n" "$port" return 0 fi pids="" pids="$( find /proc/[0-9]*/fd -maxdepth 1 -type l -printf "%p %l\n" 2>/dev/null | awk -v inodes="$inodes" ' BEGIN { split(inodes, inode_list, " ") for (i in inode_list) { wanted["socket:[" inode_list[i] "]"] = 1 } } $2 in wanted { split($1, path, "/") print path[3] } ' | sort -u )" if [ -z "$pids" ]; then printf "Port %s is in use, but no readable process owner was found.\n" "$port" >&2 return 1 fi printf "Port %s is in use:\n" "$port" for pid in $pids; do if [ -r "/proc/$pid/cmdline" ]; then printf " PID %-8s %s\n" "$pid" "$(tr '\0' ' ' < "/proc/$pid/cmdline")" else printf " PID %s\n" "$pid" fi done fi if [ "$action" = "kill" ]; then for pid in $pids; do if kill "-$signal" "$pid" 2>/dev/null; then printf "Killed PID %s with SIG%s.\n" "$pid" "$signal" else printf "Error: failed to kill PID %s. Try with sudo or --force.\n" "$pid" >&2 return 1 fi done fi } # ----------------------------------------------------------------------------- # Function: append_path (Adds to session PATH if exists) # ----------------------------------------------------------------------------- append_path() { local dir="$1" if [ -d "$dir" ]; then case ":$PATH:" in *":$dir:"*) ;; *) PATH="$PATH:$dir" ;; esac elif [ "${SUPPRESS_WARNINGS:-0}" -ne 1 ]; then echo "Warning: $dir does not exist." >&2 fi } # ----------------------------------------------------------------------------- # Function: add_path_to_config (Fixed awk/sed injection) # ----------------------------------------------------------------------------- add_path_to_config() { local new_path="$1" local config_file="$HOME/.bashrc" [[ "$SHELL" == *"zsh"* ]] && config_file="$HOME/.zshrc" if [ -z "$new_path" ]; then printf "Usage: add_path_to_config <directory>\n" >&2 return 1 fi new_path="${new_path/#\~/$HOME}" if [ ! -d "$new_path" ]; then printf "Warning: '%s' does not exist. Add anyway? (y/N) " "$new_path" read -r REPLY [[ ! $REPLY =~ ^[Yy]$ ]] && return 1 fi # Check if already exists in file if grep -Fq "append_path \"$new_path\"" "$config_file"; then printf "Notice: Already in %s.\n" "$config_file" return 0 fi # Robust Injection: Use sed to insert before export PATH or just append if grep -q "^export PATH" "$config_file"; then sed -i.bak "/^export PATH/i append_path \"$new_path\"" "$config_file" else echo "append_path \"$new_path\"" >> "$config_file" echo "export PATH" >> "$config_file" fi printf "✅ Success: Added to %s\n" "$config_file" append_path "$new_path" && export PATH }

# Plan-Build Orchestrate Loop Use this workflow when `plan_build` hands Claude Code an implementation task. The goal is to keep Claude as the orchestrator while using Codex and CodeRabbit as independent review and validation agents. ## Operating Rules - Run from the project root. Treat the current working directory as the project to modify. - Preserve user work. Check `git status` before edits and do not revert unrelated changes. - Keep implementation scoped to the payload unless repository context proves a wider change is required. - Prefer existing project conventions, scripts, test commands, and dependency managers. - Do not call the task complete until validation has run or the reason it cannot run is documented. - If any agent reports a plausible correctness, security, data-loss, migration, or test risk, resolve it or explicitly document why it is not applicable. ## The 7-Step Workflow ### 1. Intake Read the user payload fully. Identify: - Objective and expected user-visible behavior. - Files, modules, commands, and frameworks likely involved. - Constraints from repository docs, package scripts, CI config, and existing patterns. - Any ambiguity that blocks safe execution. Only ask the user a question when no reasonable project-local assumption is safe. ### 2. Baseline Inspect the repository before changing files: ```bash git status --short rg --files ``` Then read the smallest useful set of files. Prefer `rg`, package manifests, tests, routing files, and nearby implementations over broad file dumps. ### 3. Plan Create a short implementation plan with concrete steps. Include validation commands. If the task touches behavior, data, auth, payments, destructive actions, or shared infrastructure, include a rollback or compatibility note. ### 4. Implement Make the change in small, reviewable edits: - Follow existing style and abstractions. - Add or update tests when behavior changes. - Update docs only when user-facing usage changes. - Avoid unrelated refactors and formatting churn. After each meaningful edit group, re-check the diff for accidental changes. ### 5. Codex Review Pass Ask Codex for an independent review of the local diff before finalizing. Provide the task, constraints, and current diff. Ask it to focus on bugs, edge cases, missing tests, regressions, and simpler project-native alternatives. Recommended prompt shape: ```text Review this change for correctness and risk. Prioritize bugs, regressions, missing tests, and mismatches with existing project patterns. Do not rewrite the whole solution unless a specific issue requires it. Task: <payload> Diff: <git diff> ``` Apply fixes for valid findings, then repeat this review pass if the fixes are non-trivial. ### 6. CodeRabbit Review Pass Run CodeRabbit on the branch or diff when available. Treat its output as advisory but investigate every concrete finding. If CodeRabbit cannot run locally, record the command attempted and the failure. Continue with manual validation rather than blocking indefinitely. ### 7. Validate And Close Run the planned validation commands, such as: ```bash npm test npm run lint pytest cargo test go test ./... ``` Use the commands that actually exist in the project. If validation fails, fix the issue and rerun the relevant command. If a failure is unrelated or environmental, capture the evidence. Before final response: - Confirm `git diff` contains only intended changes. - Summarize what changed. - Report validation run and result. - Note any remaining risks or commands that could not run.

# ============================================================================= # ENVIRONMENT & PATH CONFIGURATION # ============================================================================= # 1. Source functions first if [[ -f "$HOME/.func" && -r "$HOME/.func" ]]; then source "$HOME/.func" fi # 2. Define Root Variables export DOTNET_ROOT="$HOME/.dotnet" # 3. PATH INITIALIZATION # ----------------------------------------------------------------------------- append_path "$HOME/.local/bin" append_path "$DOTNET_ROOT" append_path "$DOTNET_ROOT/tools" append_path "$HOME/.opencode/bin" append_path "$HOME/Flutter/bin" # macOS specific paths if [[ "$OSTYPE" == "darwin"* ]]; then append_path "/Applications/Espanso.app/Contents/MacOS" fi # Finalize PATH export PATH

# ============================================================================= # FILE: ~/.sourcerc # Description: Initializes third-party package managers and external tools. # ============================================================================= # ============================================================================= # GENERAL ENV # ============================================================================= if [[ -f "$HOME/.local/bin/env" && -r "$HOME/.local/bin/env" ]]; then source "$HOME/.local/bin/env" fi # ============================================================================= # CLAUDE CODE / AI GATEWAY # ============================================================================= export ANTHROPIC_BASE_URL="https://gateway.ai.cloudflare.com/v1/9a71825e3842e918e0dff9ad84f50484/claude-code-gateway/anthropic" # ============================================================================= # SDKMAN (Java/Kotlin/Scala Version Manager) # ============================================================================= export SDKMAN_DIR="$HOME/.sdkman" if [[ -f "$SDKMAN_DIR/bin/sdkman-init.sh" && -r "$SDKMAN_DIR/bin/sdkman-init.sh" ]]; then source "$SDKMAN_DIR/bin/sdkman-init.sh" fi # ============================================================================= # NVM (Node Version Manager) # ============================================================================= export NVM_DIR="$HOME/.nvm" if [[ -f "$NVM_DIR/nvm.sh" && -r "$NVM_DIR/nvm.sh" ]]; then source "$NVM_DIR/nvm.sh" fi if [[ -f "$NVM_DIR/bash_completion" && -r "$NVM_DIR/bash_completion" ]]; then source "$NVM_DIR/bash_completion" fi # ============================================================================= # GOOGLE CLOUD SDK # ============================================================================= if [[ -f "$HOME/google-cloud-sdk/path.zsh.inc" ]]; then source "$HOME/google-cloud-sdk/path.zsh.inc" fi if [[ -f "$HOME/google-cloud-sdk/completion.zsh.inc" ]]; then source "$HOME/google-cloud-sdk/completion.zsh.inc" fi

"$schema" = 'https://starship.rs/config-schema.json' format = """ [](red)\ $os\ $username\ [](bg:peach fg:red)\ $directory\ [](bg:yellow fg:peach)\ $git_branch\ $git_status\ [](fg:yellow bg:green)\ $c\ $rust\ $golang\ $nodejs\ $bun\ $php\ $java\ $kotlin\ $haskell\ $python\ [](fg:green bg:sapphire)\ $conda\ [](fg:sapphire bg:lavender)\ $time\ [ ](fg:lavender)\ $cmd_duration\ $line_break\ $character""" palette = 'catppuccin_mocha' [os] disabled = false style = "bg:red fg:crust" [os.symbols] Windows = "" Ubuntu = "󰕈" SUSE = "" Raspbian = "󰐿" Mint = "󰣭" Macos = "󰀵" Manjaro = "" Linux = "󰌽" Gentoo = "󰣨" Fedora = "󰣛" Alpine = "" Amazon = "" Android = "" AOSC = "" Arch = "󰣇" Artix = "󰣇" CentOS = "" Debian = "󰣚" Redhat = "󱄛" RedHatEnterprise = "󱄛" [username] show_always = true style_user = "bg:red fg:crust" style_root = "bg:red fg:crust" format = '[ $user]($style)' [directory] style = "bg:peach fg:crust" format = "[ $path ]($style)" truncation_length = 3 truncation_symbol = "…/" [directory.substitutions] "Documents" = "󰈙 " "Downloads" = " " "Music" = "󰝚 " "Pictures" = " " "Developer" = "󰲋 " [git_branch] symbol = "" style = "bg:yellow" format = '[[ $symbol $branch ](fg:crust bg:yellow)]($style)' [git_status] style = "bg:yellow" format = '[[($all_status$ahead_behind )](fg:crust bg:yellow)]($style)' [nodejs] symbol = "" style = "bg:green" format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)' [bun] symbol = "" style = "bg:green" format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)' [c] symbol = " " style = "bg:green" format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)' [rust] symbol = "" style = "bg:green" format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)' [golang] symbol = "" style = "bg:green" format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)' [php] symbol = "" style = "bg:green" format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)' [java] symbol = " " style = "bg:green" format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)' [kotlin] symbol = "" style = "bg:green" format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)' [haskell] symbol = "" style = "bg:green" format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)' [python] symbol = "" style = "bg:green" format = '[[ $symbol( $version)(\(#$virtualenv\)) ](fg:crust bg:green)]($style)' [docker_context] symbol = "" style = "bg:sapphire" format = '[[ $symbol( $context) ](fg:crust bg:sapphire)]($style)' [conda] symbol = "  " style = "fg:crust bg:sapphire" format = '[$symbol$environment ]($style)' ignore_base = false [time] disabled = false time_format = "%R" style = "bg:lavender" format = '[[  $time ](fg:crust bg:lavender)]($style)' [line_break] disabled = false [character] disabled = false success_symbol = '[❯](bold fg:green)' error_symbol = '[❯](bold fg:red)' vimcmd_symbol = '[❮](bold fg:green)' vimcmd_replace_one_symbol = '[❮](bold fg:lavender)' vimcmd_replace_symbol = '[❮](bold fg:lavender)' vimcmd_visual_symbol = '[❮](bold fg:yellow)' [cmd_duration] show_milliseconds = true format = " in $duration " style = "bg:lavender" disabled = false show_notifications = true min_time_to_notify = 45000 [palettes.catppuccin_mocha] rosewater = "#f5e0dc" flamingo = "#f2cdcd" pink = "#f5c2e7" mauve = "#cba6f7" red = "#f38ba8" maroon = "#eba0ac" peach = "#fab387" yellow = "#f9e2af" green = "#a6e3a1" teal = "#94e2d5" sky = "#89dceb" sapphire = "#74c7ec" blue = "#89b4fa" lavender = "#b4befe" text = "#cdd6f4" subtext1 = "#bac2de" subtext0 = "#a6adc8" overlay2 = "#9399b2" overlay1 = "#7f849c" overlay0 = "#6c7086" surface2 = "#585b70" surface1 = "#45475a" surface0 = "#313244" base = "#1e1e2e" mantle = "#181825" crust = "#11111b" [palettes.catppuccin_frappe] rosewater = "#f2d5cf" flamingo = "#eebebe" pink = "#f4b8e4" mauve = "#ca9ee6" red = "#e78284" maroon = "#ea999c" peach = "#ef9f76" yellow = "#e5c890" green = "#a6d189" teal = "#81c8be" sky = "#99d1db" sapphire = "#85c1dc" blue = "#8caaee" lavender = "#babbf1" text = "#c6d0f5" subtext1 = "#b5bfe2" subtext0 = "#a5adce" overlay2 = "#949cbb" overlay1 = "#838ba7" overlay0 = "#737994" surface2 = "#626880" surface1 = "#51576d" surface0 = "#414559" base = "#303446" mantle = "#292c3c" crust = "#232634" [palettes.catppuccin_latte] rosewater = "#dc8a78" flamingo = "#dd7878" pink = "#ea76cb" mauve = "#8839ef" red = "#d20f39" maroon = "#e64553" peach = "#fe640b" yellow = "#df8e1d" green = "#40a02b" teal = "#179299" sky = "#04a5e5" sapphire = "#209fb5" blue = "#1e66f5" lavender = "#7287fd" text = "#4c4f69" subtext1 = "#5c5f77" subtext0 = "#6c6f85" overlay2 = "#7c7f93" overlay1 = "#8c8fa1" overlay0 = "#9ca0b0" surface2 = "#acb0be" surface1 = "#bcc0cc" surface0 = "#ccd0da" base = "#eff1f5" mantle = "#e6e9ef" crust = "#dce0e8" [palettes.catppuccin_macchiato] rosewater = "#f4dbd6" flamingo = "#f0c6c6" pink = "#f5bde6" mauve = "#c6a0f6" red = "#ed8796" maroon = "#ee99a0" peach = "#f5a97f" yellow = "#eed49f" green = "#a6da95" teal = "#8bd5ca" sky = "#91d7e3" sapphire = "#7dc4e4" blue = "#8aadf4" lavender = "#b7bdf8" text = "#cad3f5" subtext1 = "#b8c0e0" subtext0 = "#a5adcb" overlay2 = "#939ab7" overlay1 = "#8087a2" overlay0 = "#6e738d" surface2 = "#5b6078" surface1 = "#494d64" surface0 = "#363a4f" base = "#24273a" mantle = "#1e2030" crust = "#181926"

" Enable line numbers set number " Enable relative line numbers set relativenumber " Enable syntax highlighting syntax on " Set colorscheme colorscheme slate " Enable file type detection and plugins filetype plugin indent on " Set the tab width to 4 spaces set tabstop=4 set shiftwidth=4 set expandtab " Enable auto-indentation set autoindent set smartindent " Highlight current line set cursorline " Show matching parentheses set showmatch " Enable line wrapping set wrap " Enable mouse support set mouse=a " Enable clipboard access set clipboard=unnamedplus " Disable swap file set noswapfile " Enable incremental search set incsearch " Ignore case in search set ignorecase " Override ignorecase if search contains capital letters set smartcase " Display line and column number of the cursor position set ruler " Set the status line at the bottom set laststatus=2 " Show command in bottom bar set showcmd " Set command height set cmdheight=2 " Set history lines set history=1000 " Disable backup file set nobackup " Enable persistent undo set undofile " Set maximum number of undo levels set undolevels=1000 " Set undo directory if has("persistent_undo") silent !mkdir ~/.vim/undodir > /dev/null 2>&1 set undodir=~/.vim/undodir endif " Set search highlighting set hlsearch " Enable visual bell set visualbell " Set default file encoding set encoding=utf-8 " Set the leader key to space let mapleader = " " " Map <Leader>w to save the file nnoremap <Leader>w :w<CR> " Map <Leader>q to quit nnoremap <Leader>q :q<CR> " Map <Leader>x to save and quit nnoremap <Leader>x :wq<CR> " Enable folding set foldmethod=syntax set foldlevelstart=99 " Enable line wrapping at 80 characters set textwidth=80 set colorcolumn=80 " Add some basic key mappings " Map jj to escape insert mode inoremap jj <Esc> " Map <Leader>n to toggle line numbers nnoremap <Leader>n :set number!<CR> " Map <Leader>r to toggle relative line numbers nnoremap <Leader>r :set relativenumber!<CR> " Configure plugins (if you use a plugin manager like vim-plug) " Example with vim-plug: " call plug#begin('~/.vim/plugged') " Plug 'tpope/vim-sensible' " Plug 'preservim/nerdtree' " Plug 'junegunn/fzf', { 'do': { -> fzf#install() } } " Plug 'airblade/vim-gitgutter' " call plug#end() " NERDTree key mappings " nnoremap <C-n> :NERDTreeToggle<CR> " Enable automatic hard wrapping at textwidth (80 chars) set formatoptions+=t " Auto-wrap text using textwidth set formatoptions+=c " Auto-wrap comments using textwidth set formatoptions+=r " Continue comments when pressing Enter set formatoptions+=o " Continue comments when using 'o' or 'O' set formatoptions+=q " Allow formatting of comments with 'gq' set formatoptions+=n " Recognize numbered lists set formatoptions+=l " Don't break lines that were already long " Enable syntax highlighting syntax on " Increase memory limit for complex syntax parsing (Prevents E363) set maxmempattern=20000

#!/bin/bash set -euo pipefail # ============================= # COLORS & LOGGING # ============================= RED='\033[0;31m' GREEN='\033[0;32m' YELLOW='\033[1;33m' BLUE='\033[0;34m' NC='\033[0m' log() { echo -e "${BLUE}[INFO]${NC} $*"; } ok() { echo -e "${GREEN}[OK]${NC} $*"; } warn() { echo -e "${YELLOW}[WARN]${NC} $*"; } err() { echo -e "${RED}[ERROR]${NC} $*" >&2; } # ============================= # CONFIG # ============================= GIST_RAW_BASE="https://opengist.resetrix.work/weehong/f0d940c3c1214bf5b7996195199fdc09/raw/HEAD" CONFIG_FILES=( ".alias" ".func" ".pathrc" ".sourcerc" ".vimrc" ".zshrc" ".config/starship.toml" ) # ============================= # REQUIREMENTS # ============================= check_requirements() { if [[ $EUID -eq 0 ]]; then err "Do not run as root on macOS" exit 1 fi } # ============================= # INSTALLATION FUNCTIONS # ============================= install_oh_my_zsh() { log "Installing Oh My Zsh and plugins..." export RUNZSH=no export CHSH=no export KEEP_ZSHRC=yes if [[ ! -d "$HOME/.oh-my-zsh" ]]; then sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" --unattended else ok "Oh My Zsh already installed" fi local custom="${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}" local plugin_dir="$custom/plugins" mkdir -p "$plugin_dir" [[ -d "$plugin_dir/zsh-autosuggestions" ]] || \ git clone https://github.com/zsh-users/zsh-autosuggestions "$plugin_dir/zsh-autosuggestions" [[ -d "$plugin_dir/zsh-syntax-highlighting" ]] || \ git clone https://github.com/zsh-users/zsh-syntax-highlighting "$plugin_dir/zsh-syntax-highlighting" ok "Oh My Zsh plugins installed to $plugin_dir" } install_starship() { if command -v starship >/dev/null 2>&1 || [[ -f "$HOME/.local/bin/starship" ]]; then ok "Starship already installed" elif command -v brew >/dev/null 2>&1; then log "Installing Starship with Homebrew..." brew install starship ok "Starship installed" else log "Installing Starship..." mkdir -p "$HOME/.local/bin" curl -fsSL https://starship.rs/install.sh | sh -s -- -y -b "$HOME/.local/bin" ok "Starship installed" fi } download_configs() { log "Downloading custom config files..." local backup="$HOME/.config_backup_$(date +%Y%m%d_%H%M%S)" mkdir -p "$backup" for f in "${CONFIG_FILES[@]}"; do # Strip the leading dot for the download URL local remote_file="${f#.}" [[ "$f" == ".config/starship.toml" ]] && remote_file="starship.toml" local url="$GIST_RAW_BASE/$remote_file" local target="$HOME/$f" local tmp="${target}.tmp.$$" mkdir -p "$(dirname "$target")" if [[ -f "$target" ]]; then cp "$target" "$backup/" fi log "Fetching $remote_file -> $f ..." if curl -fsSL "$url" -o "$tmp"; then mv "$tmp" "$target" else rm -f "$tmp" warn "Failed to download $remote_file" fi done ok "Configs downloaded (Backup at $backup)" } configure_zshrc() { local zshrc="$HOME/.zshrc" log "Configuring .zshrc for Oh My Zsh and Starship..." touch "$zshrc" cp "$zshrc" "$HOME/.zshrc.backup_$(date +%Y%m%d_%H%M%S)" cat > "$zshrc" <<'EOF' # ============================================================================= # 1. HELPER FUNCTIONS & PATH # ============================================================================= source_if_readable() { local file="$1" if [[ -f "$file" && -r "$file" ]]; then source "$file" fi } export PATH="$HOME/.local/bin:$PATH" # ============================================================================= # 2. OH MY ZSH FRAMEWORK # ============================================================================= export ZSH="${ZSH:-$HOME/.oh-my-zsh}" ZSH_THEME="" plugins=( git zsh-autosuggestions zsh-syntax-highlighting ) source_if_readable "$ZSH/oh-my-zsh.sh" # ============================================================================= # 3. THIRD-PARTY INITIALIZATION & CUSTOM CONFIGS # ============================================================================= source_if_readable "$HOME/.sourcerc" source_if_readable "$HOME/.func" source_if_readable "$HOME/.pathrc" source_if_readable "$HOME/.alias" # ============================================================================= # 4. STARSHIP PROMPT # ============================================================================= if [[ -z "${STARSHIP_CONFIG:-}" && -f "$HOME/.config/starship.toml" ]]; then export STARSHIP_CONFIG="$HOME/.config/starship.toml" fi if command -v starship >/dev/null 2>&1; then eval "$(starship init zsh)" elif [[ -x "$HOME/.local/bin/starship" ]]; then eval "$("$HOME/.local/bin/starship" init zsh)" fi EOF ok ".zshrc configured for Oh My Zsh framework with Starship prompt" } switch_shell() { log "Starting Zsh session..." echo -e "${YELLOW}Type 'exit' to return to this installer menu.${NC}" echo "----------------------------------------" zsh -l echo "----------------------------------------" ok "Returned from Zsh session" } # ============================= # INTERACTIVE MENU # ============================= show_menu() { echo "===========================================" echo "macOS Minimal Zsh Setup - Choose what to do" echo "===========================================" echo " 0) Run ALL steps (1-5)" echo " 1) Install Oh My Zsh + plugins" echo " 2) Install Starship prompt" echo " 3) Download custom configs (~/.alias, .func, .vimrc, etc.)" echo " 4) Configure ~/.zshrc (Oh My Zsh + Starship)" echo " 5) Switch to Zsh (Temporary Sub-shell)" echo " 6) Quit" echo "===========================================" } run_choices() { local input read -p "Select: " input input="${input//,/ }" local -a to_run=() local -a to_exclude=() for item in $input; do if [[ "$item" == !* ]]; then to_exclude+=("${item:1}") elif [[ "$item" == "0" ]]; then to_run+=(1 2 3 4 5) else to_run+=("$item") fi done if [[ ${#to_run[@]} -gt 0 ]]; then for choice in "${to_run[@]}"; do local skip=false if [[ ${#to_exclude[@]} -gt 0 ]]; then for ex in "${to_exclude[@]}"; do if [[ "$choice" == "$ex" ]]; then skip=true break fi done fi $skip && continue case "$choice" in 1) install_oh_my_zsh ;; 2) install_starship ;; 3) download_configs ;; 4) configure_zshrc ;; 5) switch_shell ;; 6) exit 0 ;; *) warn "Skipping invalid option: $choice" ;; esac echo done fi } # ============================= # MAIN # ============================= main() { check_requirements while true; do show_menu run_choices read -p "Do you want to run more options? (y/n): " again [[ "$again" =~ ^[Yy]$ ]] || break done ok "macOS minimal Zsh configuration complete!" } main "$@"

#!/bin/bash set -euo pipefail # ============================= # COLORS & LOGGING # ============================= RED='\033[0;31m' GREEN='\033[0;32m' YELLOW='\033[1;33m' BLUE='\033[0;34m' NC='\033[0m' log() { echo -e "${BLUE}[INFO]${NC} $*"; } ok() { echo -e "${GREEN}[OK]${NC} $*"; } warn() { echo -e "${YELLOW}[WARN]${NC} $*"; } err() { echo -e "${RED}[ERROR]${NC} $*" >&2; } # ============================= # FLAGS & CONFIG # ============================= SKIP_PACKAGES=false SKIP_SHELL_CHANGE=false INSTALL_HOMEBREW=false GIST_RAW_BASE="https://opengist.resetrix.work/weehong/f0d940c3c1214bf5b7996195199fdc09/raw/HEAD" CONFIG_FILES=( ".alias" ".func" ".pathrc" ".sourcerc" ".vimrc" ".zshrc" ".config/starship.toml" ) # ============================= # OS DETECTION # ============================= detect_os() { if [[ "$OSTYPE" == "darwin"* ]]; then echo "macos" elif [ -f /etc/os-release ]; then . /etc/os-release echo "$ID" else echo "unknown" fi } # ============================= # REQUIREMENTS # ============================= check_requirements() { if [[ $EUID -eq 0 ]]; then err "Do not run as root. The script will request sudo when necessary." exit 1 fi if [[ "$(detect_os)" != "macos" ]] && ! command -v sudo >/dev/null 2>&1; then err "sudo required on Linux" exit 1 fi } # ============================= # INSTALLATION FUNCTIONS # ============================= update_system() { $SKIP_PACKAGES && return log "Updating system..." local os=$(detect_os) case "$os" in macos) brew update || warn "Homebrew update failed; continuing installer" ;; ubuntu|debian) sudo apt-get update -y if ! sudo apt-get upgrade -y; then warn "System upgrade did not complete. This can happen when apt wants to downgrade a package." warn "Continuing because the Zsh setup does not require OS package upgrades to finish." fi ;; fedora) sudo dnf upgrade -y || warn "System upgrade failed; continuing installer" ;; arch) sudo pacman -Syu --noconfirm || warn "System upgrade failed; continuing installer" ;; *) warn "Auto-update not supported for OS: $os" ;; esac ok "System update step finished" } install_packages() { $SKIP_PACKAGES && return log "Installing core packages..." local os=$(detect_os) case "$os" in macos) brew install zsh git vim curl wget unzip xz ;; ubuntu|debian) sudo apt-get install -y zsh git vim curl wget unzip zip build-essential xz-utils ;; fedora) sudo dnf install -y zsh git vim curl wget unzip zip @development-tools xz ;; arch) sudo pacman -S --noconfirm zsh git vim curl wget unzip zip base-devel xz ;; *) warn "Auto-install not supported for OS: $os. Please install zsh, git, vim, curl manually." ;; esac ok "Packages installed" } set_timezone() { log "Setting timezone to Asia/Singapore..." local os=$(detect_os) if [[ "$os" == "macos" ]]; then sudo systemsetup -settimezone Asia/Singapore >/dev/null else sudo timedatectl set-timezone Asia/Singapore fi ok "Timezone set to Asia/Singapore" } install_homebrew() { ! $INSTALL_HOMEBREW && return command -v brew >/dev/null 2>&1 && ok "Homebrew already installed" && return log "Installing Homebrew..." /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" ok "Homebrew installed" } configure_shell() { $SKIP_SHELL_CHANGE && return log "Changing default shell to zsh..." local zsh_path zsh_path="$(command -v zsh)" if ! grep -qx "$zsh_path" /etc/shells; then echo "$zsh_path" | sudo tee -a /etc/shells >/dev/null fi chsh -s "$zsh_path" ok "Shell changed (requires logout/login to take effect)" } install_oh_my_zsh() { log "Installing Oh My Zsh and plugins..." export RUNZSH=no export CHSH=no export KEEP_ZSHRC=yes if [[ ! -d "$HOME/.oh-my-zsh" ]]; then sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" --unattended else ok "Oh My Zsh already installed" fi local custom="${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}" local plugin_dir="$custom/plugins" mkdir -p "$plugin_dir" [[ -d "$plugin_dir/zsh-autosuggestions" ]] || git clone https://github.com/zsh-users/zsh-autosuggestions "$plugin_dir/zsh-autosuggestions" [[ -d "$plugin_dir/zsh-syntax-highlighting" ]] || git clone https://github.com/zsh-users/zsh-syntax-highlighting "$plugin_dir/zsh-syntax-highlighting" ok "Oh My Zsh plugins installed to $plugin_dir" } install_starship() { if command -v starship >/dev/null 2>&1 || [[ -f "$HOME/.local/bin/starship" ]]; then ok "Starship already installed" else log "Installing Starship prompt..." if command -v brew >/dev/null 2>&1; then brew install starship else mkdir -p "$HOME/.local/bin" curl -fsSL https://starship.rs/install.sh | sh -s -- -y -b "$HOME/.local/bin" fi ok "Starship installed" fi } download_configs() { log "Downloading custom config files from OpenGist..." local backup="$HOME/.config_backup_$(date +%Y%m%d_%H%M%S)" mkdir -p "$backup" for f in "${CONFIG_FILES[@]}"; do local remote_file="${f#.}" [[ "$f" == ".config/starship.toml" ]] && remote_file="starship.toml" local url="$GIST_RAW_BASE/$remote_file" local target="$HOME/$f" local tmp="${target}.tmp.$$" mkdir -p "$(dirname "$target")" if [[ -f "$target" ]]; then cp "$target" "$backup/" fi log "Fetching $remote_file -> $f ..." if curl -fsSL "$url" -o "$tmp"; then mv "$tmp" "$target" else rm -f "$tmp" warn "Failed to download $remote_file" fi done ok "Configs downloaded (Backup at $backup)" } configure_zshrc() { local zshrc="$HOME/.zshrc" log "Configuring .zshrc for Oh My Zsh and Starship..." touch "$zshrc" cp "$zshrc" "$HOME/.zshrc.backup_$(date +%Y%m%d_%H%M%S)" cat > "$zshrc" <<'EOF' # ============================================================================= # 1. HELPER FUNCTIONS & PATH # ============================================================================= source_if_readable() { local file="$1" if [[ -f "$file" && -r "$file" ]]; then source "$file" fi } export PATH="$HOME/.local/bin:$PATH" # ============================================================================= # 2. OH MY ZSH FRAMEWORK # ============================================================================= export ZSH="${ZSH:-$HOME/.oh-my-zsh}" ZSH_THEME="" plugins=( git zsh-autosuggestions zsh-syntax-highlighting ) source_if_readable "$ZSH/oh-my-zsh.sh" # ============================================================================= # 3. THIRD-PARTY INITIALIZATION & CUSTOM CONFIGS # ============================================================================= source_if_readable "$HOME/.sourcerc" source_if_readable "$HOME/.func" source_if_readable "$HOME/.pathrc" source_if_readable "$HOME/.alias" # ============================================================================= # 4. STARSHIP PROMPT # ============================================================================= if [[ -z "${STARSHIP_CONFIG:-}" && -f "$HOME/.config/starship.toml" ]]; then export STARSHIP_CONFIG="$HOME/.config/starship.toml" fi if command -v starship >/dev/null 2>&1; then eval "$(starship init zsh)" elif [[ -x "$HOME/.local/bin/starship" ]]; then eval "$("$HOME/.local/bin/starship" init zsh)" fi EOF ok ".zshrc configured for Oh My Zsh framework with Starship prompt" } switch_shell() { log "Starting Zsh session..." echo -e "${YELLOW}Type 'exit' to return to this installer menu.${NC}" echo "----------------------------------------" zsh -l echo "----------------------------------------" ok "Returned from Zsh session" } # ============================= # INTERACTIVE MENU # ============================= show_menu() { echo "===========================================" echo "Minimal Zsh Installer - Choose what to do" echo "===========================================" echo " 0) Run ALL steps (1-10)" echo " 1) Update system packages" echo " 2) Install core packages (zsh, git, vim, etc.)" echo " 3) Set Timezone (Asia/Singapore)" echo " 4) Install Homebrew" echo " 5) Configure shell (chsh - sets default shell)" echo " 6) Install Oh My Zsh + plugins" echo " 7) Install Starship prompt" echo " 8) Download custom configs (from OpenGist)" echo " 9) Configure ~/.zshrc (Oh My Zsh + Starship)" echo "10) Switch to Zsh (Temporary Sub-shell)" echo "11) Quit" echo "===========================================" } run_choices() { local input read -p "Select: " input input="${input//,/ }" local -a to_run=() local -a to_exclude=() for item in $input; do if [[ "$item" == !* ]]; then to_exclude+=("${item:1}") elif [[ "$item" == "0" ]]; then to_run+=(1 2 3 4 5 6 7 8 9 10) else to_run+=("$item") fi done for choice in "${to_run[@]}"; do local skip=false for ex in "${to_exclude[@]}"; do if [[ "$choice" == "$ex" ]]; then skip=true break fi done $skip && continue case "$choice" in 1) update_system ;; 2) install_packages ;; 3) set_timezone ;; 4) install_homebrew ;; 5) configure_shell ;; 6) install_oh_my_zsh ;; 7) install_starship ;; 8) download_configs ;; 9) configure_zshrc ;; 10) switch_shell ;; 11) log "Exiting..."; exit 0 ;; *) warn "Skipping invalid option: $choice" ;; esac echo done } # ============================= # MAIN # ============================= main() { check_requirements while true; do show_menu run_choices read -p "Do you want to run more options? (y/n): " again [[ "$again" =~ ^[Yy]$ ]] || break done ok "Zsh installation/configuration complete!" } main "$@"