chore(deps): update ivuorinen/actions action (v2026.01.21 → v2026.02.03)

Signed-off-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

.gitmodules

@@ -4,6 +4,11 @@
 	url = https://github.com/anishathalye/dotbot.git
 	ignore = dirty
 
+[submodule "dotbot-brew"]
+	path = tools/dotbot-brew
+	url = https://github.com/wren/dotbot-brew.git
+	ignore = dirty
+
 [submodule "dotbot-include"]
 	path = tools/dotbot-include
 	url = https://gitlab.com/gnfzdz/dotbot-include.git
@@ -24,6 +29,11 @@
 	url = https://github.com/tmux-plugins/tmux-sessionist.git
 	ignore = dirty
 
+[submodule "dotbot-pip"]
+	path = tools/dotbot-pip
+	url = https://github.com/sobolevn/dotbot-pip.git
+	ignore = dirty
+
 [submodule "tmux/tmux-suspend"]
 	path = config/tmux/plugins/tmux-suspend
 	url = https://github.com/MunifTanjim/tmux-suspend.git
@@ -53,8 +63,6 @@
 [submodule "tmux/tmux-resurrect"]
 	path = config/tmux/plugins/tmux-resurrect
 	url = https://github.com/tmux-plugins/tmux-resurrect.git
-	ignore = dirty
 [submodule "tmux/catppuccin"]
 	path = config/tmux/plugins/catppuccin
 	url = https://github.com/catppuccin/tmux.git
-	ignore = dirty

.ignore

@@ -6,5 +6,6 @@ config/tmux/plugins/**
 config/vim/plugged/**
 node_modules
 tools/antidote/**
+tools/dotbot-brew/**
 tools/dotbot-include/**
 tools/dotbot/**

add-submodules.sh

@@ -5,8 +5,12 @@ git submodule sync --recursive
 # dotbot and plugins
 git submodule add --name dotbot \
   -f https://github.com/anishathalye/dotbot.git tools/dotbot
+git submodule add --name dotbot-brew \
+  -f https://github.com/wren/dotbot-brew.git tools/dotbot-brew
 git submodule add --name dotbot-include \
   -f https://gitlab.com/gnfzdz/dotbot-include.git tools/dotbot-include
+git submodule add --name dotbot-pip \
+  -f https://github.com/sobolevn/dotbot-pip.git tools/dotbot-pip
 
 # other repos
 git submodule add --name cheat-community \
@@ -42,64 +46,26 @@ done
 # Mark certain repositories shallow
 git config -f .gitmodules submodule.antidote.shallow true
 
-_log() {
+# remove old submodules
-  if command -v msgr > /dev/null 2>&1; then
+folders=(
-    msgr run_done "$1"
+  "config/tmux/plugins/tpm"
-  else
+  "config/tmux/plugins/tmux"
-    echo "  [ok] $1"
+  "config/tmux/plugins/tmux-menus"
-  fi
+  "tools/dotbot-crontab"
-}
+  "tools/dotbot-snap"
-
+  "config/tmux/plugins/tmux-window-name"
-remove_old_submodule() {
+  "config/tmux/plugins/tmux-sensible"
-  local name="$1" path="$2"
+  "config/tmux/plugins/tmux-mode-indicator"
-
+  "config/tmux/plugins/tmux-yank"
-  # Remove working tree
+  "config/tmux/plugins/tmux-fzf-url"
-  if [ -d "$path" ]; then
+  "config/nvim-kickstart"
-    rm -rf "$path"
+  "local/bin/asdf"
-    _log "Removed $path"
+  "local/asdf"
-  fi
+  "tools/dotbot-asdf"
-
-  # Remove stale git index entry
-  git rm --cached "$path" 2> /dev/null || true
-
-  # Remove .git/config section keyed by path
-  git config --remove-section "submodule.$path" 2> /dev/null || true
-
-  # Skip name-based cleanup if no submodule name provided
-  [ -z "$name" ] && return 0
-
-  # Remove .git/config section keyed by name
-  git config --remove-section "submodule.$name" 2> /dev/null || true
-
-  # Remove .git/modules/<name>/ cached repository
-  if [ -d ".git/modules/$name" ]; then
-    rm -rf ".git/modules/$name"
-    _log "Removed .git/modules/$name"
-  fi
-}
-
-# remove old submodules (name:path pairs)
-old_submodules=(
-  "tmux/tpm:config/tmux/plugins/tpm"
-  ":config/tmux/plugins/tmux"
-  "tmux/tmux-menus:config/tmux/plugins/tmux-menus"
-  "dotbot-crontab:tools/dotbot-crontab"
-  "dotbot-snap:tools/dotbot-snap"
-  "tmux/tmux-window-name:config/tmux/plugins/tmux-window-name"
-  "tmux/tmux-sensible:config/tmux/plugins/tmux-sensible"
-  "tmux/tmux-mode-indicator:config/tmux/plugins/tmux-mode-indicator"
-  "tmux/tmux-yank:config/tmux/plugins/tmux-yank"
-  ":config/tmux/plugins/tmux-fzf-url"
-  "nvim-kickstart:config/nvim-kickstart"
-  "asdf:local/bin/asdf"
-  "asdf:local/asdf"
-  "dotbot-asdf:tools/dotbot-asdf"
-  "dotbot-pip:tools/dotbot-pip"
-  "dotbot-brew:tools/dotbot-brew"
 )
 
-for entry in "${old_submodules[@]}"; do
+for folder in "${folders[@]}"; do
-  name="${entry%%:*}"
+  [ -d "$folder" ] \
-  path="${entry#*:}"
+    && rm -rf "$folder" \
-  remove_old_submodule "$name" "$path"
+    && msgr run_done "Removed old submodule $folder"
 done

biome.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://biomejs.dev/schemas/2.3.11/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.3.1/schema.json",
   "vcs": {
     "enabled": true,
     "clientKind": "git",

config/fish/completions/kubectl.fish

@@ -0,0 +1 @@
+/Applications/OrbStack.app/Contents/MacOS/../Resources/completions/fish/kubectl.fish

config/fish/completions/orbctl.fish

@@ -0,0 +1 @@
+/Applications/OrbStack.app/Contents/MacOS/../Resources/completions/fish/orbctl.fish

config/homebrew/Brewfile

@@ -260,6 +260,8 @@ brew "php@8.2", link: true
 brew "php@8.3"
 # Pins GitHub Actions to full hashes and versions
 brew "pinact"
+# Execute binaries from Python packages in isolated environments
+brew "pipx"
 # Python version management
 brew "pyenv"
 # Migrate pip packages from one Python version to another

config/nvim/lua/plugins/ui.lua

@@ -40,8 +40,7 @@ return {
           operators = {},
           -- miscs = {}, -- Uncomment to turn off hard-coded styles
         },
-        -- Style of specific lsp hl groups (`:h lsp-highlight`)
+        lsp_styles = { -- Handles the style of specific lsp hl groups (see `:h lsp-highlight`).
-        lsp_styles = {
           virtual_text = {
             errors = { 'italic' },
             hints = { 'italic' },
@@ -73,8 +72,7 @@ return {
             enabled = true,
             indentscope_color = '',
           },
-          -- More integrations:
+          -- For more plugins integrations please scroll down (https://github.com/catppuccin/nvim#integrations)
-          -- github.com/catppuccin/nvim#integrations
         },
       }
 
@@ -117,8 +115,7 @@ return {
   {
     'dmtrKovalenko/fff.nvim',
     build = function()
-      -- Downloads prebuild binary or uses rustup
+      -- this will download prebuild binary or try to use existing rustup toolchain to build from source
-      -- toolchain to build from source
       -- (if you are using lazy you can use gb for rebuilding a plugin if needed)
       require('fff.download').download_or_build_binary()
     end,
@@ -127,8 +124,7 @@ return {
     opts = { -- (optional)
       debug = {
         enabled = true, -- we expect your collaboration at least during the beta
-        -- Share scores to help optimize scoring
+        show_scores = true, -- to help us optimize the scoring system, feel free to share your scores!
-        show_scores = true,
       },
     },
     -- No need to lazy-load with lazy.nvim.

install

@@ -15,7 +15,10 @@ git submodule update --init --recursive "${DOTBOT_DIR}"
 
 "${DOTBOT_BIN_PATH}" \
   -d "${BASEDIR}" \
+  --plugin-dir=tools/dotbot-asdf \
+  --plugin-dir=tools/dotbot-brew \
   --plugin-dir=tools/dotbot-include \
+  --plugin-dir=tools/dotbot-pip \
   -c "${CONFIG}" \
   "${@}"
 
@@ -26,7 +29,10 @@ if [ "${DOTBOT_HOST}" != "" ]; then
     echo "(!) Found $DOTBOT_HOST_CONFIG" &&
     "$DOTBOT_BIN_PATH" \
       -d "$BASEDIR" \
+      --plugin-dir=tools/dotbot-asdf \
+      --plugin-dir=tools/dotbot-brew \
       --plugin-dir=tools/dotbot-include \
+      --plugin-dir=tools/dotbot-pip \
       -c "$DOTBOT_HOST_CONFIG" \
       "${@}"
 fi

install.conf.yaml

@@ -78,3 +78,8 @@
 - shell:
     # Use my dotfiles manager to install everything
     - bash local/bin/dfm install all
+
+- pipx:
+    file: tools/requirements-pipx.txt
+    stdout: true
+    stderr: true

local/bin/dfm

@@ -15,37 +15,38 @@
 
 SCRIPT=$(basename "$0")
 
-# Require bash 4.0+ for associative arrays and mapfile
+# Detect the current shell
-if ((BASH_VERSINFO[0] < 4)); then
+CURRENT_SHELL=$(ps -p $$ -ocomm= | awk -F/ '{print $NF}')
-  echo "dfm requires bash 4.0+, found ${BASH_VERSION}"
-  if [[ "$(uname)" == "Darwin" ]]; then
-    if ! command -v brew &> /dev/null; then
-      echo "Installing Homebrew..."
-      /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
-    fi
-    echo "Installing modern bash via Homebrew..."
-    brew install bash
-    echo "Done. Restart your shell and run dfm again."
-  else
-    echo "Install bash 4.0+ and try again."
-  fi
-  exit 1
-fi
 
-# shellcheck disable=SC1091
+# Function to source files based on the shell
-source "$DOTFILES/config/shared.sh"
+source_file()
-# shellcheck disable=SC1090
-source "${DOTFILES}/local/bin/msgr"
-
-# Get description from a script file's @description tag
-get_script_description()
 {
-  local file="$1"
+  local file=$1
-  local desc
+  case "$CURRENT_SHELL" in
-  desc=$(sed -n '/@description/s/.*@description *\(.*\)/\1/p' "$file" | head -1)
+    fish)
-  echo "${desc:-No description available}"
+      if [[ -f "$file.fish" ]]; then
+        # shellcheck disable=SC1090
+        source "$file.fish"
+      else
+        echo "Fish shell file not found: $file.fish"
+        exit 1
+      fi
+      ;;
+    sh | bash | zsh)
+      # shellcheck disable=SC1090
+      source "$file"
+      ;;
+    *)
+      echo "Unsupported shell: $CURRENT_SHELL"
+      exit 1
+      ;;
+  esac
 }
 
+# Modify the source commands to use the new function
+source_file "$DOTFILES/config/shared.sh"
+source_file "${DOTFILES}/local/bin/msgr"
+
 # Menu builder
 menu_builder()
 {
@@ -53,9 +54,9 @@ menu_builder()
   local commands=("${@:2}")
   local width=60
 
-  printf "\n%s\n" "$(printf '%.s─' $(seq 1 "$width"))"
+  printf "\n%s\n" "$(printf '%.s─' $(seq 1 $width))"
   printf "%-${width}s\n" "  $title"
-  printf "%s\n" "$(printf '%.s─' $(seq 1 "$width"))"
+  printf "%s\n" "$(printf '%.s─' $(seq 1 $width))"
 
   for cmd in "${commands[@]}"; do
     local name=${cmd%%:*}
@@ -79,6 +80,7 @@ section_install()
     "imagick:Install ImageMagick CLI"
     "macos:Setup nice macOS defaults"
     "npm-packages:Install NPM Packages"
+    "ntfy:Install ntfy"
     "nvm-latest:Install latest lts node using nvm"
     "nvm:Install Node Version Manager (nvm)"
     "z:Install z"
@@ -98,7 +100,6 @@ section_install()
       $0 install npm-packages
       $0 install z
       msgr msg "Reloading configurations again..."
-      # shellcheck disable=SC1091
       source "$DOTFILES/config/shared.sh"
       msgr yay "All done!"
       ;;
@@ -207,11 +208,7 @@ section_brew()
     "untracked:List untracked brew packages"
   )
 
-  if ! x-have brew; then
+  x-have brew && {
-    msgr warn "brew not available, skipping"
-    return 0
-  fi
-
     case "$1" in
       install)
         brew bundle install --file="$BREWFILE" --force --quiet && msgr yay "Done!"
@@ -268,10 +265,10 @@ section_brew()
 
         array_diff BREW_LIST_UNTRACKED BREW_LIST_TRACKED_WITHOUT_DEPS BREW_LIST_BUNDLED
 
-      # If there are no untracked packages, return
+        # If there are no untracked packages, exit
         if [ ${#BREW_LIST_UNTRACKED[@]} -eq 0 ]; then
           msgr yay "No untracked packages found!"
-        return 0
+          exit 0
         fi
 
         echo "Untracked:"
@@ -289,6 +286,9 @@ section_brew()
 
       *) menu_builder "$USAGE_PREFIX" "${MENU[@]}" ;;
     esac
+  }
+
+  ! x-have brew && menu_builder "$USAGE_PREFIX" "brew not available on this system"
 }
 
 section_helpers()
@@ -305,10 +305,10 @@ section_helpers()
     "wezterm:Show wezterm keybindings"
   )
 
-  CMD="${1:-}"
+  CMD="$1"
-  [[ $# -gt 0 ]] && shift
+  shift
-  SECTION="${1:-}"
+  SECTION="$1"
-  [[ $# -gt 0 ]] && shift
+  shift
 
   case "$CMD" in
     path)
@@ -379,11 +379,7 @@ section_apt()
     "clean:Clean apt cache"
   )
 
-  if ! x-have apt; then
+  x-have apt && {
-    msgr warn "apt not available, skipping"
-    return 0
-  fi
-
     case "$1" in
       upkeep)
         sudo apt update \
@@ -393,11 +389,8 @@ section_apt()
         ;;
 
       install)
-      # if apt.txt is not found, return with error
+        # if apt.txt is not found, exit
-      if [ ! -f "$DOTFILES/tools/apt.txt" ]; then
+        [ ! -f "$DOTFILES/tools/apt.txt" ] && msgr err "apt.txt not found" && exit 0
-        msgr err "apt.txt not found"
-        return 1
-      fi
 
         # Load apt.txt, remove comments (even if trailing comment) and empty lines.
         #
@@ -433,6 +426,8 @@ section_apt()
       clean) sudo apt clean ;;
       *) menu_builder "$USAGE_PREFIX" "${MENU[@]}" ;;
     esac
+  }
+  ! x-have apt && menu_builder "$USAGE_PREFIX" "apt not available on this system"
 }
 
 section_docs()
@@ -539,13 +534,13 @@ section_check()
 
   case "$1" in
     a | arch)
-      [[ $2 == "" ]] && echo "$X_ARCH" && return 0
+      [[ $2 == "" ]] && echo "$X_ARCH" && exit 0
-      [[ $X_ARCH == "$2" ]] && return 0 || return 1
+      [[ $X_ARCH == "$2" ]] && exit 0 || exit 1
       ;;
 
     h | host | hostname)
-      [[ $2 == "" ]] && echo "$X_HOSTNAME" && return 0
+      [[ $2 == "" ]] && echo "$X_HOSTNAME" && exit 0
-      [[ $X_HOSTNAME == "$2" ]] && return 0 || return 1
+      [[ $X_HOSTNAME == "$2" ]] && exit 0 || exit 1
       ;;
 
     *) menu_builder "$USAGE_PREFIX" "${MENU[@]}" ;;
@@ -556,18 +551,33 @@ section_scripts()
 {
   USAGE_PREFIX="$SCRIPT scripts <command>"
 
+  # Get description from a file
+  get_script_description()
+  {
+    local file
+    local desc
+    file="$1"
+    desc=$(sed -n '/@description/s/.*@description *\(.*\)/\1/p' "$file" | head -1)
+    echo "${desc:-No description available}"
+  }
+
   # Collect scripts and their descriptions
-  local menu_items=()
+  declare -A SCRIPT_MENU
   for script in "$DOTFILES/scripts/install-"*.sh; do
     if [ -f "$script" ]; then
       name=$(basename "$script" .sh | sed 's/install-//')
       desc=$(get_script_description "$script")
-      menu_items+=("$name:$desc")
+      SCRIPT_MENU[$name]="$desc"
     fi
   done
 
   case "$1" in
     "")
+      # Show the menu
+      local menu_items=()
+      for name in "${!SCRIPT_MENU[@]}"; do
+        menu_items+=("$name:${SCRIPT_MENU[$name]}")
+      done
       menu_builder "$USAGE_PREFIX" "${menu_items[@]}"
       ;;
     *)
@@ -599,7 +609,7 @@ section_tests()
         echo "  $i"
       done
       ;;
-    msgr)
+    msg)
       # shellcheck disable=SC1010
       msgr done "msgr done"
       msgr done_suffix "msgr done_suffix"
@@ -623,7 +633,7 @@ usage()
 {
   echo ""
   msgr prompt "Usage: $SCRIPT <section> <command>"
-  echo "  Empty <command> prints <section> help."
+  echo $"  Empty <command> prints <section> help."
   echo ""
   section_install
   echo ""
@@ -644,8 +654,8 @@ usage()
 
 main()
 {
-  SECTION="${1:-}"
+  SECTION="$1"
-  [[ $# -gt 0 ]] && shift
+  shift
   # The main loop. The first keyword after $0 triggers section, or help.
   case "$SECTION" in
     install) section_install "$@" ;;
@@ -657,7 +667,7 @@ main()
     docs) section_docs "$@" ;;
     scripts) section_scripts "$@" ;;
     tests) section_tests "$@" ;;
-    *) usage && return 0 ;;
+    *) usage && exit 0 ;;
   esac
 }
 

local/bin/x-change-alacritty-theme

@@ -8,7 +8,7 @@ set -euo pipefail
 # Enable verbosity with VERBOSE=1
 VERBOSE="${VERBOSE:-0}"
 
-A_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/alacritty"
+A_DIR="$HOME/.config/alacritty"
 
 # Function to print usage information
 usage()

local/bin/x-clean-vendordirs

@@ -7,15 +7,13 @@
 # Author: Ismo Vuorinen 2025
 # License: MIT
 
-set -euo pipefail
-
 # Check if the user has provided a directory as an argument
-if [ "${1:-}" ]; then
+if [ "$1" ]; then
   # Check if the directory exists
   if [ -d "$1" ]; then
     CLEANDIR="$1"
   else
-    echo "Error: Directory $1 does not exist." >&2
+    msgr err "Directory $1 does not exist."
     exit 1
   fi
 else
@@ -29,7 +27,7 @@ remove_node_modules_vendor()
 
   # If the directory is a symlink, skip it
   if [ -L "$dir" ]; then
-    echo "Skipping symlink $dir"
+    msgr msg "Skipping symlink $dir"
     return
   fi
 
@@ -37,18 +35,18 @@ remove_node_modules_vendor()
   if [ -d "$dir" ]; then
     # If node_modules or vendor folder exists, remove it and all its contents
     if [ -d "$dir/node_modules" ]; then
-      echo "Removing $dir/node_modules"
+      msgr run "Removing $dir/node_modules"
       rm -rf "$dir/node_modules"
     fi
 
     if [ -d "$dir/vendor" ]; then
-      echo "Removing $dir/vendor"
+      msgr run "Removing $dir/vendor"
       rm -rf "$dir/vendor"
     fi
 
     # Recursively check subdirectories
     for item in "$dir"/*; do
-      [ -d "$item" ] && remove_node_modules_vendor "$item"
+      remove_node_modules_vendor "$item"
     done
   fi
 }

local/bin/x-env-list

@@ -1,4 +1,4 @@
-#!/usr/bin/env bash
+#!/bin/bash
 #
 # List environment variables grouped by the first part before underscore
 # protecting environment variables that possibly contain sensitive information.

local/bin/x-foreach

@@ -1,26 +1,18 @@
 #!/usr/bin/env bash
 #
-# Run a command in each directory matching a pattern.
+# foreach <folder> <commands that should be run to each file>
-#
+# foreach "ls -d */" "git status" # run git status in each folder
-# Usage: x-foreach <listing-command> <command> [args...]
-#   x-foreach "ls -d */" "git status"
 #
 # Source: https://github.com/mvdan/dotfiles/blob/master/.bin/foreach
 
-set -euo pipefail
+cmd=$1
-
-if [ $# -lt 2 ]; then
-  echo "Usage: $0 <listing-command> <command> [args...]"
-  exit 1
-fi
-
-listing=$1
 shift
 
-for dir in $(eval "$listing"); do
+for dir in $($cmd); do
   (
     echo "$dir"
     cd "$dir" || exit 1
-    "$@"
+    # shellcheck disable=SC2294,SC2034
+    eval "$@" # allow multiple commands like "foo && bar"
   )
 done

local/bin/x-ip

@@ -1,14 +1,4 @@
 #!/usr/bin/env bash
-#
-# Display external IP address.
-#
 # Source: https://github.com/thirtythreeforty/dotfiles/blob/master/bin/extip
 
-set -euo pipefail
+curl icanhazip.com "${@}"
-
-if ! command -v curl &> /dev/null; then
-  echo "Error: curl is required" >&2
-  exit 1
-fi
-
-curl -sf icanhazip.com

local/bin/x-localip

@@ -1,4 +1,4 @@
-#!/usr/bin/env bash
+#!/bin/bash
 #
 # x-localip: script to display the local IP addresses of the system
 #

local/bin/x-mkd

@@ -0,0 +1,50 @@
+#!/usr/bin/env bash
+#
+# Create a directory and cd into it
+# Usage: x-mkd <dir>
+
+set -euo pipefail
+
+# Set verbosity with VERBOSE=1
+VERBOSE="${VERBOSE:-0}"
+
+# Function to print usage information
+usage()
+{
+  echo "Usage: $0 <dir>"
+  exit 1
+}
+
+# Function to print messages if VERBOSE is enabled
+# $1 - message (string)
+msg()
+{
+  [[ "$VERBOSE" -eq 1 ]] && echo "$1"
+}
+
+# Function to create a directory and cd into it
+# $1 - directory to create and cd into (string)
+mkcd()
+{
+  local dir=$1
+
+  mkdir -p "$dir" && msg "Directory $dir created"
+
+  cd "$dir" || {
+    msg "Failed to cd into $dir"
+    exit 1
+  }
+  msg "Changed directory to $dir"
+}
+
+# Main function
+main()
+{
+  if [ "$#" -ne 1 ]; then
+    usage
+  fi
+
+  mkcd "$1"
+}
+
+main "$@"

local/bin/x-mkd.md

@@ -0,0 +1,19 @@
+# x-mkd
+
+Create a directory and immediately `cd` into it.
+
+## Usage
+
+```bash
+x-mkd <dir>
+```
+
+Set `VERBOSE=1` for status messages.
+
+## Example
+
+```bash
+x-mkd project && git init
+```
+
+<!-- vim: set ft=markdown spell spelllang=en_us cc=80 : -->

local/bin/x-multi-ping

@@ -39,6 +39,7 @@
 # Defaults
 LOOP=0
 SLEEP=1
+VERBOSE=0
 TIMEOUT=5
 
 usage()
@@ -59,6 +60,8 @@ while [[ $# -gt 0 ]]; do
       exit 0
       ;;
     --verbose)
+      # shellcheck disable=SC2034
+      VERBOSE=1
       shift
       ;;
     --loop | --forever)

local/bin/x-path

@@ -227,9 +227,6 @@ do_check()
   fi
 }
 
-# If sourced, provide functions without executing main logic
-(return 0 2> /dev/null) && return
-
 #######################################
 # Main routine: Parse subcommand and arguments, normalize PATH,
 # and dispatch to the appropriate functionality.

local/bin/x-path-append

@@ -1,17 +1,44 @@
 #!/usr/bin/env bash
 #
-# Thin wrapper — delegates to x-path append.
+# Optimized script to append directories to PATH.
-# Can be sourced (PATH changes propagate) or executed.
+# For each given directory, it removes all duplicate occurrences from PATH
+# and then appends it if the directory exists.
 #
 # Usage: x-path-append <directory1> [<directory2> ...]
 #
+# Enable verbose output by setting the environment variable VERBOSE=1.
+#
 # Author: Ismo Vuorinen <https://github.com/ivuorinen> 2024
 # License: MIT
 
 VERBOSE="${VERBOSE:-0}"
 
-# shellcheck source=./x-path
+# Ensure that at least one directory is provided.
-. "$(dirname "${BASH_SOURCE[0]:-$0}")/x-path"
+[ "$#" -lt 1 ] && {
+  echo "Usage: $0 <directory> [<directory> ...]"
+  exit 1
+}
 
-normalize_path_var
+for dir in "$@"; do
-do_append "$@"
+  # Check if the specified directory exists.
+  if [ ! -d "$dir" ]; then
+    [ "$VERBOSE" -eq 1 ] && echo "(?) Directory '$dir' does not exist. Skipping."
+    continue
+  fi
+
+  # Remove all duplicate occurrences of the directory from PATH.
+  case ":$PATH:" in
+    *":$dir:"*)
+      PATH=":${PATH}:"
+      PATH="${PATH//:$dir:/:}"
+      PATH="${PATH#:}"
+      PATH="${PATH%:}"
+      [ "$VERBOSE" -eq 1 ] && echo "Removed previous occurrences of '$dir' from PATH."
+      ;;
+    *) ;;
+  esac
+
+  # Append the directory to PATH.
+  export PATH="${PATH:+$PATH:}$dir"
+  [ "$VERBOSE" -eq 1 ] && echo "Appended '$dir' to PATH."
+done

local/bin/x-path-prepend

@@ -1,17 +1,50 @@
 #!/usr/bin/env bash
 #
-# Thin wrapper — delegates to x-path prepend.
+# Optimized script to batch prepend directories to PATH.
-# Can be sourced (PATH changes propagate) or executed.
+# For each given directory, it removes all duplicate occurrences from PATH
+# and then prepends it. Directories that do not exist are skipped.
 #
 # Usage: x-path-prepend <directory1> [<directory2> ...]
 #
+# Enable verbose output by setting the environment variable VERBOSE=1.
+#
 # Author: Ismo Vuorinen <https://github.com/ivuorinen> 2024
 # License: MIT
 
 VERBOSE="${VERBOSE:-0}"
 
-# shellcheck source=./x-path
+# Ensure that at least one argument is provided.
-. "$(dirname "${BASH_SOURCE[0]:-$0}")/x-path"
+[ "$#" -lt 1 ] && {
+  echo "Usage: $0 <directory> [<directory> ...]"
+  exit 1
+}
 
-normalize_path_var
+# Save the arguments in an array.
-do_prepend "$@"
+dirs=("$@")
+
+# Process the directories in reverse order so that the first argument ends up leftmost in PATH.
+for ((idx = ${#dirs[@]} - 1; idx >= 0; idx--)); do
+  dir="${dirs[idx]}"
+
+  # Check if the specified directory exists.
+  if [ ! -d "$dir" ]; then
+    [ "$VERBOSE" -eq 1 ] && echo "(?) Directory '$dir' does not exist. Skipping."
+    continue
+  fi
+
+  # Remove all duplicate occurrences of the directory from PATH using built-in string operations.
+  case ":$PATH:" in
+    *":$dir:"*)
+      PATH=":${PATH}:"
+      PATH="${PATH//:$dir:/:}"
+      PATH="${PATH#:}"
+      PATH="${PATH%:}"
+      [ "$VERBOSE" -eq 1 ] && echo "Removed duplicate occurrences of '$dir' from PATH."
+      ;;
+    *) ;;
+  esac
+
+  # Prepend the directory to PATH.
+  export PATH="$dir${PATH:+":$PATH"}"
+  [ "$VERBOSE" -eq 1 ] && echo "Prepended '$dir' to PATH."
+done

local/bin/x-path-remove

@@ -1,17 +1,41 @@
 #!/usr/bin/env bash
 #
-# Thin wrapper — delegates to x-path remove.
+# Optimized script to remove directories from PATH.
-# Can be sourced (PATH changes propagate) or executed.
+# For each specified directory, all occurrences are removed from PATH.
 #
 # Usage: x-path-remove <directory1> [<directory2> ...]
 #
+# Enable verbose output by setting the environment variable VERBOSE=1.
+#
 # Author: Ismo Vuorinen <https://github.com/ivuorinen> 2024
 # License: MIT
 
 VERBOSE="${VERBOSE:-0}"
 
-# shellcheck source=./x-path
+# Ensure that at least one directory is provided.
-. "$(dirname "${BASH_SOURCE[0]:-$0}")/x-path"
+[ "$#" -lt 1 ] && {
+  echo "Usage: $0 <directory> [<directory> ...]"
+  exit 1
+}
 
-normalize_path_var
+for dir in "$@"; do
-do_remove "$@"
+  # Remove trailing slash if present, unless the directory is "/"
+  [ "$dir" != "/" ] && dir="${dir%/}"
+
+  # Check if the directory is present in PATH.
+  case ":$PATH:" in
+    *":$dir:"*)
+      # Remove all occurrences of the directory from PATH using parameter expansion.
+      PATH=":${PATH}:"
+      PATH="${PATH//:$dir:/:}"
+      PATH="${PATH#:}"
+      PATH="${PATH%:}"
+      [ "$VERBOSE" -eq 1 ] && echo "Removed '$dir' from PATH."
+      ;;
+    *)
+      [ "$VERBOSE" -eq 1 ] && echo "(?) '$dir' is not in PATH."
+      ;;
+  esac
+done
+
+export PATH

local/bin/x-record

@@ -35,7 +35,7 @@ msg()
 # Notify function
 notify()
 {
-  notify-send.sh --replace-file "$replace_id" "$@"
+  notify-call --replace-file "$replace_id" "$@"
 }
 
 # Stop recording function

local/bin/x-term-colors

@@ -1,9 +1,7 @@
 #!/usr/bin/env bash
 #
-# Display 24-bit terminal color test.
+#   This file echoes a bunch of 24-bit color codes
-#
+#   to the terminal to demonstrate its functionality.
-# Usage: x-term-colors
-#
 #   The foreground escape sequence is ^[38;2;<r>;<g>;<b>m
 #   The background escape sequence is ^[48;2;<r>;<g>;<b>m
 #   <r> <g> <b> range from 0 to 255 inclusive.

local/bin/x-validate-sha256sum.sh

@@ -0,0 +1,68 @@
+#!/usr/bin/env bash
+#
+# This script contains a helper for sha256 validating your downloads
+#
+# Source: https://gist.github.com/onnimonni/b49779ebc96216771a6be3de46449fa1
+# Author: Onni Hakala
+# License: MIT
+#
+# Updated by Ismo Vuorinen <https://github.com/ivuorinen> 2022
+##
+
+set -euo pipefail
+
+# Stop program and give error message
+# $1 - error message (string)
+error()
+{
+  echo "(!) ERROR: $1" >&2
+  exit 1
+}
+
+# Check for sha256sum command
+if ! command -v sha256sum &> /dev/null; then
+  error "sha256sum could not be found, please install it first"
+fi
+
+# Return sha256sum for file
+# $1 - filename (string)
+get_sha256sum()
+{
+  sha256sum "$1" | head -c 64
+}
+
+# Validate input arguments
+validate_inputs()
+{
+  if [ -z "${filename:-}" ]; then
+    error "You need to provide filename as the first parameter"
+  fi
+
+  if [ -z "${file_hash:-}" ]; then
+    error "You need to provide sha256sum as the second parameter"
+  fi
+}
+
+# Main validation logic
+validate_file()
+{
+  if [ ! -f "$filename" ]; then
+    error "File $filename doesn't exist"
+  elif [ "$(get_sha256sum "$filename")" = "$file_hash" ]; then
+    echo "(*) Success: $filename matches provided sha256sum"
+  else
+    error "$filename doesn't match provided sha256sum"
+  fi
+}
+
+# Main function
+main()
+{
+  filename=$1
+  file_hash=$2
+
+  validate_inputs
+  validate_file
+}
+
+main "$@"

local/bin/x-validate-sha256sum.sh.md

@@ -0,0 +1,14 @@
+# x-validate-sha256sum.sh
+
+This script contains a helper for sha256 validating your downloads
+
+## Usage
+
+```bash
+x-validate-sha256sum.sh file sha256sum
+```
+
+The script computes the SHA256 hash of `file` and compares it to the
+expected value. It exits non-zero if the sums differ.
+
+<!-- vim: set ft=markdown spell spelllang=en_us cc=80 : -->

local/bin/x-when-down

@@ -1,5 +1,4 @@
 #!/usr/bin/env bash
-set -euo pipefail
 #
 # Wait until a given host is down (determined by ping) then execute the
 # given command

local/bin/x-when-up

@@ -1,5 +1,4 @@
 #!/usr/bin/env bash
-set -euo pipefail
 #
 # Wait until a given host is online (determined by ping) then execute the
 # given command

scripts/create-nvim-keymaps.sh

@@ -1,5 +1,4 @@
 #!/usr/bin/env bash
-set -euo pipefail
 # @description Create file containing key mappings for Neovim
 # Usage: ./create-nvim-keymaps.sh
 #
@@ -16,7 +15,7 @@ main()
     printf "\`\`\`txt"
   } > "$DEST"
 
-  nvim -c "redir! >> \"$DEST\"" -c 'silent verbose map' -c 'redir END' -c 'q'
+  nvim -c "redir! >> $DEST" -c 'silent verbose map' -c 'redir END' -c 'q'
 
   printf "\n\`\`\`\n\n- Generated on %s\n" "$(date)" >> "$DEST"
 

scripts/install-cargo-packages.sh

@@ -1,9 +1,5 @@
 #!/usr/bin/env bash
-set -euo pipefail
 # @description Install cargo/rust packages.
-#
-# shellcheck source=shared.sh
-source "$DOTFILES/config/shared.sh"
 
 msgr run "Starting to install rust/cargo packages"
 

scripts/install-cheat-purebashbible.sh

@@ -1,5 +1,4 @@
 #!/usr/bin/env bash
-set -euo pipefail
 # @description  Update pure-bash-bible cheatsheets
 # shellcheck disable=SC2231,SC2034,SC2181,SC2068
 # shellcheck source=shared.sh
@@ -86,7 +85,7 @@ process_chapters()
     if [ '---' != "$(head -1 < "$cheat_file")" ]; then
       local metadata
       metadata="$PBB_SYNTAX\n$PBB_TAGS\n$PBB_SOURCE\n"
-      printf '%s\n%b%s\n%s' "---" "$metadata" "---" "$(cat "$cheat_file")" > "$cheat_file"
+      echo -e "---\n$metadata---\n$(cat "$cheat_file")" > "$cheat_file"
     fi
   done
 }

scripts/install-composer.sh

@@ -1,9 +1,8 @@
 #!/usr/bin/env bash
-set -euo pipefail
 # @description Install PHP Package Manager Composer
 #
 # shellcheck source="shared.sh"
-source "$DOTFILES/config/shared.sh"
+source "$HOME/.dotfiles/config/shared.sh"
 
 if ! command -v php &> /dev/null; then
   msg_err "PHP Not Available, cannot install composer"
@@ -23,7 +22,5 @@ fi
 php composer-setup.php --quiet
 RESULT=$?
 rm composer-setup.php
-if [ $RESULT -eq 0 ]; then
+mv composer.phar ~/.local/bin/composer
-  mv composer.phar ~/.local/bin/composer
-fi
 exit $RESULT

scripts/install-fonts.sh

@@ -1,5 +1,4 @@
 #!/usr/bin/env bash
-set -euo pipefail
 # @description Install NerdFonts
 #
 # shellcheck source="shared.sh"
@@ -22,7 +21,7 @@ clone_or_update_repo()
     git clone --quiet --filter=blob:none --sparse --depth=1 "$GIT_REPO" "$TMP_PATH"
   fi
 
-  cd "$TMP_PATH" || { msgr err "No such folder $TMP_PATH"; exit 1; }
+  cd "$TMP_PATH" || msgr err "No such folder $TMP_PATH"
 }
 
 # Function to add fonts to sparse-checkout

scripts/install-gh-extensions.sh

@@ -1,10 +1,12 @@
 #!/usr/bin/env bash
-set -euo pipefail
 # @description Install GitHub CLI extensions
 #
 # shellcheck source="shared.sh"
 source "${DOTFILES}/config/shared.sh"
 
+# Enable verbosity with VERBOSE=1
+VERBOSE="${VERBOSE:-0}"
+
 msgr run "Installing gh (GitHub Client) extensions"
 
 if ! command -v gh &> /dev/null; then

scripts/install-git-crypt.sh

@@ -1,5 +1,4 @@
 #!/usr/bin/env bash
-set -euo pipefail
 # @description Install git-crypt
 #
 # NOTE: Experimental, wip
@@ -7,17 +6,21 @@ set -euo pipefail
 # shellcheck source=shared.sh
 source "${DOTFILES}/config/shared.sh"
 
+# Enable verbosity with VERBOSE=1
+VERBOSE="${VERBOSE:-0}"
+
 msgr run "Installing git-crypt"
 
 if ! command -v git-crypt &> /dev/null; then
   REPO_URL="https://github.com/AGWA/git-crypt.git"
   CHECK_PATH="${XDG_BIN_HOME}/git-crypt"
-  BUILD_PATH="$(mktemp -d)"
+  BUILD_PATH="/tmp/git-crypt"
-  trap 'rm -rf "$BUILD_PATH"' EXIT
 
-  if [ ! -f "$CHECK_PATH" ]; then
+  rm -rf "$BUILD_PATH"
-    git clone --depth 1 "$REPO_URL" "$BUILD_PATH" || { msgr err "Failed to clone $REPO_URL"; exit 1; }
+
-    cd "$BUILD_PATH" || { msgr err "$BUILD_PATH not found"; exit 1; }
+  if [ ! -d "$CHECK_PATH" ]; then
+    git clone --depth 1 "$REPO_URL" "$BUILD_PATH" || true
+    cd "$BUILD_PATH" || msg_err "$BUILD_PATH not found"
     make && make install PREFIX="$HOME/.local"
   else
     msgr run_done "git-crypt ($CHECK_PATH) already installed"

scripts/install-go-packages.sh

@@ -1,10 +1,12 @@
 #!/usr/bin/env bash
-set -euo pipefail
 # @description Install Go packages
 #
 # shellcheck source=shared.sh
 source "$DOTFILES/config/shared.sh"
 
+# Enable verbosity with VERBOSE=1
+VERBOSE="${VERBOSE:-0}"
+
 msgr run "Installing go packages"
 
 ! x-have "go" && msgr err "go hasn't been installed yet." && exit 0

scripts/install-macos-defaults.sh

@@ -1,5 +1,4 @@
 #!/usr/bin/env bash
-set -uo pipefail
 # @description Sets macOS Defaults that I like
 #
 # This script contains large portions from following scripts:
@@ -8,7 +7,7 @@ set -uo pipefail
 [ "$(uname)" != "Darwin" ] && echo "Not a macOS system" && exit 0
 
 # shellcheck source=shared.sh
-source "$DOTFILES/config/shared.sh"
+source "$HOME/.dotfiles/config/shared.sh"
 
 msgr run "Starting to set macOS defaults, these require sudo privileges:"
 
@@ -24,12 +23,12 @@ while true; do
 done 2> /dev/null &
 
 # Skip when shell is fish
-if [[ $SHELL != "$(command -v fish)" ]]; then
+if [[ $SHELL != $(which fish) ]]; then
   msgr nested "Change user shell to zsh if it is available and not the current"
 
   # Change user shell to zsh if not that already.
   if hash zsh 2> /dev/null; then
-    [[ $SHELL != "$(command -v zsh)" ]] && chsh -s "$(command -v zsh)"
+    [[ $SHELL != $(which zsh) ]] && chsh -s "$(which zsh)"
   fi
 fi
 

scripts/install-npm-packages.sh

@@ -1,10 +1,12 @@
 #!/usr/bin/env bash
-set -euo pipefail
 # @description Install npm packages globally.
 #
 # shellcheck source=shared.sh
 source "$DOTFILES/config/shared.sh"
 
+# Enable verbosity with VERBOSE=1
+VERBOSE="${VERBOSE:-0}"
+
 msgr msg "Starting to install npm packages"
 
 if ! command -v npm &> /dev/null; then

scripts/install-ntfy.sh

@@ -1,10 +1,12 @@
 #!/usr/bin/env bash
-set -euo pipefail
 # @description Install ntfy
 #
 # shellcheck source=shared.sh
 source "$DOTFILES/config/shared.sh"
 
+# Enable verbosity with VERBOSE=1
+VERBOSE="${VERBOSE:-0}"
+
 # Check if ntfy is already installed
 if x-have "ntfy"; then
   msgr "done" "ntfy already installed"
@@ -21,31 +23,28 @@ case $(dfm check arch) in
     ;;
   *)
     msgr err "Unsupported OS"
-    exit 1
     ;;
 esac
 
 NTFY_VERSION="$(x-gh-get-latest-version binwiederhier/ntfy)"
 NTFY_URL="https://github.com/binwiederhier/ntfy"
-NTFY_TARBALL="ntfy_${NTFY_VERSION}_${NTFY_ARCH}.tar.gz"
+NTFY_DEST="/tmp/ntfy_${NTFY_VERSION}_${NTFY_ARCH}"
-NTFY_DIR="ntfy_${NTFY_VERSION}_${NTFY_ARCH}"
 
 # Download and extract ntfy
 install_ntfy()
 {
-  local tmpdir
+  curl -L "$NTFY_URL/releases/download/v${NTFY_VERSION}/${NTFY_DEST}.tar.gz" -o "${NTFY_DEST}.tar.gz"
-  tmpdir="$(mktemp -d)"
+  tar zxvf "${NTFY_DEST}.tar.gz"
-  trap 'rm -rf "$tmpdir"' EXIT
+  cp -a "${NTFY_DEST}/ntfy" ~/.local/bin/ntfy
-
-  curl -L "$NTFY_URL/releases/download/v${NTFY_VERSION}/${NTFY_TARBALL}" -o "$tmpdir/${NTFY_TARBALL}"
-  tar zxvf "$tmpdir/${NTFY_TARBALL}" -C "$tmpdir"
-  cp -a "$tmpdir/${NTFY_DIR}/ntfy" ~/.local/bin/ntfy
   mkdir -p ~/.config/ntfy
 
   # Copy config only if it does not exist
   if [ ! -f "$HOME/.config/ntfy/client.yml" ]; then
-    cp "$tmpdir/${NTFY_DIR}/client/client.yml" ~/.config/ntfy/client.yml
+    cp "${NTFY_DEST}/client/client.yml" ~/.config/ntfy/client.yml
   fi
+
+  # Clean up
+  rm -rf "${NTFY_DEST}" "${NTFY_DEST}.tar.gz"
 }
 
 main()

scripts/install-python-packages.sh

@@ -1,10 +1,12 @@
 #!/usr/bin/env bash
-set -euo pipefail
 # @description Install Python packages using uv.
 #
 # shellcheck source=shared.sh
 source "$DOTFILES/config/shared.sh"
 
+# Enable verbosity with VERBOSE=1
+VERBOSE="${VERBOSE:-0}"
+
 msgr run "Starting to install Python packages"
 
 # Ensure uv is available
@@ -17,7 +19,6 @@ fi
 # CLI tools — installed isolated with `uv tool install`
 tools=(
   ansible    # IT automation and configuration management
-  openapi-python-client  # Generate Python API clients from OpenAPI specs
 )
 
 # Library packages — installed into system Python with `uv pip install --system`

scripts/install-xcode-cli-tools.sh

@@ -1,9 +1,11 @@
 #!/usr/bin/env bash
-set -euo pipefail
 # @description Install XCode CLI Tools with osascript magic.
 # Ismo Vuorinen <https://github.com/ivuorinen> 2018
 #
 
+# Enable verbosity with VERBOSE=1
+VERBOSE="${VERBOSE:-0}"
+
 # Check if the script is running on macOS
 if [ "$(uname)" != "Darwin" ]; then
   msgr warn "Not a macOS system"
@@ -29,7 +31,7 @@ keep_alive_sudo()
   done 2> /dev/null &
 }
 
-XCODE_TOOLS_PATH="$(xcode-select -p)"
+XCODE_TOOLS_PATH=$(xcode-select -p)
 XCODE_SWIFT_PATH="$XCODE_TOOLS_PATH/usr/bin/swift"
 
 # Function to prompt for XCode CLI Tools installation

scripts/install-z.sh

@@ -1,5 +1,4 @@
 #!/usr/bin/env bash
-set -euo pipefail
 # @description Install z
 #
 # shellcheck source=shared.sh

scripts/shared.sh

@@ -4,8 +4,17 @@
 # Helper env variables. Use like this: VERBOSE=1 ./script.sh
 : "${VERBOSE:=0}"
 
-# Source the main shared config if not already loaded
+# Set variable that checks if the shared.sh script has been
-if [ -z "${SHARED_SCRIPTS_SOURCED:-}" ]; then
+# sourced only once If the script has been sourced more than once,
+# the script not be sourced again.
+[ -z "$SHARED_SCRIPTS_SOURCED" ] && {
+
   source "${DOTFILES}/config/shared.sh"
+  # Warn the user if the shared configuration hasn't been loaded yet
+  msgr warn "(!) shared.sh not sourced"
+
+  # Set variable that checks if the shared.sh script has been
+  # sourced only once.
+  # shellcheck disable=SC2034
   export SHARED_SCRIPTS_SOURCED=1
-fi
+}

tests/x-mkd.bats

@@ -0,0 +1,14 @@
+#!/usr/bin/env bats
+
+@test "x-mkd creates directory" {
+  dir="$BATS_TMPDIR/mkd-test"
+  run env VERBOSE=1 bash local/bin/x-mkd "$dir"
+  [ "$status" -eq 0 ]
+  [ -d "$dir" ]
+}
+
+@test "x-mkd with no args shows usage" {
+  run bash local/bin/x-mkd
+  [ "$status" -eq 1 ]
+  [[ "$output" == "Usage:"* ]]
+}

tools/requirements-pipx.txt

@@ -0,0 +1 @@
+openapi-python-client