karnel-termux 4.13.6 → 4.13.8

package/README.md

@@ -8,14 +8,14 @@
 
 <p align="center">
   <a href="https://github.com/israelmarques1024-dotcom/karnel-termux">
-    <img src="https://img.shields.io/badge/version-4.13.6-0078D4?style=for-the-badge" alt="Version">
+    <img src="https://img.shields.io/badge/version-4.13.8-0078D4?style=for-the-badge" alt="Version">
   </a>
   <a href="https://www.npmjs.com/package/karnel-termux">
     <img src="https://img.shields.io/npm/v/karnel-termux?style=for-the-badge&logo=npm&color=cb3837" alt="npm">
   </a>
   <a href="https://www.npmjs.com/package/karnel-termux">
-    <img src="https://img.shields.io/npm/dt/karnel-termux?style=for-the-badge&logo=npm&color=cb3837" alt="npm downloads">
-  </a>
+  <img src="https://img.shields.io/npm/dt/karnel-termux?style=for-the-badge&logo=npm&color=cb3837" alt="npm downloads">
+</a>
   <a href="https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/LICENSE">
     <img src="https://img.shields.io/badge/license-MIT-0078D4?style=for-the-badge" alt="License">
   </a>
@@ -33,11 +33,11 @@
 
 Created by **Israel Marques**.
 
-- **39 AI agents** for coding — Claude, Gemini, OpenCode, Qoder, Ollama, Goose, Factory Droid, Cline, Puter, OmniRoute and more
+- **41 AI agents** for coding — Claude, Gemini, OpenCode, KeelCode, Qoder, Ollama, Goose, Factory Droid, Cline, Puter, OmniRoute and more
 - **8 languages** — Node.js, Python, Go, Rust, C/C++, PHP, Perl, Bun
 - **5 databases** — PostgreSQL, MariaDB, SQLite, MongoDB, Redis
 - **22 dev tools** — gh, curl, fzf, bat, lsd, jq, tmux, openssh, snyk and more
-- **11 utility scripts** — fconv, notes, treex, qrcode, zork and more
+- **12 utility tools** — fconv, notes, treex, qrcode, SuperFile, zork and more
 - **2 network tools** — dark, dedsec-network
 - **4 deploy CLIs** — Vercel, Railway, Netlify, Supabase
 - **Responsible OSINT** — Robin v2.8 through Tor with a loopback-only web UI
@@ -114,7 +114,7 @@ karnel
 |--------|-------------|--------------|
 | `lang` | Node.js, Python, Go, Rust, C/C++, PHP, Perl, Bun | `karnel install lang` |
 | `db` | PostgreSQL, MariaDB, SQLite, MongoDB, Redis | `karnel install db` |
-| `ai` | 39 AI agents for coding | `karnel install ai` |
+| `ai` | 41 AI agents for coding, including KeelCode | `karnel install ai` |
 | `editor` | code-server (VS Code in browser), Neovim, NvChad | `karnel install editor` |
 | `dev` | gh, curl, fzf, bat, lsd, jq and more | `karnel install dev` |
 | `npm` | TypeScript, NestJS CLI, Prettier and more | `karnel install npm` |
@@ -124,7 +124,7 @@ karnel
 | `deploy` | Vercel, Railway, Netlify, Supabase | `karnel install deploy` |
 | `games` | Buzz, CTF God, Detective, Tamagotchi and more | `karnel install games` |
 | `network` | Dark Web OSINT, DedSec Network Toolkit | `karnel install network` |
-| `utils` | fconv, notes, treex, passman, applaunch, qrcode, zork and more | `karnel install utils` |
+| `utils` | fconv, notes, treex, SuperFile, passman, applaunch, qrcode, zork and more | `karnel install utils` |
 | `osint` | Robin v2.8, Tor, Streamlit, and LLM providers | `karnel install osint` |
 | `voice` | Speech-to-agent through Termux:API | `karnel install voice` |
 | `plugin` | Built-in plugin manager — reviewed registry and local plugins | `karnel plugin search` |
@@ -132,6 +132,20 @@ karnel
 
 ---
 
+### KeelCode and SuperFile
+
+```bash
+# Install the KeelCode coding agent
+karnel install ai --keelcode
+
+# Install the SuperFile terminal file manager
+karnel install utils --superfile
+```
+
+Both tools support `update`, `reinstall`, and `uninstall` with the same module and flag.
+
+---
+
 ## Plugin System
 
 Discover and install reviewed plugins from the official registry:

package/install.sh

@@ -13,6 +13,7 @@ readonly P_NC='\e[0m'
 
 REPO="https://github.com/israelmarques1024-dotcom/karnel-termux"
 BRANCH="main"
+RELEASE_REF=""
 KARNEL_DATA="${XDG_DATA_HOME:-$HOME/.local/share}/karnel-data"
 KARNEL_REPO="${XDG_DATA_HOME:-$HOME/.local/share}/karnel"
 KARNEL_CACHE="${XDG_CACHE_HOME:-$HOME/.cache}/karnel"
@@ -198,14 +199,26 @@ clone_repo() {
 	fi
 
 	if [[ $is_dev_install -eq 1 ]]; then
+		if [[ -n "$RELEASE_REF" ]]; then
+			log_fail "A release ref cannot be installed from a development checkout"
+			return 1
+		fi
 		KARNEL_REPO="$script_dir"
 		log_info "Developer installation detected"
 		log_ok "Using local repository"
 	elif [[ -d "$KARNEL_REPO/.git" ]]; then
 		progress_bar 3 10
-		if ! git -C "$KARNEL_REPO" pull origin "$BRANCH" &>/dev/null; then
-			log_fail "Failed to update existing repository"
-			return 1
+		if [[ -n "$RELEASE_REF" ]]; then
+			if ! git -C "$KARNEL_REPO" fetch --depth=1 origin "refs/tags/$BRANCH" &>/dev/null ||
+				! git -C "$KARNEL_REPO" checkout --detach FETCH_HEAD &>/dev/null; then
+				log_fail "Failed to update existing repository"
+				return 1
+			fi
+		else
+			if ! git -C "$KARNEL_REPO" pull origin "$BRANCH" &>/dev/null; then
+				log_fail "Failed to update existing repository"
+				return 1
+			fi
 		fi
 		progress_bar 10 10
 		echo
@@ -303,6 +316,18 @@ show_final_message() {
 }
 
 main() {
+	if [[ $# -eq 2 && "$1" == "--ref" ]]; then
+		if [[ ! "$2" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+			echo -e "\n  ${P_FAIL}✖${P_NC}  Invalid release ref: $2" >&2
+			return 1
+		fi
+		BRANCH="$2"
+		RELEASE_REF="$2"
+	elif [[ $# -ne 0 ]]; then
+		echo -e "\n  ${P_FAIL}✖${P_NC}  Usage: install.sh [--ref vX.Y.Z]" >&2
+		return 1
+	fi
+
   if [[ -z "${PREFIX:-}" ]]; then
     echo -e "\n  ${P_FAIL}✖${P_NC}  PREFIX is not set. Are you running in Termux?"
     echo -e "  ${P_DIM}This installer requires Termux environment.${P_NC}"
@@ -319,4 +344,6 @@ main() {
   show_final_message
 }
 
-main
+if [[ "${BASH_SOURCE[0]}" == "$0" ]]; then
+	main "$@"
+fi

package/karnel/cli/commands/install.sh

@@ -179,6 +179,7 @@ _install_specific_tools() {
   local module="$1"
   shift
   local -a tools=("$@")
+  local failed_count=0
 
   case "$module" in
   ai)
@@ -232,7 +233,7 @@ _install_specific_tools() {
               ((failed_count++))
             fi
             ;;
-          1)
+          *)
             ((failed_count++))
             ;;
            2)
@@ -288,6 +289,7 @@ _install_specific_tools() {
         ;;
       *)
         log_warn "Unknown database: --$tool"
+        ((failed_count++))
         ;;
       esac
     done
@@ -402,6 +404,7 @@ _install_specific_tools() {
         ;;
         *)
           log_warn "Unknown tool: --$tool"
+          ((failed_count++))
           ;;
       esac
     done
@@ -452,6 +455,7 @@ _install_specific_tools() {
         ;;
       *)
         log_warn "Unknown game: --$tool"
+        ((failed_count++))
         ;;
       esac
     done
@@ -522,6 +526,7 @@ _install_specific_tools() {
         ;;
       *)
         log_warn "Unknown node module: --$tool"
+        ((failed_count++))
         ;;
       esac
     done
@@ -580,6 +585,7 @@ _install_specific_tools() {
         ;;
       *)
         log_warn "Unknown language: --$tool"
+        ((failed_count++))
         ;;
       esac
     done
@@ -646,6 +652,7 @@ _install_specific_tools() {
         ;;
       *)
         log_warn "Unknown plugin: --$tool"
+        ((failed_count++))
         ;;
       esac
     done
@@ -684,6 +691,7 @@ _install_specific_tools() {
         ;;
       *)
         log_warn "Unknown editor component: --$tool"
+        ((failed_count++))
         ;;
       esac
     done
@@ -726,6 +734,7 @@ _install_specific_tools() {
         ;;
       *)
         log_warn "Unknown UI component: --$tool"
+        ((failed_count++))
         ;;
       esac
     done
@@ -756,6 +765,7 @@ _install_specific_tools() {
         ;;
       *)
         log_warn "Unknown automation tool: --$tool"
+        ((failed_count++))
         ;;
       esac
     done
@@ -798,6 +808,7 @@ _install_specific_tools() {
         ;;
       *)
         log_warn "Unknown deploy tool: --$tool"
+        ((failed_count++))
         ;;
       esac
     done
@@ -817,21 +828,21 @@ _install_specific_tools() {
   osint)
     import "@/tools/osint/robin/common"
     _robin_print_disclaimer
-    _batch_tool_action "osint" "install" "${tools[@]}"
+    _batch_tool_action "osint" "install" "${tools[@]}" || return 1
     ;;
   network)
-    _batch_tool_action "network" "install" "${tools[@]}"
+    _batch_tool_action "network" "install" "${tools[@]}" || return 1
     ;;
   utils)
-    _batch_tool_action "utils" "install" "${tools[@]}"
+    _batch_tool_action "utils" "install" "${tools[@]}" || return 1
     ;;
   security)
-    _batch_tool_action "security" "install" "${tools[@]}"
+    _batch_tool_action "security" "install" "${tools[@]}" || return 1
     ;;
   supabase)
     import "@/tools/deploy/supabase/install"
     install_supabase
-    case $? in 0) log_success "Supabase CLI installed";; 2) log_info "Supabase CLI already installed";; 1) log_error "Failed to install Supabase CLI";; esac
+    case $? in 0) log_success "Supabase CLI installed";; 2) log_info "Supabase CLI already installed";; *) log_error "Failed to install Supabase CLI"; return 1;; esac
     ;;
   *)
     log_warn "Unknown install target: $module"
@@ -839,4 +850,5 @@ _install_specific_tools() {
     return 1
   ;;
   esac
+  (( ${failed_count:-0} == 0 ))
 }

package/karnel/cli/commands/list.sh

@@ -209,6 +209,7 @@ _list_ai() {
   table_row "Copilot-Termux" "--copilot-termux" "copilot" "$(_check_cmd "copilot")"
   table_row "Supercode CLI" "--supercode-cli" "supercode" "$(_check_cmd "supercode")"
   table_row "Puter CLI" "--puter" "puter" "$(_check_cmd "puter")"
+  table_row "KeelCode" "--keelcode" "keelcode" "$(_check_cmd "keelcode")"
   table_end
 
   echo
@@ -452,6 +453,7 @@ _list_utils() {
   table_row "httptmux (API client)" "--httptmux" "httptmux" "$(_check_cmd "httptmux")"
   table_row "Zork (text adventure)" "--zork" "zork" "$(_check_cmd "zork")"
   table_row "QR Code Generator" "--qrcode" "qrcode" "$(_check_cmd "qrcode")"
+  table_row "SuperFile" "--superfile" "spf" "$(_check_cmd "spf")"
   table_end
 
   echo

package/karnel/cli/commands/reinstall.sh

@@ -178,6 +178,7 @@ _reinstall_specific_tools() {
   local module="$1"
   shift
   local -a tools=("$@")
+  local failed_count=0
 
   case "$module" in
   ai)
@@ -299,6 +300,10 @@ _reinstall_specific_tools() {
         reinstall_puter
         case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
         ;;
+      keelcode)
+        reinstall_keelcode
+        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
+        ;;
       qoder)
         reinstall_qoder
         case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
@@ -349,6 +354,7 @@ _reinstall_specific_tools() {
         ;;
       *)
         log_warn "Unknown AI tool: --$tool"
+        ((failed_count++))
         ;;
       esac
     done
@@ -391,6 +397,7 @@ _reinstall_specific_tools() {
         ;;
       *)
         log_warn "Unknown database: --$tool"
+        ((failed_count++))
         ;;
       esac
     done
@@ -501,6 +508,7 @@ _reinstall_specific_tools() {
         ;;
         *)
           log_warn "Unknown tool: --$tool"
+          ((failed_count++))
           ;;
       esac
     done
@@ -547,6 +555,7 @@ _reinstall_specific_tools() {
         ;;
       *)
         log_warn "Unknown game: --$tool"
+        ((failed_count++))
         ;;
       esac
     done
@@ -613,6 +622,7 @@ _reinstall_specific_tools() {
         ;;
       *)
         log_warn "Unknown node module: --$tool"
+        ((failed_count++))
         ;;
       esac
     done
@@ -667,6 +677,7 @@ _reinstall_specific_tools() {
         ;;
       *)
         log_warn "Unknown language: --$tool"
+        ((failed_count++))
         ;;
       esac
     done
@@ -729,6 +740,7 @@ _reinstall_specific_tools() {
         ;;
       *)
         log_warn "Unknown plugin: --$tool"
+        ((failed_count++))
         ;;
       esac
     done
@@ -763,6 +775,7 @@ _reinstall_specific_tools() {
         ;;
       *)
         log_warn "Unknown editor component: --$tool"
+        ((failed_count++))
         ;;
       esac
     done
@@ -801,6 +814,7 @@ _reinstall_specific_tools() {
         ;;
       *)
         log_warn "Unknown UI component: --$tool"
+        ((failed_count++))
         ;;
       esac
     done
@@ -827,6 +841,7 @@ _reinstall_specific_tools() {
         ;;
       *)
         log_warn "Unknown automation tool: --$tool"
+        ((failed_count++))
         ;;
       esac
     done
@@ -843,16 +858,16 @@ _reinstall_specific_tools() {
   osint)
     import "@/tools/osint/robin/common"
     _robin_print_disclaimer
-    _batch_tool_action "osint" "reinstall" "${tools[@]}"
+    _batch_tool_action "osint" "reinstall" "${tools[@]}" || return 1
     ;;
   network)
-    _batch_tool_action "network" "reinstall" "${tools[@]}"
+    _batch_tool_action "network" "reinstall" "${tools[@]}" || return 1
     ;;
   utils)
-    _batch_tool_action "utils" "reinstall" "${tools[@]}"
+    _batch_tool_action "utils" "reinstall" "${tools[@]}" || return 1
     ;;
   security|deploy)
-    _batch_tool_action "$module" "reinstall" "${tools[@]}"
+    _batch_tool_action "$module" "reinstall" "${tools[@]}" || return 1
     ;;
   *)
     log_warn "Unknown reinstall target: $module"
@@ -860,4 +875,5 @@ _reinstall_specific_tools() {
     return 1
     ;;
   esac
+  (( ${failed_count:-0} == 0 ))
 }

package/karnel/cli/commands/update.sh

@@ -220,7 +220,7 @@ _update_try_curl() {
 
   log_info "Trying the official curl installer..."
 
-  if ! curl --fail --silent --show-error --location \
+  if ! curl --fail --silent --show-error --location --proto '=https' --proto-redir '=https' \
     "https://api.github.com/repos/israelmarques1024-dotcom/karnel-termux/releases/latest" \
     -o "$meta"; then
     rm -f "$meta" "$installer" "$sumfile"
@@ -234,10 +234,10 @@ _update_try_curl() {
     return 1
   fi
 
-  if ! curl --fail --silent --show-error --location \
+  if ! curl --fail --silent --show-error --location --proto '=https' --proto-redir '=https' \
     "https://github.com/israelmarques1024-dotcom/karnel-termux/releases/download/$tag/karnel-termux-install.sh.sha256" \
     -o "$sumfile" ||
-    ! curl --fail --silent --show-error --location \
+    ! curl --fail --silent --show-error --location --proto '=https' --proto-redir '=https' \
     "https://github.com/israelmarques1024-dotcom/karnel-termux/releases/download/$tag/karnel-termux-install.sh" \
     -o "$installer"; then
     rm -f "$meta" "$installer" "$sumfile"
@@ -252,7 +252,7 @@ _update_try_curl() {
 
   rm -f "$meta" "$sumfile"
 
-  if bash "$installer"; then
+  if bash "$installer" --ref "$tag"; then
     rm -f "$installer"
     log_success "Karnel-Termux updated via curl (v$tag)"
     return 0
@@ -282,8 +282,13 @@ _update_latest_release_tag() {
 _verify_sha256() {
   local file="$1" sumfile="$2"
   local expected actual
-  expected=$(awk 'NR == 1 { print $1 }' "$sumfile")
-  [[ -n "$expected" ]] || return 1
+  local -a checksum_lines
+
+  mapfile -t checksum_lines <"$sumfile" || return 1
+  if [[ ${#checksum_lines[@]} -ne 1 ]] || [[ ! "${checksum_lines[0]}" =~ ^([0-9a-f]{64})[[:space:]]+\*?karnel-termux-install\.sh$ ]]; then
+    return 1
+  fi
+  expected="${BASH_REMATCH[1]}"
   if command -v sha256sum &>/dev/null; then
     actual=$(sha256sum "$file" | awk '{ print $1 }')
   elif command -v node &>/dev/null; then

package/karnel/modules/shell.sh

@@ -2,6 +2,7 @@
 
 import "@/utils/log"
 import "@/utils/colors"
+import "@/utils/uninstall"
 
 ZSH_PLUGINS_DIR="$HOME/.zsh-plugins"
 OH_MY_ZSH_DIR="$HOME/.oh-my-zsh"
@@ -226,8 +227,12 @@ uninstall_oh_my_zsh() {
 
 	log_info "Uninstalling Oh My Zsh..."
 
-	if rm -rf "$OH_MY_ZSH_DIR" &>>"$LOG_FILE"; then
+	local remove_rc=0
+	confirm_remove_paths "Oh My Zsh" "$OH_MY_ZSH_DIR" &>>"$LOG_FILE" || remove_rc=$?
+	if [[ "$remove_rc" -eq 0 ]]; then
 		log_success "Oh My Zsh uninstalled"
+	elif [[ "$remove_rc" -eq 2 ]]; then
+		log_info "Oh My Zsh configuration preserved"
 	else
 		log_error "Failed to uninstall Oh My Zsh"
 		return 1
@@ -248,7 +253,7 @@ uninstall_shell() {
 
 	local rc=0
 	_uninstall_shell_plugins_wrapper || rc=$?
-	loading "Removing Oh My Zsh" uninstall_oh_my_zsh
+	uninstall_oh_my_zsh || rc=1
 
 	echo
 	separator

package/karnel/tools/ai/all.sh

@@ -61,6 +61,7 @@ AI_TOOLS_REGISTRY=(
   "openspec:OpenSpec SDD Framework:openspec"
   "supercode-cli:Supercode CLI:supercode"
   "puter:Puter CLI:puter"
+  "keelcode:KeelCode:keelcode"
   "copilot-termux:Copilot-Termux:copilot"
   "qoder:Qoder:qodercli"
   "ampcode:AMP Code CLI:amp"

package/karnel/tools/ai/keelcode/README.md

@@ -0,0 +1,16 @@
+# KeelCode
+
+KeelCode is a hosted coding-agent CLI from KeelCode AI.
+
+- Official package: `@keelcode-ai/keelcode`
+- Command: `keelcode`
+- Homepage: https://keelcode.ai
+
+## Lifecycle
+
+```bash
+karnel install ai --keelcode
+karnel update ai --keelcode
+karnel reinstall ai --keelcode
+karnel uninstall ai --keelcode
+```

package/karnel/tools/ai/keelcode/install.sh

@@ -0,0 +1,71 @@
+#!/usr/bin/env bash
+
+import "@/utils/log"
+import "@/utils/version"
+
+KEELCODE_PACKAGE="@keelcode-ai/keelcode"
+
+install_keelcode() {
+  if command -v keelcode &>/dev/null; then
+    log_info "KeelCode is already installed"
+    return 2
+  fi
+
+  log_info "Installing KeelCode..."
+  local output rc
+  output="$(npm install -g "$KEELCODE_PACKAGE" 2>&1)"
+  rc=$?
+  printf '%s\n' "$output" | tail -3
+  if ((rc != 0)); then
+    log_error "Failed to install KeelCode"
+    return 1
+  fi
+  if ! command -v keelcode &>/dev/null; then
+    log_error "KeelCode binary was not found after npm installation"
+    return 1
+  fi
+  command -v termux-fix-shebang &>/dev/null && termux-fix-shebang "$(command -v keelcode)" &>/dev/null || true
+  log_success "KeelCode installed"
+}
+
+uninstall_keelcode() {
+  if ! command -v keelcode &>/dev/null; then
+    log_info "KeelCode is not installed"
+    return 2
+  fi
+
+  log_info "Uninstalling KeelCode..."
+  local output rc
+  output="$(npm uninstall -g "$KEELCODE_PACKAGE" 2>&1)"
+  rc=$?
+  printf '%s\n' "$output" | tail -3
+  if ((rc != 0)); then
+    log_error "Failed to uninstall KeelCode"
+    return 1
+  fi
+  log_success "KeelCode uninstalled"
+}
+
+update_keelcode() {
+  _check_update_needed "KeelCode" \
+    "$(_get_installed_npm_version "$KEELCODE_PACKAGE")" \
+    "$(_get_remote_npm_version "$KEELCODE_PACKAGE")" \
+    _do_update_keelcode
+}
+
+_do_update_keelcode() {
+  local output rc
+  output="$(npm update -g "$KEELCODE_PACKAGE" 2>&1)"
+  rc=$?
+  printf '%s\n' "$output" | tail -3
+  if ((rc != 0)); then
+    log_error "Failed to update KeelCode"
+    return 1
+  fi
+  command -v keelcode &>/dev/null && command -v termux-fix-shebang &>/dev/null && termux-fix-shebang "$(command -v keelcode)" &>/dev/null || true
+}
+
+reinstall_keelcode() {
+  uninstall_keelcode || [[ $? -eq 2 ]] || return 1
+  install_keelcode
+}

package/karnel/tools/editor/nvchad/install.sh

@@ -1,6 +1,7 @@
 #!/usr/bin/env bash
 
 import "@/utils/log"
+import "@/utils/uninstall"
 import "@/utils/version"
 
 LOG_FILE="$KARNEL_CACHE/install_editor.log"
@@ -67,9 +68,14 @@ install_nvchad() {
 
 _uninstall_nvchad_impl() {
   if [[ -d "$HOME/.config/nvim" ]]; then
-    rm -rf ~/.config/nvim &>>"$LOG_FILE"
-    rm -rf ~/.local/state/nvim &>>"$LOG_FILE"
-    rm -rf ~/.local/share/nvim &>>"$LOG_FILE"
+    local remove_rc=0
+    confirm_remove_paths "NvChad" "$HOME/.config/nvim" "$HOME/.local/state/nvim" "$HOME/.local/share/nvim" &>>"$LOG_FILE" || remove_rc=$?
+    if [[ "$remove_rc" -eq 2 ]]; then
+      log_info "NvChad configuration preserved"
+    elif [[ "$remove_rc" -ne 0 ]]; then
+      log_error "Failed to remove NvChad configuration"
+      return 1
+    fi
     rm -rf "$NVCHAD_DIR" &>>"$LOG_FILE"
     log_success "NvChad uninstalled"
   else

package/karnel/tools/plugins/install.sh

@@ -690,7 +690,7 @@ _plugin_registry_errors() {
         if (($registry.plugins | type) != "array") then "plugins must be an array" else empty end,
         if (($registry.plugins | type) == "array" and ($registry.plugins | all(.[]; valid_plugin) | not)) then "one or more plugin entries violate registry schema v1" else empty end,
         if (($registry.plugins | type) == "array" and ($registry.plugins | map(.name) | length) != ($registry.plugins | map(.name) | unique | length)) then "plugin names must be unique" else empty end,
-        if (($registry.plugins | type) == "array" and ($registry.plugins | map(.repo) | length) != ($registry.plugins | map(.repo) | unique | length)) then "plugin repositories must be unique" else empty end
+        if (($registry.plugins | type) == "array" and ($registry.plugins | map(.repo + ":" + (.path // ".")) | length) != ($registry.plugins | map(.repo + ":" + (.path // ".")) | unique | length)) then "plugin repository paths must be unique" else empty end
       ]
     end | .[]
   ' "$registry"
@@ -732,7 +732,7 @@ _plugin_fetch_registry() {
     return 1
   fi
 
-  if ! curl --fail --silent --show-error --location --connect-timeout 10 --max-time 30 --output "$destination" "$registry_url"; then
+  if ! curl --fail --silent --show-error --location --proto '=https' --proto-redir '=https' --connect-timeout 10 --max-time 30 --output "$destination" "$registry_url"; then
     log_error "Failed to fetch the plugin registry. Check your network connection."
     return 1
   fi
@@ -748,19 +748,24 @@ _plugin_fetch_registry() {
 _plugin_registry_entry_for() {
   local registry="$1"
   local selector="$2"
-  local filter result
+  local filter result count
 
   if _plugin_repo_is_valid "$selector"; then
-    filter='.plugins[] | select(.repo == $selector)'
+    filter='[.plugins[] | select(.repo == $selector)]'
   elif _plugin_name_is_valid "$selector"; then
-    filter='.plugins[] | select(.name == $selector)'
+    filter='[.plugins[] | select(.name == $selector)]'
   else
     return 1
   fi
 
   result="$(jq -c --arg selector "$selector" "$filter" "$registry")" || return 1
-  [[ -n "$result" ]] || return 1
-  printf '%s\n' "$result"
+  count="$(jq 'length' <<<"$result")" || return 1
+  (( count > 0 )) || return 1
+  if (( count > 1 )); then
+    log_error "Repository '$selector' provides multiple plugins; install one by its approved name."
+    return 2
+  fi
+  jq -c '.[0]' <<<"$result"
 }
 
 _plugin_registry_entry_matches_manifest() {
@@ -1270,25 +1275,35 @@ install_plugin() {
 
 uninstall_plugin() {
   local name="$1"
-  local plugin_dir
+  local plugin_dir status=0
 
   _plugin_validate_name "$name" || return 1
   _plugin_prepare_plugins_dir || return 1
-  _plugin_recover_interrupted_replacement "$name" || return 1
-  plugin_dir="$PLUGINS_DIR/$name"
+  _plugin_acquire_plugin_lock "$name" || return 1
 
-  if [[ ! -e "$plugin_dir" && ! -L "$plugin_dir" ]]; then
-    log_info "Plugin '$name' is not installed."
-    return 2
+  if ! _plugin_recover_interrupted_replacement "$name"; then
+    status=1
+  else
+    plugin_dir="$PLUGINS_DIR/$name"
+    if [[ ! -e "$plugin_dir" && ! -L "$plugin_dir" ]]; then
+      log_info "Plugin '$name' is not installed."
+      status=2
+    elif [[ -d "$plugin_dir" && ! -L "$plugin_dir" ]] && ! _plugin_validate_symlinks "$(_plugin_canonical_existing_path "$plugin_dir")"; then
+      status=1
+    else
+      log_info "Removing plugin '$name'..."
+      if _plugin_safe_remove_path "$plugin_dir"; then
+        log_success "Plugin '$name' removed."
+      else
+        status=1
+      fi
+    fi
   fi
 
-  if [[ -d "$plugin_dir" && ! -L "$plugin_dir" ]]; then
-    _plugin_validate_symlinks "$(_plugin_canonical_existing_path "$plugin_dir")" || return 1
+  if ! _plugin_release_plugin_lock && ((status == 0)); then
+    status=1
   fi
-
-  log_info "Removing plugin '$name'..."
-  _plugin_safe_remove_path "$plugin_dir" || return 1
-  log_success "Plugin '$name' removed."
+  return "$status"
 }
 
 _plugin_read_metadata_field() {

package/karnel/tools/shell/all.sh

@@ -1,6 +1,7 @@
 #!/usr/bin/env bash
 
 import "@/utils/log"
+import "@/utils/uninstall"
 
 LOG_FILE="$KARNEL_CACHE/install_shell.log"
 ZSH_PLUGINS_DIR="$HOME/.zsh-plugins"
@@ -38,7 +39,11 @@ _batch_shell() {
   for tool in "${SHELL_PLUGINS[@]}"; do
     func_name="${action}_${tool//-/_}"
     if declare -f "$func_name" &>/dev/null; then
-      loading "${action_past^}ing ${tool}" "$func_name"
+      if [[ "$action" == "uninstall" ]]; then
+        "$func_name"
+      else
+        loading "${action_past^}ing ${tool}" "$func_name"
+      fi
       case $? in 0) ((count++));; 1) ((failed++));; esac
     fi
     ((current++))

package/karnel/tools/shell/better-npm/install.sh

@@ -60,11 +60,17 @@ _uninstall_better_npm_impl() {
     return 0
   fi
 
-  rm -rf "$ZSH_PLUGINS_DIR/zsh-better-npm-completion"
+  local remove_rc=0
+  confirm_remove_paths "zsh-better-npm-completion" "$ZSH_PLUGINS_DIR/zsh-better-npm-completion" || remove_rc=$?
+  if [[ "$remove_rc" -eq 2 ]]; then
+    log_info "zsh-better-npm-completion configuration and data preserved"
+    return 0
+  fi
+  return "$remove_rc"
 }
 
 uninstall_better_npm() {
-  loading "Uninstalling zsh-better-npm-completion" _uninstall_better_npm_impl
+  _uninstall_better_npm_impl
 }
 
 _update_better_npm_impl() {

package/karnel/tools/shell/fzf-tab/install.sh

@@ -60,11 +60,17 @@ _uninstall_fzf_tab_impl() {
     return 0
   fi
 
-  rm -rf "$ZSH_PLUGINS_DIR/fzf-tab"
+  local remove_rc=0
+  confirm_remove_paths "fzf-tab" "$ZSH_PLUGINS_DIR/fzf-tab" || remove_rc=$?
+  if [[ "$remove_rc" -eq 2 ]]; then
+    log_info "fzf-tab configuration and data preserved"
+    return 0
+  fi
+  return "$remove_rc"
 }
 
 uninstall_fzf_tab() {
-  loading "Uninstalling fzf-tab" _uninstall_fzf_tab_impl
+  _uninstall_fzf_tab_impl
 }
 
 _update_fzf_tab_impl() {

package/karnel/tools/shell/history-substring/install.sh

@@ -60,11 +60,17 @@ _uninstall_history_substring_impl() {
     return 0
   fi
 
-  rm -rf "$ZSH_PLUGINS_DIR/zsh-history-substring-search"
+  local remove_rc=0
+  confirm_remove_paths "zsh-history-substring-search" "$ZSH_PLUGINS_DIR/zsh-history-substring-search" || remove_rc=$?
+  if [[ "$remove_rc" -eq 2 ]]; then
+    log_info "zsh-history-substring-search configuration and data preserved"
+    return 0
+  fi
+  return "$remove_rc"
 }
 
 uninstall_history_substring() {
-  loading "Uninstalling zsh-history-substring-search" _uninstall_history_substring_impl
+  _uninstall_history_substring_impl
 }
 
 _update_history_substring_impl() {

package/karnel/tools/shell/powerlevel10k/install.sh

@@ -60,11 +60,17 @@ _uninstall_powerlevel10k_impl() {
     return 0
   fi
 
-  rm -rf "$ZSH_PLUGINS_DIR/powerlevel10k"
+  local remove_rc=0
+  confirm_remove_paths "powerlevel10k" "$ZSH_PLUGINS_DIR/powerlevel10k" || remove_rc=$?
+  if [[ "$remove_rc" -eq 2 ]]; then
+    log_info "powerlevel10k configuration and data preserved"
+    return 0
+  fi
+  return "$remove_rc"
 }
 
 uninstall_powerlevel10k() {
-  loading "Uninstalling powerlevel10k" _uninstall_powerlevel10k_impl
+  _uninstall_powerlevel10k_impl
 }
 
 _update_powerlevel10k_impl() {

package/karnel/tools/shell/you-should-use/install.sh

@@ -60,11 +60,17 @@ _uninstall_you_should_use_impl() {
     return 0
   fi
 
-  rm -rf "$ZSH_PLUGINS_DIR/zsh-you-should-use"
+  local remove_rc=0
+  confirm_remove_paths "zsh-you-should-use" "$ZSH_PLUGINS_DIR/zsh-you-should-use" || remove_rc=$?
+  if [[ "$remove_rc" -eq 2 ]]; then
+    log_info "zsh-you-should-use configuration and data preserved"
+    return 0
+  fi
+  return "$remove_rc"
 }
 
 uninstall_you_should_use() {
-  loading "Uninstalling zsh-you-should-use" _uninstall_you_should_use_impl
+  _uninstall_you_should_use_impl
 }
 
 _update_you_should_use_impl() {

package/karnel/tools/shell/zsh-autopair/install.sh

@@ -60,11 +60,17 @@ _uninstall_zsh_autopair_impl() {
     return 0
   fi
 
-  rm -rf "$ZSH_PLUGINS_DIR/zsh-autopair"
+  local remove_rc=0
+  confirm_remove_paths "zsh-autopair" "$ZSH_PLUGINS_DIR/zsh-autopair" || remove_rc=$?
+  if [[ "$remove_rc" -eq 2 ]]; then
+    log_info "zsh-autopair configuration and data preserved"
+    return 0
+  fi
+  return "$remove_rc"
 }
 
 uninstall_zsh_autopair() {
-  loading "Uninstalling zsh-autopair" _uninstall_zsh_autopair_impl
+  _uninstall_zsh_autopair_impl
 }
 
 _update_zsh_autopair_impl() {

package/karnel/tools/shell/zsh-autosuggestions/install.sh

@@ -60,11 +60,17 @@ _uninstall_zsh_autosuggestions_impl() {
     return 0
   fi
 
-  rm -rf "$ZSH_PLUGINS_DIR/zsh-autosuggestions"
+  local remove_rc=0
+  confirm_remove_paths "zsh-autosuggestions" "$ZSH_PLUGINS_DIR/zsh-autosuggestions" || remove_rc=$?
+  if [[ "$remove_rc" -eq 2 ]]; then
+    log_info "zsh-autosuggestions configuration and data preserved"
+    return 0
+  fi
+  return "$remove_rc"
 }
 
 uninstall_zsh_autosuggestions() {
-  loading "Uninstalling zsh-autosuggestions" _uninstall_zsh_autosuggestions_impl
+  _uninstall_zsh_autosuggestions_impl
 }
 
 _update_zsh_autosuggestions_impl() {

package/karnel/tools/shell/zsh-completions/install.sh

@@ -60,11 +60,17 @@ _uninstall_zsh_completions_impl() {
     return 0
   fi
 
-  rm -rf "$ZSH_PLUGINS_DIR/zsh-completions"
+  local remove_rc=0
+  confirm_remove_paths "zsh-completions" "$ZSH_PLUGINS_DIR/zsh-completions" || remove_rc=$?
+  if [[ "$remove_rc" -eq 2 ]]; then
+    log_info "zsh-completions configuration and data preserved"
+    return 0
+  fi
+  return "$remove_rc"
 }
 
 uninstall_zsh_completions() {
-  loading "Uninstalling zsh-completions" _uninstall_zsh_completions_impl
+  _uninstall_zsh_completions_impl
 }
 
 _update_zsh_completions_impl() {

package/karnel/tools/shell/zsh-defer/install.sh

@@ -60,11 +60,17 @@ _uninstall_zsh_defer_impl() {
     return 2
   fi
 
-  rm -rf "$ZSH_PLUGINS_DIR/zsh-defer"
+  local remove_rc=0
+  confirm_remove_paths "zsh-defer" "$ZSH_PLUGINS_DIR/zsh-defer" || remove_rc=$?
+  if [[ "$remove_rc" -eq 2 ]]; then
+    log_info "zsh-defer configuration and data preserved"
+    return 0
+  fi
+  return "$remove_rc"
 }
 
 uninstall_zsh_defer() {
-  loading "Uninstalling zsh-defer" _uninstall_zsh_defer_impl
+  _uninstall_zsh_defer_impl
 }
 
 _update_zsh_defer_impl() {

package/karnel/tools/shell/zsh-syntax-highlighting/install.sh

@@ -47,11 +47,17 @@ _uninstall_zsh_syntax_highlighting_impl() {
     return 0
   fi
 
-  rm -rf "$ZSH_PLUGINS_DIR/zsh-syntax-highlighting"
+  local remove_rc=0
+  confirm_remove_paths "zsh-syntax-highlighting" "$ZSH_PLUGINS_DIR/zsh-syntax-highlighting" || remove_rc=$?
+  if [[ "$remove_rc" -eq 2 ]]; then
+    log_info "zsh-syntax-highlighting configuration and data preserved"
+    return 0
+  fi
+  return "$remove_rc"
 }
 
 uninstall_zsh_syntax_highlighting() {
-  loading "Uninstalling zsh-syntax-highlighting" _uninstall_zsh_syntax_highlighting_impl
+  _uninstall_zsh_syntax_highlighting_impl
 }
 
 _update_zsh_syntax_highlighting_impl() {

package/karnel/tools/utils/all.sh

@@ -16,6 +16,7 @@ TOOLS_PACKAGES=(
   "httptmux"
   "zork"
   "qrcode"
+  "superfile"
 )
 
 TOOLS_DISPLAY=(
@@ -30,6 +31,7 @@ TOOLS_DISPLAY=(
   "httptmux (interactive API client)"
   "Zork (text adventure games I, II, III)"
   "QR Code (link-to-QR generator)"
+  "SuperFile (terminal file manager)"
 )
 
 for _tool in "${TOOLS_PACKAGES[@]}"; do

package/karnel/tools/utils/superfile/README.md

@@ -0,0 +1,19 @@
+# SuperFile
+
+SuperFile is a terminal file manager from yorukot.
+
+- Official source: https://github.com/yorukot/superfile
+- Pinned release: `v1.5.0`
+- Pinned commit: `fe41cef5e9ee5b16e79981540c49f932a3d4d249`
+- Command: `spf`
+
+Karnel builds the pinned release from source with Go. The checkout is kept in `$KARNEL_DATA/superfile` and each build stages a replacement before installing the binary.
+
+## Lifecycle
+
+```bash
+karnel install utils --superfile
+karnel update utils --superfile
+karnel reinstall utils --superfile
+karnel uninstall utils --superfile
+```

package/karnel/tools/utils/superfile/install.sh

@@ -0,0 +1,89 @@
+#!/usr/bin/env bash
+
+import "@/utils/log"
+
+SUPERFILE_VERSION="v1.5.0"
+SUPERFILE_COMMIT="fe41cef5e9ee5b16e79981540c49f932a3d4d249"
+SUPERFILE_REPOSITORY="https://github.com/yorukot/superfile.git"
+SUPERFILE_DATA_DIR="$KARNEL_DATA/superfile"
+SUPERFILE_BIN="$PREFIX/bin/spf"
+
+_superfile_dependencies() {
+  local package binary
+  while IFS=: read -r package binary; do
+    if ! command -v "$binary" &>/dev/null; then
+      if ! pkg install "$package" -y &>>"$KARNEL_CACHE/install_utils.log"; then
+        log_error "Failed to install $package"
+        return 1
+      fi
+    fi
+  done <<'EOF'
+git:git
+golang:go
+EOF
+}
+
+_build_superfile() {
+  local staging_dir old_dir
+  mkdir -p "$KARNEL_DATA" "$PREFIX/bin" "${KARNEL_CACHE}"
+  staging_dir="$(mktemp -d "$KARNEL_DATA/.superfile.XXXXXX")" || return 1
+
+  if ! git clone --depth 1 --branch "$SUPERFILE_VERSION" "$SUPERFILE_REPOSITORY" "$staging_dir/source" &>>"$KARNEL_CACHE/install_utils.log" ||
+    [[ "$(git -C "$staging_dir/source" rev-parse HEAD)" != "$SUPERFILE_COMMIT" ]] ||
+    ! go build -C "$staging_dir/source" -trimpath -ldflags='-s -w' -o "$staging_dir/spf" . &>>"$KARNEL_CACHE/install_utils.log" ||
+    [[ ! -x "$staging_dir/spf" ]]; then
+    rm -rf "$staging_dir"
+    log_error "Failed to build SuperFile $SUPERFILE_VERSION"
+    return 1
+  fi
+
+  old_dir="$KARNEL_DATA/.superfile.previous.$$"
+  if [[ -d "$SUPERFILE_DATA_DIR" ]]; then
+    mv "$SUPERFILE_DATA_DIR" "$old_dir" || { rm -rf "$staging_dir"; return 1; }
+  fi
+  if ! mv "$staging_dir/source" "$SUPERFILE_DATA_DIR" || ! mv -f "$staging_dir/spf" "$SUPERFILE_BIN"; then
+    rm -rf "$staging_dir" "$SUPERFILE_DATA_DIR"
+    [[ -d "$old_dir" ]] && mv "$old_dir" "$SUPERFILE_DATA_DIR"
+    log_error "Failed to replace SuperFile"
+    return 1
+  fi
+  rm -rf "$staging_dir" "$old_dir"
+}
+
+install_superfile() {
+  if command -v spf &>/dev/null; then
+    log_info "SuperFile is already installed"
+    return 2
+  fi
+
+  log_info "Installing SuperFile $SUPERFILE_VERSION..."
+  _superfile_dependencies || return 1
+  _build_superfile || return 1
+  log_success "SuperFile installed"
+}
+
+uninstall_superfile() {
+  if [[ ! -e "$SUPERFILE_BIN" && ! -d "$SUPERFILE_DATA_DIR" ]]; then
+    log_info "SuperFile is not installed"
+    return 2
+  fi
+
+  log_info "Uninstalling SuperFile..."
+  if ! rm -f "$SUPERFILE_BIN" || ! rm -rf "$SUPERFILE_DATA_DIR"; then
+    log_error "Failed to uninstall SuperFile"
+    return 1
+  fi
+  log_success "SuperFile uninstalled"
+}
+
+update_superfile() {
+  log_info "Updating SuperFile to $SUPERFILE_VERSION..."
+  _superfile_dependencies || return 1
+  _build_superfile || return 1
+  log_success "SuperFile updated"
+}
+
+reinstall_superfile() {
+  uninstall_superfile || [[ $? -eq 2 ]] || return 1
+  install_superfile
+}

package/karnel/utils/uninstall.sh

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+
+confirm_remove_paths() {
+  local label="$1"
+  shift
+  local answer path
+  local -a existing=()
+
+  for path in "$@"; do
+    [[ -e "$path" || -L "$path" ]] && existing+=("$path")
+  done
+  (( ${#existing[@]} > 0 )) || return 0
+
+  read_confirm_default "Remove $label configuration and data?" "n" answer || return 2
+  [[ "$answer" == "y" ]] || return 2
+
+  rm -rf -- "${existing[@]}"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "karnel-termux",
-  "version": "4.13.6",
+  "version": "4.13.8",
   "description": "Modular Dev Environment for Termux — install languages, databases, AI agents, editors, and more with one command",
   "bin": {
     "karnel": "karnel/bin/karnel"