karnel-termux 4.13.10 → 4.14.0

package/README.md

@@ -8,7 +8,7 @@
 
 <p align="center">
   <a href="https://github.com/israelmarques1024-dotcom/karnel-termux">
-    <img src="https://img.shields.io/badge/version-4.13.10-0078D4?style=for-the-badge" alt="Version">
+    <img src="https://img.shields.io/badge/version-4.14.0-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">
@@ -33,7 +33,7 @@
 
 Created by **Israel Marques**.
 
-- **41 AI agents** for coding — Claude, Gemini, OpenCode, KeelCode, Qoder, Ollama, Goose, Factory Droid, Cline, Puter, OmniRoute and more
+- **43 AI tools** — Claude, Gemini, OpenCode, Cactus, Hugging Face, Ollama, KeelCode, Goose, Factory Droid 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
@@ -115,7 +115,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` | 41 AI agents for coding, including KeelCode | `karnel install ai` |
+| `ai` | 43 AI tools, agents, and local inference clients | `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` |
@@ -166,6 +166,10 @@ user's permissions. They are not sandboxed. Registry plugins have reviewed
 metadata and are staged, validated, and atomically activated, but you should
 still review code you do not trust.
 
+Each Karnel release pins and verifies one reviewed registry snapshot. New
+registry entries become available after updating Karnel to a release that
+includes that snapshot.
+
 Installing an arbitrary GitHub repository requires both `--unsafe` and an
 interactive confirmation:
 
@@ -255,7 +259,7 @@ See the bundled reference with `karnel show osint --robin`.
 
 ---
 
-## AI Agents (41)
+## AI Tools (43)
 
 ```bash
 karnel install ai                             # Install all
@@ -274,6 +278,8 @@ karnel install ai --opencode --ollama         # Install specific agents
 | **OpenClaude** | `--openclaude` | Open source Claude Code alternative |
 | **OpenClaw** | `--openclaw` | Personal AI assistant |
 | **Ollama** | `--ollama` | Run open source LLMs locally |
+| **Cactus** | `--cactus` | On-device ARM64 inference through an isolated Ubuntu runtime |
+| **Hugging Face** | `--hugging-face` | Official Hugging Face Hub CLI (`hf`) |
 | **Codex CLI** | `--codex` | OpenAI coding agent |
 | **OpenCode** | `--opencode` | Open source terminal agent |
 | **MiMoCode** | `--mimocode` | Fast open source AI agent |
@@ -304,7 +310,7 @@ karnel install ai --opencode --ollama         # Install specific agents
 | **Cursor CLI** | `--cursor-cli` | Official Cursor AI agent adapted for Termux (glibc) |
 | **Oh-My-Pi** | `--oh-my-pi` | Enhanced Pi agent with native Rust addons |
 | **Goose CLI** | `--goose` | AI agent framework by Block (native Termux musl) |
-| **Factory Droid** | `--droid` | Enterprise AI agent (via proot-distro Ubuntu) |
+| **Factory Droid** | `--droid` | Enterprise AI agent (Ubuntu proot-distro with pinned npm package) |
 | **Supercode CLI** | `--supercode-cli` | Supercode CLI — official npm package |
 | **Puter CLI** | `--puter` | Puter CLI for sites and workers |
 | **KeelCode** | `--keelcode` | Hosted coding-agent CLI |
@@ -541,7 +547,7 @@ karnel/
 │   │   └── karnel.sh    # Main CLI (with TUI)
 │   ├── modules/       # Module orchestrators
 │   ├── tools/         # Tool installers
-│   │   ├── ai/        # 41 AI agents
+│   │   ├── ai/        # 43 AI tools
 │   │   ├── lang/      # 8 languages
 │   │   ├── db/        # 5 databases
 │   │   ├── dev/       # 22 dev tools

package/docs/ARCHITECTURE.md

@@ -27,7 +27,7 @@ karnel-termux/
 │   │       ├── dev.sh          # Dev tools installer
 │   │       └── ...
 │   ├── tools/                  # Individual tool installers
-│   │   ├── ai/                 # 41 AI agents
+│   │   ├── ai/                 # 43 AI tools
 │   │   ├── lang/               # 8 languages
 │   │   ├── db/                 # 5 databases
 │   │   ├── dev/                # 22 dev tools

package/docs/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Documentation Changelog
 
+## 4.14.0 - 2026-08-14
+
+- Added tested Cactus 2.0.1 support on ARM64 through Ubuntu Proot with an
+  isolated compatible Python runtime.
+- Added the official Hugging Face `hf` CLI in an isolated native Termux
+  environment, using HTTP transport when the optional Xet Android wheel is
+  unavailable.
+- Made the AI registry authoritative for TUI selection, route discovery, and
+  lifecycle dispatch, with contracts covering all 43 registered tools.
+- Fixed AI reinstall and uninstall error propagation, unknown status handling,
+  binary alias summaries, ownership checks, and stale tool counts.
+
+## 4.13.11 - 2026-08-10
+
+- Hardened installers to preserve user-managed commands and data, with atomic
+  staging for downloaded payloads and native binaries.
+- Added verified plugin registry snapshots, npm release pinning, and regression
+  contracts for installers, ownership, and package postinstall behavior.
+- Added Android-compatible Railway installation through Ubuntu Proot and
+  verified Railway and Netlify CLI installation on Termux.
+- Synchronized CLI, GitHub README, npm metadata, and site documentation.
+- Corrected the portable npm postinstall fixture used by release validation.
+
 ## 4.13.10 - 2026-08-06
 
 - Included root documentation in the npm package and synchronized help, TUI, and release assets.

package/docs/README.md

@@ -14,7 +14,7 @@
 ## What is Karnel?
 
 Karnel Termux transforms your Android device into a complete development workstation.
-With a single CLI (`karnel`), you can install and manage 41 AI agents, 8 languages,
+With a single CLI (`karnel`), you can install and manage 43 AI tools, 8 languages,
 5 databases, 22 dev tools, 12 utility tools, 2 network tools, 6 games, responsible OSINT, and more.
 
 ## Sections

package/docs/cli/README.md

@@ -22,7 +22,7 @@ karnel install <module> --tool1 --tool2  # Install specific tools only
 |-----------|-------------|
 | `lang`    | Node.js, Python, Go, Rust, C/C++, PHP, Perl, Bun |
 | `db`      | PostgreSQL, MariaDB, SQLite, MongoDB, Redis |
-| `ai`      | 41 AI agents (OpenCode, Claude Code, KeelCode, Codebuff, Freebuff, Qoder, AMP Code, Cursor CLI, Oh-My-Pi, Goose, Factory Droid, Puter, Ollama, etc.) |
+| `ai`      | 43 AI tools (OpenCode, Cactus, Hugging Face, Claude Code, KeelCode, Goose, Factory Droid, Ollama, etc.) |
 | `editor`  | code-server (VS Code in browser), Neovim, NvChad |
 | `dev`     | gh, curl, fzf, bat, lsd, jq, tmux, openssh, snyk (22 tools) |
 | `npm`     | TypeScript, NestJS CLI, Prettier, Vercel CLI, etc. |
@@ -36,13 +36,13 @@ karnel install <module> --tool1 --tool2  # Install specific tools only
 | `osint`   | Robin v2.8 — dark web OSINT via Tor + LLM |
 | `voice`   | Speech-to-agent via Termux:API |
 | `security`| Nmap, Hydra, SQLMap, Metasploit, and 26 other tools |
-| `plugin`  | Install plugins from the official registry |
+| `plugin`  | Built-in manager for plugins from the official registry |
 
 ### Per-module tool flags
 
 | Module    | Flags |
 |-----------|-------|
-| `ai`      | `--qwen-code`, `--gemini-cli`, `--claude-code`, `--mistral-vibe`, `--openclaude`, `--openclaw`, `--ollama`, `--codex`, `--opencode`, `--mimocode`, `--engram`, `--codegraph`, `--pi`, `--antigravity-cli`, `--minimax-cli`, `--gentle-ai`, `--gga`, `--hermes-agent`, `--kimi-code`, `--command-code`, `--codebuff`, `--freebuff`, `--kilocode-cli`, `--kiro`, `--crush`, `--cline`, `--odysseus`, `--kimchi-code`, `--omni-route`, `--ctx7`, `--openspec`, `--supercode-cli`, `--puter`, `--keelcode`, `--copilot-termux`, `--qoder`, `--ampcode`, `--cursor-cli`, `--oh-my-pi`, `--goose`, `--droid` |
+| `ai`      | `--qwen-code`, `--gemini-cli`, `--claude-code`, `--mistral-vibe`, `--openclaude`, `--openclaw`, `--ollama`, `--codex`, `--opencode`, `--mimocode`, `--engram`, `--codegraph`, `--pi`, `--antigravity-cli`, `--minimax-cli`, `--gentle-ai`, `--gga`, `--hermes-agent`, `--kimi-code`, `--command-code`, `--codebuff`, `--freebuff`, `--kilocode-cli`, `--kiro`, `--crush`, `--cline`, `--odysseus`, `--kimchi-code`, `--omni-route`, `--ctx7`, `--openspec`, `--supercode-cli`, `--puter`, `--keelcode`, `--copilot-termux`, `--qoder`, `--ampcode`, `--cursor-cli`, `--oh-my-pi`, `--goose`, `--droid`, `--cactus`, `--hugging-face` |
 | `db`      | `--postgresql`, `--mariadb`, `--sqlite`, `--mongodb`, `--redis` |
 | `dev`     | `--gh`, `--wget`, `--curl`, `--lsd`, `--bat`, `--proot`, `--ncurses`, `--tmate`, `--openssh`, `--tmux`, `--cloudflared`, `--translate`, `--html2text`, `--jq`, `--bc`, `--tree`, `--fzf`, `--imagemagick`, `--shfmt`, `--make`, `--udocker`, `--snyk` |
 | `lang`    | `--bun`, `--nodejs`, `--python`, `--perl`, `--php`, `--rust`, `--clang`, `--golang` |
@@ -76,8 +76,8 @@ karnel uninstall <module> --tool1 --tool2
 
 Same modules and flags as `install`. Removes installed packages and binaries.
 User configuration is preserved by default; Karnel asks for confirmation before
-removing configuration paths it manages. `ui --extra-keys` is a legacy
-exception: it replaces and removes `~/.termux/termux.properties` directly.
+removing configuration paths it manages. `ui --extra-keys` adds and removes
+only its marked block in `~/.termux/termux.properties`.
 
 ```bash
 karnel uninstall ai --opencode --ollama
@@ -136,7 +136,7 @@ binary/command name, and current install status.
 |-----------|-------|
 | `lang`    | 8 languages |
 | `db`      | 5 databases |
-| `ai`      | 41 AI agents |
+| `ai`      | 43 AI tools |
 | `editor`  | 3 editor components |
 | `dev`     | 22 development tools |
 | `npm`     | 11 npm global modules |
@@ -205,6 +205,7 @@ Opens the official documentation page for a module using
 | `ui`             | Termux UI |
 | `auto`           | Automation tools |
 | `deploy`         | Deploy CLIs |
+| `supabase`       | Supabase CLI |
 | `games`          | Games |
 | `cleanup`        | Cache cleanup |
 | `network`        | Network tools |
@@ -778,7 +779,10 @@ The main tool modules work with `install`, `uninstall`, `reinstall`, `update`,
 `list`, `show`, and `open`:
 
 `ai` `auto` `db` `deploy` `dev` `editor` `games` `lang` `network` `npm`
-`osint` `security` `shell` `ui` `utils` `voice`
+`osint` `security` `shell` `ui` `utils`
+
+`voice` works with `install`, `uninstall`, `reinstall`, `update`, `list`, and
+`open`; it has no per-tool README for `show`.
 
 `plugin` works with `install`, `uninstall`, `reinstall`, `update`, `list`, and
 `open`, but does not expose tool documentation through `show`.

package/install.sh

@@ -207,6 +207,12 @@ clone_repo() {
 		log_info "Developer installation detected"
 		log_ok "Using local repository"
 	elif [[ -d "$KARNEL_REPO/.git" ]]; then
+		local origin_url
+		origin_url="$(git -C "$KARNEL_REPO" remote get-url origin 2>/dev/null)"
+		if [[ "$origin_url" != "$REPO" && "$origin_url" != "${REPO%.git}" ]]; then
+			log_fail "Existing Karnel repository has an unexpected origin"
+			return 1
+		fi
 		progress_bar 3 10
 		if [[ -n "$RELEASE_REF" ]]; then
 			if ! git -C "$KARNEL_REPO" fetch --depth=1 origin "refs/tags/$BRANCH" &>/dev/null ||
@@ -215,7 +221,7 @@ clone_repo() {
 				return 1
 			fi
 		else
-			if ! git -C "$KARNEL_REPO" pull origin "$BRANCH" &>/dev/null; then
+			if ! git -c core.hooksPath=/dev/null -C "$KARNEL_REPO" pull origin "$BRANCH" &>/dev/null; then
 				log_fail "Failed to update existing repository"
 				return 1
 			fi
@@ -224,7 +230,6 @@ clone_repo() {
 		echo
 		log_ok "Repository updated"
 	else
-		_INSTALL_CREATED_KARNEL_REPO=true
 		progress_bar 0 10
 		git clone --depth=1 -b "$BRANCH" "$REPO" "$KARNEL_REPO" &>/dev/null &
 		local pid=$!
@@ -235,6 +240,7 @@ clone_repo() {
 			sleep 0.5
 		done
 		wait "$pid" || { log_fail "Failed to clone repository"; _cleanup_failed; exit 1; }
+		_INSTALL_CREATED_KARNEL_REPO=true
 		progress_bar 10 10
 		echo
 		log_ok "Repository cloned"

package/karnel/bin/karnel

@@ -75,7 +75,7 @@ show_update_notification() {
     echo
     log_warn "New version available: ${D_GREEN}$new_version${D_NC} (current: ${D_CYAN}$KARNEL_VERSION${D_NC})"
     echo
-    list_item "Run: ${D_CYAN}karnel update${D_NC} to update"
+    list_item "Run: ${D_CYAN}karnel update karnel${D_NC} to update"
     echo
   fi
 }

package/karnel/cli/commands/ia.sh

@@ -441,8 +441,12 @@ ia_routes() {
 
 	local -a routes=()
 
-	# Collect all available AI CLIs (em sincronia com AI_TOOLS_REGISTRY em tools/ai/all.sh)
-	for cmd in qwen gemini claude vibe openclaude openclaw ollama codex opencode mimo engram codegraph pi agy mmx gentle-ai gga hermes kimi command-code codebuff freebuff kilocode kiro cline crush odysseus kimchi omni-route ctx7 openspec copilot amp cursor omp goose droid supercode puter; do
+	import "@/tools/ai/all"
+	local entry binaries cmd
+	for entry in "${AI_TOOLS_REGISTRY[@]}"; do
+		binaries="${entry##*:}"
+		IFS=',' read -ra route_commands <<< "$binaries"
+		for cmd in "${route_commands[@]}"; do
 		if command -v "$cmd" &>/dev/null; then
 			local path
 			path=$(command -v "$cmd")
@@ -450,13 +454,9 @@ ia_routes() {
 		else
 			routes+=("$cmd|not installed|missing")
 		fi
+		done
 	done
 
-	if [[ ${#routes[@]} -eq 0 ]]; then
-		log_warn "No AI CLIs found"
-		return 0
-	fi
-
 	table_start "CLI" "Path" "Status"
 	for route in "${routes[@]}"; do
 		local cli

package/karnel/cli/commands/install.sh

@@ -188,9 +188,7 @@ _install_specific_tools() {
     local failed_count=0
     local skipped_count=0
 
-    # These entries MUST stay in sync with AI_TOOLS_REGISTRY in karnel/tools/ai/all.sh
-    # To add a new tool: 1) create install.sh 2) add to AI_TOOLS_REGISTRY 3) add case here
-    # Import the registry for _validate_tool_installed
+    # The registry is authoritative for accepted flags and post-install binaries.
     local -A _tool_binaries=()
     local _entry _id _name _bins
     for _entry in "${AI_TOOLS_REGISTRY[@]}"; do
@@ -200,7 +198,12 @@ _install_specific_tools() {
 
     for tool in "${tools[@]}"; do
       local func_name="install_${tool//-/_}"
-      local tool_display="${tool//-/_}"
+
+      if [[ -z "${_tool_binaries[$tool]+registered}" ]]; then
+        log_warn "Unknown AI tool: --$tool"
+        ((failed_count++))
+        continue
+      fi
 
       if declare -f "$func_name" &>/dev/null; then
         "$func_name"
@@ -233,13 +236,13 @@ _install_specific_tools() {
               ((failed_count++))
             fi
             ;;
-          *)
-            ((failed_count++))
-            ;;
-           2)
+          2)
             # Already installed (skipped)
             ((skipped_count++))
             ;;
+          *)
+            ((failed_count++))
+            ;;
         esac
       else
         log_warn "Function not found: $func_name"

package/karnel/cli/commands/list.sh

@@ -197,7 +197,7 @@ _list_ai() {
   table_row "Cline CLI" "--cline" "cline" "$(_check_cmd "cline")"
   table_row "Odysseus" "--odysseus" "odysseus" "$(_check_cmd "odysseus")"
   table_row "Kimchi CLI" "--kimchi-code" "kimchi" "$(_check_cmd "kimchi")"
-  table_row "omniRoute" "--omni-route" "omni-route" "$(_check_cmd "omni-route")"
+  table_row "omniRoute" "--omni-route" "omni-route" "$(_check_omni_route)"
   table_row "Context7 Docs" "--ctx7" "ctx7" "$(_check_cmd "ctx7")"
   table_row "OpenSpec SDD" "--openspec" "openspec" "$(_check_cmd "openspec")"
   table_row "Qoder" "--qoder" "qodercli" "$(_check_cmd "qodercli")"
@@ -206,6 +206,8 @@ _list_ai() {
   table_row "Oh-My-Pi" "--oh-my-pi" "omp" "$(_check_cmd "omp")"
   table_row "Goose CLI" "--goose" "goose" "$(_check_cmd "goose")"
   table_row "Factory Droid" "--droid" "droid" "$(_check_cmd "droid")"
+  table_row "Cactus" "--cactus" "cactus" "$(_check_cmd "cactus")"
+  table_row "Hugging Face" "--hugging-face" "hf" "$(_check_cmd "hf")"
   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")"
@@ -229,7 +231,7 @@ _list_editor() {
   table_start "Component" "Install Flag" "Status"
   table_row "code-server" "--code-server" "$(_check_cmd "code-server")"
   table_row "neovim" "--neovim" "$(_check_cmd "nvim")"
-  table_row "nvchad" "--nvchad" "$(_check_cmd "nvim")"
+  table_row "nvchad" "--nvchad" "$(_check_nvchad)"
   table_end
 
   echo
@@ -364,9 +366,9 @@ _list_ui() {
   echo
 
   table_start "Component" "Install Flag" "Status"
-  table_row "Meslo Nerd Font" "--font" "$(_check_file "$HOME/.termux/font.ttf")"
+  table_row "Meslo Nerd Font" "--font" "$(_check_font)"
   table_row "Extra Keys" "--extra-keys" "$(_check_extra_keys)"
-  table_row "Cursor Color" "--cursor" "$(_check_file "$HOME/.termux/colors.properties")"
+  table_row "Cursor Color" "--cursor" "$(_check_cursor)"
   table_row "Startup Banner" "--banner" "$(_grep_config "$HOME/.zshrc" "# ===== Karnel Banner =====" "$HOME/.bashrc")"
   table_end
 
@@ -474,6 +476,22 @@ _check_cmd() {
   fi
 }
 
+_check_omni_route() {
+  if command -v omni-route &>/dev/null && omni-route --version &>/dev/null 2>&1; then
+    echo -e "${D_GREEN}installed${NC}"
+  else
+    echo -e "${D_RED}not installed${NC}"
+  fi
+}
+
+_check_nvchad() {
+  if [[ -d "$KARNEL_DATA/nvchad-termux/.git" && -d "$HOME/.config/nvim" ]]; then
+    echo -e "${D_GREEN}installed${NC}"
+  else
+    echo -e "${D_RED}not installed${NC}"
+  fi
+}
+
 # Check if any of the comma-separated commands exists
 _check_cmd_any() {
   local bin_list="$1"
@@ -498,28 +516,27 @@ _check_pkg() {
   fi
 }
 
-# Check if directory exists
-_check_dir() {
-  local dir="$1"
-  if [[ -d "$dir" ]]; then
+_check_robin() {
+  if _robin_is_installed; then
     echo -e "${D_GREEN}installed${NC}"
   else
     echo -e "${D_RED}not installed${NC}"
   fi
 }
 
-_check_robin() {
-  if _robin_is_installed; then
+_check_font() {
+  local font_source
+  font_source="$(dirname "$KARNEL_PATH")/assets/fonts/font.ttf"
+  if [[ -f "$font_source" ]] && cmp -s "$font_source" "$HOME/.termux/font.ttf"; then
     echo -e "${D_GREEN}installed${NC}"
   else
     echo -e "${D_RED}not installed${NC}"
   fi
 }
 
-# Check if file exists
-_check_file() {
-  local file="$1"
-  if [[ -f "$file" ]]; then
+_check_cursor() {
+  if grep -qF '# Karnel cursor begin' "$HOME/.termux/colors.properties" 2>/dev/null &&
+    grep -qF '# Karnel cursor end' "$HOME/.termux/colors.properties" 2>/dev/null; then
     echo -e "${D_GREEN}installed${NC}"
   else
     echo -e "${D_RED}not installed${NC}"

package/karnel/cli/commands/open.sh

@@ -48,6 +48,9 @@ open_main() {
 	deploy)
 		url="$OPEN_BASE_URL/karnel/deploy"
 		;;
+	supabase)
+		url="$OPEN_BASE_URL/karnel/supabase"
+		;;
   cleanup)
     url="$OPEN_BASE_URL/karnel/cleanup"
     ;;
@@ -129,6 +132,7 @@ open_help() {
 	printf "    ${D_GREEN}%-14s${NC} ${D_DIM}%s${NC}\n" "ui" "Termux UI"
   printf "    ${D_GREEN}%-14s${NC} ${D_DIM}%s${NC}\n" "auto" "Automation tools"
   printf "    ${D_GREEN}%-14s${NC} ${D_DIM}%s${NC}\n" "deploy" "Deploy CLIs"
+  printf "    ${D_GREEN}%-14s${NC} ${D_DIM}%s${NC}\n" "supabase" "Supabase CLI"
   printf "    ${D_GREEN}%-14s${NC} ${D_DIM}%s${NC}\n" "games" "Games"
   printf "    ${D_GREEN}%-14s${NC} ${D_DIM}%s${NC}\n" "cleanup" "Cache cleanup"
   printf "    ${D_GREEN}%-14s${NC} ${D_DIM}%s${NC}\n" "network" "Network tools"

package/karnel/cli/commands/reinstall.sh

@@ -182,191 +182,7 @@ _reinstall_specific_tools() {
 
   case "$module" in
   ai)
-    import "@/tools/ai/all"
-    local reinstalled_count=0
-    local failed_count=0
-
-    for tool in "${tools[@]}"; do
-      case "$tool" in
-      qwen-code)
-        reinstall_qwen_code
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      gemini-cli)
-        reinstall_gemini_cli
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      claude-code)
-        reinstall_claude_code
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      mistral-vibe)
-        reinstall_mistral_vibe
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      openclaude)
-        reinstall_openclaude
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      openclaw)
-        reinstall_openclaw
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      ollama)
-        reinstall_ollama
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      codex)
-        reinstall_codex
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      opencode)
-        reinstall_opencode
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      kilocode-cli)
-        reinstall_kilocode_cli
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      kimchi-code)
-        reinstall_kimchi_code
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      mimocode)
-        reinstall_mimocode
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      engram)
-        reinstall_engram
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      codegraph)
-        reinstall_codegraph
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      pi)
-        reinstall_pi
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      antigravity-cli)
-        reinstall_antigravity_cli
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      minimax-cli)
-        reinstall_minimax_cli
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      gentle-ai)
-        reinstall_gentle_ai
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      gga)
-        reinstall_gga
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      hermes-agent)
-        reinstall_hermes_agent
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      kimi-code)
-        reinstall_kimi_code
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      command-code)
-        reinstall_command_code
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      codebuff)
-        reinstall_codebuff
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      freebuff)
-        reinstall_freebuff
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      ctx7)
-        reinstall_ctx7
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      openspec)
-        reinstall_openspec
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      supercode-cli)
-        reinstall_supercode_cli
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      puter)
-        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
-        ;;
-      ampcode)
-        reinstall_ampcode
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      cursor-cli)
-        reinstall_cursor_cli
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      oh-my-pi)
-        reinstall_oh_my_pi
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      goose)
-        reinstall_goose
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      droid)
-        reinstall_droid
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      copilot-termux)
-        reinstall_copilot_termux
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      kiro)
-        reinstall_kiro
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      crush)
-        reinstall_crush
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      cline)
-        reinstall_cline
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      odysseus)
-        reinstall_odysseus
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      omni-route)
-        reinstall_omni_route
-        case $? in 0) ((reinstalled_count++));; 1) ((failed_count++));; esac
-        ;;
-      *)
-        log_warn "Unknown AI tool: --$tool"
-        ((failed_count++))
-        ;;
-      esac
-    done
-
-    echo
-    if [[ $reinstalled_count -gt 0 ]]; then
-      log_success "$reinstalled_count AI tool(s) reinstalled"
-    fi
-    if [[ $failed_count -gt 0 ]]; then
-      log_warn "$failed_count tool(s) failed to reinstall"
-    fi
-    echo
+    _batch_tool_action "ai" "reinstall" "${tools[@]}" || return 1
     ;;
   db)
     import "@/tools/db/all"

package/karnel/cli/commands/supabase.sh

@@ -199,7 +199,7 @@ supabase_remote() {
   log_info "For full local development, use a Linux host:"
   echo
   list_item "1. SSH into a Linux VPS, Codespaces, or local Linux machine"
-  list_item "2. Install Docker: ${D_CYAN}curl -fsSL https://get.docker.com | sh${NC}"
+  list_item "2. Install Docker using the official Linux installation guide"
   list_item "3. Install Supabase CLI on that machine"
   list_item "4. Clone your project there"
   list_item "5. Run ${D_CYAN}supabase start${NC} for local stack"