# 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. ## Plan-build workflow `plan_build` launches Claude Code as the implementation orchestrator, with Codex and CodeRabbit as independent reviewers. The configuration installer also installs its workflow at `~/.claude/skills/plan-build/SKILL.md`. ```zsh plan_build # Standard plan and build plan_build --prompt # Enhance the payload with Auggie first plan_build --writing-plan # Superpowers implementation plan, Codex review, then build plan_build --prompt --brainstorm # Auggie, Superpowers design and plan, Codex review, then build plan_build --yolo --writing-plan # Pass --yolo through to Claude Code plan_build --v2 --grill # Run the standalone v2 script (adds --grill and --distribute) plan_build --v2 --distribute # v2 distributed mode: Codex implements BE, Kimi Code implements FE ``` `--brainstorm` and `--writing-plan` are mutually exclusive. They require the enabled `superpowers@claude-plugins-official` Claude Code plugin; `plan_build` reports the install or enable command and exits before Auggie when the requirement is not met. `--v2` downloads and runs the standalone [plan_build v2 script](https://opengist.resetrix.work/weehong/plan-build) on demand, forwarding every other argument to it. v2 adds the `--grill` planning mode (`mattpocock-skills:grilling`) and `--distribute` (backend items implemented by Codex, frontend items by Kimi Code, sequentially, after the FE/BE split is confirmed). `--distribute` additionally requires the `kimi` CLI. Without `--v2`, `plan_build` runs the built-in v1 function unchanged.

# ============================================================================= # 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" ) PLAN_BUILD_SKILL_TARGET="$HOME/.claude/skills/plan-build/SKILL.md" echo "Starting configuration download..." download_failed=0 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" tmp="${target}.tmp.$$" 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 "$tmp" && mv "$tmp" "$target"; then echo "Successfully updated $target" else rm -f "$tmp" echo "Error: Failed to download $f from $url" >&2 download_failed=1 fi done echo "Downloading Claude Code plan-build workflow..." mkdir -p "$(dirname "$PLAN_BUILD_SKILL_TARGET")" skill_tmp="${PLAN_BUILD_SKILL_TARGET}.tmp.$$" if curl -fsSL "$GIST_RAW_BASE/orchestrate-loop.md" -o "$skill_tmp" && mv "$skill_tmp" "$PLAN_BUILD_SKILL_TARGET"; then echo "Successfully updated $PLAN_BUILD_SKILL_TARGET" else rm -f "$skill_tmp" echo "Error: Failed to download the plan-build workflow" >&2 download_failed=1 fi if [ "$download_failed" -ne 0 ]; then echo "Configuration download completed with errors." >&2 exit 1 fi 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_superpowers_state() { awk ' BEGIN { RS = "}" state = "missing" printed = 0 } /"id"[[:space:]]*:[[:space:]]*"superpowers@claude-plugins-official"/ { state = "installed" if ($0 ~ /"enabled"[[:space:]]*:[[:space:]]*true/) { state = "enabled" } else if ($0 ~ /"enabled"[[:space:]]*:[[:space:]]*false/) { state = "disabled" } print state printed = 1 exit } END { if (!printed) { print state } } ' } _plan_build_superpowers_preflight() { local plugin_json local plugin_state case "${CLAUDE_CODE_SAFE_MODE:-}" in 1|true|TRUE|yes|YES|on|ON) echo "❌ Error: Claude Code safe mode disables Superpowers." echo "Unset CLAUDE_CODE_SAFE_MODE before using --brainstorm or --writing-plan." return 1 ;; esac if ! plugin_json="$(command claude plugin list --json 2>/dev/null)"; then echo "❌ Error: Unable to inspect Claude Code plugins." echo "Run 'claude plugin list' to diagnose the problem." return 1 fi plugin_state="$(printf '%s\n' "$plugin_json" | _plan_build_superpowers_state)" case "$plugin_state" in enabled) return 0 ;; disabled) echo "❌ Error: Claude Code Superpowers is installed but disabled." echo "Enable it with: claude plugin enable superpowers@claude-plugins-official" ;; missing) echo "❌ Error: Claude Code Superpowers is required for --brainstorm and --writing-plan." echo "Install it in Claude Code with: /plugin install superpowers@claude-plugins-official" ;; *) echo "❌ Error: Unable to determine Claude Code Superpowers status." echo "Run 'claude plugin list' to diagnose the problem." ;; esac return 1 } _plan_build_v2() { # v2 is the standalone plan_build script (adds --grill and --distribute), # fetched on demand from its own gist so this function never goes stale. local v2_url="https://opengist.resetrix.work/weehong/plan-build/raw/HEAD/plan_build.sh" local v2_file local v2_status require_cli curl "curl" || return 1 v2_file="$(mktemp "${TMPDIR:-/tmp}/plan-build-v2.XXXXXX")" || return 1 if ! curl -fsSL "$v2_url" -o "$v2_file"; then rm -f "$v2_file" echo "❌ Error: Unable to download plan_build v2 from $v2_url" return 1 fi bash "$v2_file" "$@" v2_status=$? rm -f "$v2_file" return $v2_status } plan_build() { local claude_args=() local use_yolo=0 local enhance_payload=0 local planning_mode="standard" local usage="Usage: plan_build [--v2] [--yolo] [--prompt] [--brainstorm | --writing-plan] --v2 forwards all other arguments to the standalone v2 script (adds --grill and --distribute)." local use_v2=0 local arg local passthrough=() for arg in "$@"; do if [ "$arg" = "--v2" ]; then use_v2=1 else passthrough+=("$arg") fi done if [ "$use_v2" -eq 1 ]; then _plan_build_v2 "${passthrough[@]}" return $? fi while [ $# -gt 0 ]; do case "$1" in --yolo) if [ "$use_yolo" -eq 1 ]; then echo "Error: Duplicate argument: --yolo" echo "$usage" return 1 fi use_yolo=1 claude_args=(--yolo) ;; --prompt) if [ "$enhance_payload" -eq 1 ]; then echo "Error: Duplicate argument: --prompt" echo "$usage" return 1 fi enhance_payload=1 ;; --brainstorm) if [ "$planning_mode" = "brainstorm" ]; then echo "Error: Duplicate argument: --brainstorm" echo "$usage" return 1 fi if [ "$planning_mode" != "standard" ]; then echo "Error: --brainstorm and --writing-plan are mutually exclusive." echo "$usage" return 1 fi planning_mode="brainstorm" ;; --writing-plan) if [ "$planning_mode" = "writing-plan" ]; then echo "Error: Duplicate argument: --writing-plan" echo "$usage" return 1 fi if [ "$planning_mode" != "standard" ]; then echo "Error: --brainstorm and --writing-plan are mutually exclusive." echo "$usage" return 1 fi planning_mode="writing-plan" ;; *) echo "Error: Unknown argument: $1" echo "$usage" return 1 ;; esac shift done require_cli claude "Claude Code CLI" || return 1 if [ "$planning_mode" != "standard" ]; then _plan_build_superpowers_preflight || return 1 fi 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 local review_reply 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 printf '\n%s\n' "━━━━━━━━━━━━━━━━ Auggie enhanced prompt ━━━━━━━━━━━━━━━━" printf '%s\n' "$payload" printf '%s\n\n' "━━━━━━━━━━━━━━━━ End enhanced prompt ━━━━━━━━━━━━━━━━━" if ! (: </dev/tty) 2>/dev/null; then echo "❌ Error: Cannot review the enhanced prompt without an interactive terminal; Claude was not launched." return 1 fi printf "Proceed with this enhanced prompt? (y/N) " >/dev/tty if ! IFS= read -r review_reply </dev/tty; then printf '\n' >/dev/tty echo "🛑 Review cancelled; Claude was not launched." return 1 fi case "$review_reply" in y|Y|yes|YES|Yes) echo "✅ Enhanced prompt approved." ;; *) echo "🛑 Enhanced prompt not approved; Claude was not launched." return 0 ;; esac fi local planning_instruction case "$planning_mode" in brainstorm) planning_instruction="Planning mode: brainstorm. Use the superpowers:brainstorming skill, including its approval gates and transition to superpowers:writing-plans. After the implementation plan is saved, return to the plan-build workflow for Codex plan review before implementation." ;; writing-plan) planning_instruction="Planning mode: writing-plan. Use the superpowers:writing-plans skill with the payload as the requirements. After the implementation plan is saved, return to the plan-build workflow for Codex plan review before implementation." ;; *) planning_instruction="Planning mode: standard. Create the workflow's normal short implementation plan." ;; esac echo "🚀 Launching Claude Code with your multi-agent workflow ($planning_mode planning)..." claude "${claude_args[@]}" "Please read \`~/.claude/skills/plan-build/SKILL.md\` and strictly follow the 8-step multi-agent workflow to implement the following task. $planning_instruction $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 --allowedTools 'Bash(git commit *)' --permission-mode dontAsk -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. When `plan_build` supplies "Distribution mode: on", Codex and Kimi Code also become the implementers (backend and frontend respectively) via the Distributed Implementation variant of step 5. ## 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 8-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 Follow the planning mode supplied by `plan_build`: - `standard`: Create a short implementation plan with concrete steps and validation commands. - `brainstorm`: Invoke `superpowers:brainstorming`, honor its design and written-spec approval gates, and let it transition to `superpowers:writing-plans` after approval. - `writing-plan`: Invoke `superpowers:writing-plans` directly, treating the payload as the requirements or specification. - `grill`: Invoke `mattpocock-skills:grilling` to relentlessly stress-test the payload and your intended approach with the user. After grilling concludes, write the workflow's normal short implementation plan incorporating what survived. For either Superpowers mode, save the artifacts at the paths selected by the skills. In `grill` mode, the short implementation plan is the planning artifact. When `writing-plans` reaches its execution handoff, return to this workflow instead of starting implementation: Codex must review the plan first. If the user rejects or cancels a required approval, stop cleanly without modifying implementation files. If the task touches behavior, data, auth, payments, destructive actions, or shared infrastructure, include a rollback or compatibility note. ### 4. Codex Plan Review Run this step only for `brainstorm`, `writing-plan`, and `grill` modes. Ask Codex for an independent, read-only review of the approved spec, when present, and the implementation plan before touching implementation files. Provide the original payload and artifact paths. Ask it to focus on requirement coverage, incorrect assumptions, unsafe migrations, missing edge cases, inadequate tests, and steps that are too vague to execute. Recommended prompt shape: ```text Review these planning artifacts before implementation. Check requirement coverage, technical correctness, repository fit, edge cases, migration or rollback risk, test coverage, and whether every step is executable. Report concrete findings only; do not modify files. Task: <payload> Spec: <spec path, if present> Implementation plan: <plan path> ``` Use a read-only, ephemeral Codex invocation. Resolve every valid finding in the artifacts and repeat the review if revisions are substantial. If an artifact is missing or empty, or Codex cannot complete the review, stop before implementation and report the failure. In `standard` mode, skip this step and continue directly to implementation. ### 5. Implement If `plan_build` supplied "Distribution mode: on", skip this step and step 6 and follow the Distributed Implementation variant (steps 5a–5c) below instead, then continue at step 7. 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. ### Distributed Implementation (distribution mode: on) In this variant you orchestrate and review only — you never implement, not even leftovers. Codex implements backend items; Kimi Code implements frontend items. #### 5a. Split And Confirm Tag every work item in the plan as `BE`, `FE`, or `unclear`. Present the full table to the user (AskUserQuestion) and have them confirm or reassign each item; `unclear` items must be assigned by the user to `BE` or `FE`. Dispatch nothing until every item is confirmed. #### 5b. Backend Phase (Codex) Check `git status` first so pre-existing work is never mixed in or reverted. Compose a self-contained brief: the task, constraints, the exact confirmed BE item list with file paths, project conventions, and validation commands. Dispatch: ```bash codex exec --full-auto "<brief>" ``` Then review the phase diff (`git diff`) yourself for correctness, scope, and convention fit. Send findings back to Codex as a new brief (findings plus the original context) — do not fix them yourself. Maximum 2 retry rounds; if valid findings remain after that, stop and report with the partial diff intact. An empty diff from a delegate counts as a failure: retry once with a sharpened brief, within the same 2-round bound. If the delegate CLI crashes or hangs, stop and report, preserving the partial diff. #### 5c. Frontend Phase (Kimi Code) Check `git status` again, then compose the FE brief the same way, and additionally include the now-implemented backend API surface (routes, types, request/response contracts) so the frontend builds against the real backend. Dispatch: ```bash kimi -p "<brief>" ``` (`-p` runs one prompt non-interactively and manages permissions itself; it cannot be combined with `--auto` or `--yolo`.) Review the phase diff and route findings back to Kimi under the same 2-round retry bound and failure rules as the backend phase. After both phases pass review, skip step 6 (the per-phase reviews above replace it — Codex cannot impartially review the half it wrote) and continue at step 7 with the combined diff. ### 6. Codex Code Review Pass Skip this step in distribution mode; the per-phase reviews in steps 5b–5c replace it. 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. ### 7. 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. ### 8. 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 "/opt/google-cloud-sdk/path.zsh.inc" ]]; then source "/opt/google-cloud-sdk/path.zsh.inc" fi if [[ -f "/opt/google-cloud-sdk/completion.zsh.inc" ]]; then source "/opt/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"

#!/usr/bin/env zsh set -eu repo_dir="${0:A:h}" source "$repo_dir/func" failures=0 assert_equal() { local expected="$1" local actual="$2" local label="$3" if [ "$actual" != "$expected" ]; then print -u2 -- "FAIL: $label (expected '$expected', got '$actual')" failures=$((failures + 1)) fi } assert_contains() { local output="$1" local expected="$2" local label="$3" if [[ "$output" != *"$expected"* ]]; then print -u2 -- "FAIL: $label (missing '$expected')" failures=$((failures + 1)) fi } plugin_state() { printf '%s\n' "$1" | _plan_build_superpowers_state } assert_equal "enabled" "$(plugin_state '[{"id":"superpowers@claude-plugins-official","enabled":true}]')" "compact enabled JSON" assert_equal "disabled" "$(plugin_state $'[\n {\n "enabled": false,\n "id": "superpowers@claude-plugins-official"\n }\n]')" "reordered disabled JSON" assert_equal "enabled" "$(plugin_state $'[\n {"enabled": false, "id": "other@market"},\n {"enabled": true, "id": "superpowers@claude-plugins-official"}\n]')" "multiple plugin JSON" assert_equal "missing" "$(plugin_state '[{"id":"coderabbit@claude-plugins-official","enabled":true}]')" "missing plugin JSON" assert_equal "installed" "$(plugin_state '[{"id":"superpowers@claude-plugins-official"}]')" "malformed plugin JSON" output="$(plan_build --brainstorm --writing-plan 2>&1)" && rc=0 || rc=$? assert_equal "1" "$rc" "mutually exclusive flags status" assert_contains "$output" "mutually exclusive" "mutually exclusive flags message" output="$(plan_build --brainstorm --brainstorm 2>&1)" && rc=0 || rc=$? assert_equal "1" "$rc" "duplicate brainstorm status" assert_contains "$output" "Duplicate argument: --brainstorm" "duplicate brainstorm message" output="$(plan_build --writing-plan --writing-plan 2>&1)" && rc=0 || rc=$? assert_equal "1" "$rc" "duplicate writing-plan status" assert_contains "$output" "Duplicate argument: --writing-plan" "duplicate writing-plan message" export CLAUDE_CODE_SAFE_MODE=1 output="$(_plan_build_superpowers_preflight 2>&1)" && rc=0 || rc=$? unset CLAUDE_CODE_SAFE_MODE assert_equal "1" "$rc" "safe mode status" assert_contains "$output" "safe mode disables Superpowers" "safe mode message" require_cli() { return 0; } _plan_build_superpowers_preflight() { return 0; } claude() { printf 'CLAUDE_ARGS:' printf ' <%s>' "$@" printf '\n' } output="$(printf 'build feature\nEOF\n' | plan_build --writing-plan --yolo 2>&1)" && rc=0 || rc=$? assert_equal "0" "$rc" "writing-plan launch status" assert_contains "$output" "Planning mode: writing-plan" "writing-plan prompt" assert_contains "$output" "<--yolo>" "yolo forwarding" output="$(printf 'build feature\nEOF\n' | plan_build --brainstorm 2>&1)" && rc=0 || rc=$? assert_equal "0" "$rc" "brainstorm launch status" assert_contains "$output" "Planning mode: brainstorm" "brainstorm prompt" output="$(printf 'build feature\nEOF\n' | plan_build 2>&1)" && rc=0 || rc=$? assert_equal "0" "$rc" "standard launch status" assert_contains "$output" "Planning mode: standard" "standard prompt" if [ "$failures" -ne 0 ]; then exit 1 fi print -- "PASS: plan_build tests"

" 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 local skill_target="$HOME/.claude/skills/plan-build/SKILL.md" local skill_tmp="${skill_target}.tmp.$$" mkdir -p "$(dirname "$skill_target")" log "Fetching orchestrate-loop.md -> .claude/skills/plan-build/SKILL.md ..." if curl -fsSL "$GIST_RAW_BASE/orchestrate-loop.md" -o "$skill_tmp"; then mv "$skill_tmp" "$skill_target" else rm -f "$skill_tmp" warn "Failed to download orchestrate-loop.md" fi 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 "$@"