karnel-termux 4.13.11 → 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.11-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` |
@@ -259,7 +259,7 @@ See the bundled reference with `karnel show osint --robin`.
 
 ---
 
-## AI Agents (41)
+## AI Tools (43)
 
 ```bash
 karnel install ai                             # Install all
@@ -278,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 |
@@ -545,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,17 @@
 # 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

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. |
@@ -42,7 +42,7 @@ karnel install <module> --tool1 --tool2  # Install specific tools only
 
 | 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` |
@@ -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 |

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"

package/karnel/cli/commands/list.sh

@@ -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")"

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/karnel.sh

@@ -110,7 +110,7 @@ karnel_help() {
   echo
   log_info "Use with: karnel install|update|reinstall|uninstall <target> [--tool...]"
   echo
-  printf "    ${D_GREEN}%-10s${NC} %s\n" "ai" "41 AI tools (OpenCode, Claude, KeelCode, Ollama, Copilot-Termux, Goose, etc.)"
+  printf "    ${D_GREEN}%-10s${NC} %s\n" "ai" "43 AI tools (OpenCode, Cactus, Hugging Face, Claude, Ollama, Goose, etc.)"
   printf "    ${D_GREEN}%-10s${NC} %s\n" "auto" "Automation (n8n)"
   printf "    ${D_GREEN}%-10s${NC} %s\n" "db" "PostgreSQL, MariaDB, SQLite, MongoDB, Redis"
   printf "    ${D_GREEN}%-10s${NC} %s\n" "deploy" "Vercel, Railway, Netlify, Supabase CLIs"
@@ -370,7 +370,7 @@ _tui_list_menu() {
   local modules="ai db lang dev editor npm shell ui auto deploy games network utils osint voice plugin security"
   local choice
   choice=$(_dialog_menu "List Tools" "Select a module to list:" \
-    "ai" "AI Agents (41)" \
+    "ai" "AI Tools (43)" \
     "db" "Databases" \
     "lang" "Programming Languages" \
     "editor" "Code Editors" \
@@ -760,49 +760,13 @@ _tui_install_checklist() {
       )
       ;;
     ai)
-      opts=(
-        "qwen-code" "Qwen Code" OFF
-        "gemini-cli" "Gemini CLI" OFF
-        "claude-code" "Claude Code" OFF
-        "mistral-vibe" "Mistral Vibe" OFF
-        "openclaude" "OpenClaude" OFF
-        "openclaw" "OpenClaw" OFF
-        "ollama" "Ollama" OFF
-        "codex" "Codex CLI" OFF
-        "opencode" "OpenCode" OFF
-        "mimocode" "MiMo Code" OFF
-        "engram" "Engram" OFF
-        "codegraph" "CodeGraph" OFF
-        "pi" "Pi" OFF
-        "antigravity-cli" "Antigravity CLI" OFF
-        "gentle-ai" "Gentle AI" OFF
-        "minimax-cli" "Minimax CLI" OFF
-        "gga" "GGA" OFF
-        "hermes-agent" "Hermes Agent" OFF
-        "kimi-code" "Kimi Code" OFF
-        "command-code" "Command Code" OFF
-        "codebuff" "Codebuff" OFF
-        "freebuff" "Freebuff" OFF
-        "crush" "Crush CLI" OFF
-        "odysseus" "Odysseus" OFF
-        "kilocode-cli" "Kilo Code CLI" OFF
-        "kiro" "Kiro CLI" OFF
-        "cline" "Cline CLI" OFF
-        "kimchi-code" "Kimchi CLI" OFF
-        "omni-route" "omniRoute" OFF
-        "ctx7" "Context7 Docs" OFF
-        "openspec" "OpenSpec SDD" OFF
-        "supercode-cli" "Supercode CLI" OFF
-        "puter" "Puter CLI" OFF
-        "keelcode" "KeelCode" OFF
-        "copilot-termux" "Copilot-Termux" OFF
-        "qoder" "Qoder" OFF
-        "ampcode" "AMP Code CLI" OFF
-        "cursor-cli" "Cursor CLI" OFF
-        "oh-my-pi" "Oh-My-Pi" OFF
-        "goose" "Goose CLI" OFF
-        "droid" "Factory Droid" OFF
-      )
+      import "@/tools/ai/all"
+      opts=()
+      local entry id name binaries
+      for entry in "${AI_TOOLS_REGISTRY[@]}"; do
+        IFS=':' read -r id name binaries <<< "$entry"
+        opts+=("$id" "$name" OFF)
+      done
       ;;
     dev)
       opts=(

package/karnel/modules/ai.sh

@@ -38,14 +38,17 @@ install_ai() {
   echo
 
   # Mostra apenas ferramentas que foram realmente instaladas (command -v)
-  local _reg_entry _id _name _bins
+  local _reg_entry _id _name _bins _bin
+  local -a _registered_bins
   for _reg_entry in "${AI_TOOLS_REGISTRY[@]}"; do
     IFS=':' read -r _id _name _bins <<< "$_reg_entry"
-    # Pega o primeiro binario da lista (separado por virgula)
-    local _first_bin="${_bins%%,*}"
-    if command -v "$_first_bin" &>/dev/null; then
-      list_item "$_name ${GRAY}(${D_GREEN}$_first_bin${GRAY})"
-    fi
+    IFS=',' read -ra _registered_bins <<< "$_bins"
+    for _bin in "${_registered_bins[@]}"; do
+      if command -v "$_bin" &>/dev/null; then
+        list_item "$_name ${GRAY}(${D_GREEN}$_bin${GRAY})"
+        break
+      fi
+    done
   done
 
   echo
@@ -117,17 +120,6 @@ reinstall_ai() {
   local rc=0
   import "@/tools/ai/all"
   reinstall_all_ai_tools || rc=$?
-  echo
-  log_info "Reinstalled tools:"
-  echo
-
-  local _reg_entry _id _name _bins
-  for _reg_entry in "${AI_TOOLS_REGISTRY[@]}"; do
-    IFS=':' read -r _id _name _bins <<< "$_reg_entry"
-    list_item "$_name"
-  done
-  echo
-
   if [ "$rc" -eq 0 ]; then
     log_success "AI tools reinstalled successfully"
   else

package/karnel/tools/ai/all.sh

@@ -69,6 +69,8 @@ AI_TOOLS_REGISTRY=(
   "oh-my-pi:Oh-My-Pi:omp"
   "goose:Goose CLI:goose"
   "droid:Factory Droid:droid"
+  "cactus:Cactus:cactus"
+  "hugging-face:Hugging Face:hf"
 )
 
 # ---- IMPORTAR TODOS OS SCRIPTS INDIVIDUAIS ----
@@ -115,6 +117,41 @@ _validate_tool_installed() {
 
 # ---- FUNÇÕES DE LOTE ----
 
+_ai_tool_registered() {
+  local wanted="$1"
+  local entry id
+  for entry in "${AI_TOOLS_REGISTRY[@]}"; do
+    id="${entry%%:*}"
+    [[ "$id" == "$wanted" ]] && return 0
+  done
+  return 1
+}
+
+_run_ai_tool_action() {
+  local action="$1"
+  local id="$2"
+  local func_name="${action}_${id//-/_}"
+
+  _ai_tool_registered "$id" || return 127
+
+  if [[ "$action" != "reinstall" ]]; then
+    declare -f "$func_name" &>/dev/null || return 127
+    "$func_name"
+    return $?
+  fi
+
+  local uninstall_fn="uninstall_${id//-/_}"
+  local install_fn="install_${id//-/_}"
+  declare -f "$uninstall_fn" &>/dev/null && declare -f "$install_fn" &>/dev/null || return 127
+
+  "$uninstall_fn"
+  local uninstall_rc=$?
+  if [[ $uninstall_rc -ne 0 && $uninstall_rc -ne 2 ]]; then
+    return "$uninstall_rc"
+  fi
+  "$install_fn"
+}
+
 _all_ai_tools_action() {
   local action="$1"        # install, uninstall, update, reinstall
   local action_label="$2"  # Instalando, Removendo, Atualizando, Reinstalando
@@ -128,15 +165,12 @@ _all_ai_tools_action() {
 
   for entry in "${AI_TOOLS_REGISTRY[@]}"; do
     IFS=':' read -r id name binaries <<< "$entry"
-    local func_name="${action}_${id//-/_}"
-
     ((current++))
 
-    if declare -f "$func_name" &>/dev/null; then
-      "$func_name"
-      local rc=$?
+    _run_ai_tool_action "$action" "$id"
+    local rc=$?
 
-      case $rc in
+    case $rc in
         0)
           # Pós-validação apenas para install
           if [[ "$action" == "install" ]]; then
@@ -161,11 +195,11 @@ _all_ai_tools_action() {
         2)
           ((skipped_count++))
           ;;
-      esac
-    else
-      log_warn "Função não encontrada: $func_name"
-      ((failed_count++))
-    fi
+        *)
+          log_warn "$name: ${action}_${id//-/_} returned status $rc"
+          ((failed_count++))
+          ;;
+    esac
 
     progress_update "$current" "$total"
   done

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

@@ -214,9 +214,9 @@ uninstall_ampcode() {
   mkdir -p "$(dirname "$LOG_FILE")"
   if [ ! -f "$PREFIX/bin/amp" ]; then
     log_warn "AMP Code CLI is not installed"
-    return 1
+    return 2
   fi
-  loading "Uninstalling AMP Code CLI" _uninstall_ampcode_impl
+  loading "Uninstalling AMP Code CLI" _uninstall_ampcode_impl || return 1
 }
 
 _uninstall_ampcode_impl() {

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

@@ -0,0 +1,36 @@
+# Cactus
+
+Cactus is an on-device inference engine for text, vision, speech, embeddings,
+and RAG. Karnel installs the official `cactus-compute` 2.0.1 ARM64 package in
+an Ubuntu `proot-distro` environment because its Linux wheel targets glibc,
+while native Termux uses Android/Bionic.
+
+If the installed Ubuntu container uses Python 3.14 or newer, Karnel provisions
+an isolated upstream-compatible Python 3.13 runtime with `uv`; it does not
+replace the container's system Python.
+
+## Install
+
+```bash
+karnel install ai --cactus
+cactus --help
+cactus run Cactus-Compute/needle
+```
+
+Other examples:
+
+```bash
+cactus download Cactus-Compute/needle
+cactus list
+cactus serve Cactus-Compute/needle
+```
+
+The first model download can be large and inference performance depends on the
+device's RAM, storage, and thermal limits. Cactus is currently enabled only on
+ARM64 because that is the Linux wheel published by the upstream project.
+
+Karnel removes only its managed Python environment and wrapper. Model data
+created elsewhere is preserved. Cactus uses a source-available license with
+commercial-use restrictions; review the upstream license before use.
+
+Official project: <https://github.com/cactus-compute/cactus>

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

@@ -0,0 +1,171 @@
+#!/usr/bin/env bash
+
+import "@/utils/log"
+
+: "${KARNEL_DATA:=${XDG_DATA_HOME:-$HOME/.local/share}/karnel-data}"
+CACTUS_VERSION="2.0.1"
+CACTUS_DATA_DIR="$KARNEL_DATA/cactus"
+CACTUS_CONTAINER_DIR="/opt/karnel/cactus"
+CACTUS_WRAPPER="$PREFIX/bin/cactus"
+
+_cactus_data_owned() {
+  [[ -f "$CACTUS_DATA_DIR/.karnel-managed" ]]
+}
+
+_cactus_wrapper_owned() {
+  local marker="$CACTUS_DATA_DIR/.karnel-wrapper-cactus"
+  [[ -f "$marker" && -f "$CACTUS_WRAPPER" ]] || return 1
+  [[ "$(sha256sum "$CACTUS_WRAPPER" 2>/dev/null)" == "$(<"$marker")" ]]
+}
+
+_cactus_proot() {
+  proot-distro login --shared-tmp ubuntu -- "$@"
+}
+
+_cactus_container_owned() {
+  command -v proot-distro &>/dev/null || return 1
+  _cactus_proot test -f "$CACTUS_CONTAINER_DIR/.karnel-managed" &>/dev/null
+}
+
+_cactus_verify_ownership() {
+  if [[ -e "$CACTUS_DATA_DIR" ]] && ! _cactus_data_owned; then
+    log_error "Refusing to replace unowned Cactus data: $CACTUS_DATA_DIR"
+    return 1
+  fi
+  if [[ -e "$CACTUS_WRAPPER" ]] && ! _cactus_wrapper_owned; then
+    log_error "Refusing to replace unowned command: $CACTUS_WRAPPER"
+    return 1
+  fi
+  if command -v cactus &>/dev/null && ! _cactus_wrapper_owned; then
+    log_error "Refusing to shadow the existing cactus command: $(command -v cactus)"
+    return 1
+  fi
+  if command -v proot-distro &>/dev/null &&
+    _cactus_proot test -e "$CACTUS_CONTAINER_DIR" &>/dev/null &&
+    ! _cactus_container_owned; then
+    log_error "Refusing to replace unowned Cactus data in Ubuntu: $CACTUS_CONTAINER_DIR"
+    return 1
+  fi
+}
+
+_cactus_ensure_ubuntu() {
+  case "$(uname -m)" in
+    aarch64|arm64) ;;
+    *)
+      log_error "Cactus currently provides a Linux wheel only for ARM64"
+      return 1
+      ;;
+  esac
+  if ! command -v proot-distro &>/dev/null; then
+    pkg install proot-distro -y || return 1
+  fi
+  if ! proot-distro login ubuntu -- true &>/dev/null; then
+    proot-distro install ubuntu:24.04 || return 1
+  fi
+}
+
+_cactus_validate() {
+  _cactus_proot "$CACTUS_CONTAINER_DIR/venv/bin/cactus" --help &>/dev/null
+}
+
+_install_cactus_inside_ubuntu() {
+  _cactus_proot /bin/bash -c '
+    set -e
+    export DEBIAN_FRONTEND=noninteractive
+    if [ -f /etc/apt/sources.list.d/ubuntu.sources ]; then
+      official_source=/etc/apt/sources.list.d/ubuntu.sources
+    else
+      official_source=/etc/apt/sources.list
+    fi
+    apt_options=(-o "Dir::Etc::sourcelist=$official_source" -o "Dir::Etc::sourceparts=-")
+    apt-get "${apt_options[@]}" update -qq
+    apt-get "${apt_options[@]}" install -y -qq ca-certificates python3 python3-pip python3-venv
+    if [ -e /opt/karnel/cactus ] && [ ! -f /opt/karnel/cactus/.karnel-managed ]; then
+      echo "Refusing to replace unowned /opt/karnel/cactus" >&2
+      exit 1
+    fi
+    rm -rf /opt/karnel/cactus
+    mkdir -p /opt/karnel/cactus
+    : > /opt/karnel/cactus/.karnel-managed
+    if python3 -c "import sys; raise SystemExit(sys.version_info >= (3, 14))"; then
+      python3 -m venv /opt/karnel/cactus/venv
+    else
+      python3 -m venv /opt/karnel/cactus/bootstrap
+      /opt/karnel/cactus/bootstrap/bin/python -m pip install --upgrade uv
+      export UV_PYTHON_INSTALL_DIR=/opt/karnel/cactus/python
+      /opt/karnel/cactus/bootstrap/bin/uv python install 3.13
+      /opt/karnel/cactus/bootstrap/bin/uv venv --seed --python 3.13 /opt/karnel/cactus/venv
+    fi
+    /opt/karnel/cactus/venv/bin/python -m pip install --upgrade "cactus-compute==2.0.1"
+    /opt/karnel/cactus/venv/bin/cactus --help >/dev/null
+  '
+}
+
+_cactus_write_wrapper() {
+  mkdir -p "$CACTUS_DATA_DIR" "$PREFIX/bin" || return 1
+  : >"$CACTUS_DATA_DIR/.karnel-managed" || return 1
+  local temporary
+  temporary="$(mktemp "$PREFIX/bin/.cactus.XXXXXX")" || return 1
+  cat >"$temporary" <<EOF
+#!$PREFIX/bin/bash
+# Karnel-managed Cactus wrapper
+exec proot-distro login --shared-tmp ubuntu -- $CACTUS_CONTAINER_DIR/venv/bin/cactus "\$@"
+EOF
+  chmod 755 "$temporary" || { rm -f "$temporary"; return 1; }
+  mv -f "$temporary" "$CACTUS_WRAPPER" || return 1
+  sha256sum "$CACTUS_WRAPPER" >"$CACTUS_DATA_DIR/.karnel-wrapper-cactus" || return 1
+}
+
+install_cactus() {
+  if _cactus_data_owned && _cactus_wrapper_owned && _cactus_container_owned && _cactus_validate; then
+    log_info "Cactus is already installed"
+    return 2
+  fi
+  _cactus_verify_ownership || return 1
+
+  log_info "Installing Cactus $CACTUS_VERSION in Ubuntu (glibc compatibility)..."
+  _cactus_ensure_ubuntu || return 1
+  if ! _install_cactus_inside_ubuntu || ! _cactus_write_wrapper || ! _cactus_validate; then
+    _cactus_wrapper_owned && rm -f "$CACTUS_WRAPPER"
+    _cactus_data_owned && rm -rf "$CACTUS_DATA_DIR"
+    log_error "Failed to install Cactus"
+    return 1
+  fi
+  log_success "Cactus installed"
+  log_info "Start with: cactus run Cactus-Compute/needle"
+}
+
+uninstall_cactus() {
+  if ! _cactus_data_owned && ! _cactus_wrapper_owned && ! _cactus_container_owned; then
+    if [[ -e "$CACTUS_DATA_DIR" || -e "$CACTUS_WRAPPER" ]]; then
+      _cactus_verify_ownership
+      return $?
+    fi
+    log_info "Cactus is not installed by Karnel"
+    return 2
+  fi
+  _cactus_verify_ownership || return 1
+
+  _cactus_wrapper_owned && rm -f "$CACTUS_WRAPPER"
+  if _cactus_container_owned; then
+    _cactus_proot rm -rf "$CACTUS_CONTAINER_DIR" || return 1
+  fi
+  _cactus_data_owned && rm -rf "$CACTUS_DATA_DIR"
+  log_success "Cactus uninstalled; downloaded model data outside its environment was preserved"
+}
+
+update_cactus() {
+  _cactus_data_owned && _cactus_wrapper_owned && _cactus_container_owned || {
+    log_error "Cactus is not installed by Karnel"
+    return 1
+  }
+  _cactus_verify_ownership || return 1
+  _cactus_proot "$CACTUS_CONTAINER_DIR/venv/bin/python" -m pip install --upgrade 'cactus-compute>=2,<3' || return 1
+  _cactus_validate || return 1
+  log_success "Cactus updated"
+}
+
+reinstall_cactus() {
+  uninstall_cactus || [[ $? -eq 2 ]] || return 1
+  install_cactus
+}

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

@@ -142,7 +142,7 @@ uninstall_codegraph() {
 	log_info "Uninstalling CodeGraph..."
 	mkdir -p "$(dirname "$LOG_FILE")"
 
-	loading "Removing CodeGraph" _uninstall_codegraph_impl
+	loading "Removing CodeGraph" _uninstall_codegraph_impl || return 1
 
 	log_success "CodeGraph uninstalled"
 	return 0

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

@@ -67,7 +67,7 @@ uninstall_codex() {
 	log_info "Uninstalling Codex CLI..."
 	mkdir -p "$(dirname "$LOG_FILE")"
 
-	loading "Removing Codex CLI" _uninstall_codex_impl
+	loading "Removing Codex CLI" _uninstall_codex_impl || return 1
 
 	log_success "Codex CLI uninstalled"
 	return 0

package/karnel/tools/ai/command-code/install.sh

@@ -122,7 +122,7 @@ uninstall_command_code() {
   log_info "Uninstalling Command Code..."
   mkdir -p "$(dirname "$LOG_FILE")"
 
-  loading "Removing Command Code files" _uninstall_command_code_impl
+  loading "Removing Command Code files" _uninstall_command_code_impl || return 1
 
   log_success "Command Code uninstalled"
   return 0

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

@@ -85,7 +85,7 @@ uninstall_engram() {
   log_info "Uninstalling Engram..."
   mkdir -p "$(dirname "$LOG_FILE")"
 
-  loading "Removing Engram" _uninstall_engram_impl
+  loading "Removing Engram" _uninstall_engram_impl || return 1
 
   log_success "Engram uninstalled"
   return 0

package/karnel/tools/ai/gemini-cli/install.sh

@@ -71,7 +71,7 @@ uninstall_gemini_cli() {
   log_info "Uninstalling Gemini CLI..."
   mkdir -p "$(dirname "$LOG_FILE")"
 
-  loading "Removing Gemini CLI" _uninstall_gemini_cli_impl
+  loading "Removing Gemini CLI" _uninstall_gemini_cli_impl || return 1
 
   log_success "Gemini CLI uninstalled"
   return 0

package/karnel/tools/ai/hermes-agent/install.sh

@@ -86,7 +86,7 @@ uninstall_hermes_agent() {
   log_info "Uninstalling Hermes Agent..."
   mkdir -p "$(dirname "$LOG_FILE")"
 
-  loading "Removing Hermes Agent" _uninstall_hermes_agent_impl
+  loading "Removing Hermes Agent" _uninstall_hermes_agent_impl || return 1
 
   log_success "Hermes Agent uninstalled successfully"
   return 0

package/karnel/tools/ai/hugging-face/README.md

@@ -0,0 +1,34 @@
+# Hugging Face CLI
+
+Official `hf` command-line client for the Hugging Face Hub, installed in an
+isolated Python environment so it does not modify the user's global packages.
+
+## Install
+
+```bash
+karnel install ai --hugging-face
+hf auth login
+hf auth whoami
+```
+
+Common commands:
+
+```bash
+hf models ls --search qwen --limit 10
+hf download Cactus-Compute/needle
+hf cache ls
+```
+
+Karnel stores the managed environment under
+`~/.local/share/karnel-data/hugging-face`. Uninstalling removes only that
+environment and the Karnel-owned `hf` command. Credentials and downloaded
+models under `~/.cache/huggingface` are preserved.
+
+The optional Xet accelerator is disabled because it does not publish an
+Android wheel. Downloads use the standard Hugging Face HTTP transport instead.
+
+Do not put Hugging Face tokens in shell history, repositories, screenshots, or
+issue reports. Prefer the interactive `hf auth login` flow or the `HF_TOKEN`
+environment variable.
+
+Official documentation: <https://huggingface.co/docs/huggingface_hub/guides/cli>

package/karnel/tools/ai/hugging-face/install.sh

@@ -0,0 +1,129 @@
+#!/usr/bin/env bash
+
+import "@/utils/log"
+
+: "${KARNEL_DATA:=${XDG_DATA_HOME:-$HOME/.local/share}/karnel-data}"
+HUGGING_FACE_DATA_DIR="$KARNEL_DATA/hugging-face"
+HUGGING_FACE_VENV="$HUGGING_FACE_DATA_DIR/venv"
+HUGGING_FACE_WRAPPER="$PREFIX/bin/hf"
+
+_hugging_face_data_owned() {
+  [[ -f "$HUGGING_FACE_DATA_DIR/.karnel-managed" ]]
+}
+
+_hugging_face_wrapper_owned() {
+  local marker="$HUGGING_FACE_DATA_DIR/.karnel-wrapper-hf"
+  [[ -f "$marker" && -f "$HUGGING_FACE_WRAPPER" ]] || return 1
+  [[ "$(sha256sum "$HUGGING_FACE_WRAPPER" 2>/dev/null)" == "$(<"$marker")" ]]
+}
+
+_hugging_face_verify_ownership() {
+  if [[ -e "$HUGGING_FACE_DATA_DIR" ]] && ! _hugging_face_data_owned; then
+    log_error "Refusing to replace unowned Hugging Face data: $HUGGING_FACE_DATA_DIR"
+    return 1
+  fi
+  if [[ -e "$HUGGING_FACE_WRAPPER" || -L "$HUGGING_FACE_WRAPPER" ]] && ! _hugging_face_wrapper_owned; then
+    log_error "Refusing to replace unowned command: $HUGGING_FACE_WRAPPER"
+    return 1
+  fi
+  if command -v hf &>/dev/null && ! _hugging_face_wrapper_owned; then
+    log_error "Refusing to shadow the existing hf command: $(command -v hf)"
+    return 1
+  fi
+}
+
+_hugging_face_validate() {
+  "$HUGGING_FACE_VENV/bin/hf" --help &>/dev/null
+}
+
+_hugging_face_install_packages() {
+  local python="$HUGGING_FACE_VENV/bin/python"
+  "$python" -m pip install --upgrade \
+    'click>=8.1' 'filelock>=3.10' 'fsspec>=2023.5' 'httpx>=0.23,<1' \
+    'packaging>=20.9' 'pyyaml>=5.1' shellingham 'tqdm>=4.42.1' \
+    typer-slim 'typing-extensions>=3.7.4.3' || return 1
+  # hf-xet has no Android wheel and its Rust bootstrap rejects the Android target.
+  "$python" -m pip install --upgrade --no-deps 'huggingface_hub>=1,<2'
+}
+
+_hugging_face_write_wrapper() {
+  local temporary
+  temporary="$(mktemp "$PREFIX/bin/.hf.XXXXXX")" || return 1
+  cat >"$temporary" <<EOF
+#!$PREFIX/bin/bash
+# Karnel-managed Hugging Face CLI wrapper
+export HF_HUB_DISABLE_XET=1
+exec $HUGGING_FACE_VENV/bin/hf "\$@"
+EOF
+  chmod 755 "$temporary" || { rm -f "$temporary"; return 1; }
+  mv -f "$temporary" "$HUGGING_FACE_WRAPPER" || return 1
+  sha256sum "$HUGGING_FACE_WRAPPER" >"$HUGGING_FACE_DATA_DIR/.karnel-wrapper-hf" || return 1
+}
+
+_install_hugging_face_impl() {
+  if ! command -v python3 &>/dev/null; then
+    pkg install python -y || return 1
+  fi
+  python3 -c 'import sys; raise SystemExit(sys.version_info < (3, 9))' || {
+    log_error "Hugging Face CLI requires Python 3.9 or newer"
+    return 1
+  }
+
+  mkdir -p "$HUGGING_FACE_DATA_DIR" "$PREFIX/bin" || return 1
+  : >"$HUGGING_FACE_DATA_DIR/.karnel-managed" || return 1
+  rm -rf "$HUGGING_FACE_VENV"
+  python3 -m venv "$HUGGING_FACE_VENV" || return 1
+  _hugging_face_install_packages || return 1
+  _hugging_face_validate || return 1
+  _hugging_face_write_wrapper
+}
+
+install_hugging_face() {
+  if _hugging_face_data_owned && _hugging_face_wrapper_owned && _hugging_face_validate; then
+    log_info "Hugging Face CLI is already installed"
+    return 2
+  fi
+  _hugging_face_verify_ownership || return 1
+
+  log_info "Installing Hugging Face CLI in an isolated environment..."
+  if ! _install_hugging_face_impl; then
+    _hugging_face_wrapper_owned && rm -f "$HUGGING_FACE_WRAPPER"
+    _hugging_face_data_owned && rm -rf "$HUGGING_FACE_DATA_DIR"
+    log_error "Failed to install Hugging Face CLI"
+    return 1
+  fi
+  log_success "Hugging Face CLI installed"
+  log_info "Authenticate with: hf auth login"
+}
+
+uninstall_hugging_face() {
+  if ! _hugging_face_data_owned && ! _hugging_face_wrapper_owned; then
+    if [[ -e "$HUGGING_FACE_DATA_DIR" || -e "$HUGGING_FACE_WRAPPER" || -L "$HUGGING_FACE_WRAPPER" ]]; then
+      _hugging_face_verify_ownership
+      return $?
+    fi
+    log_info "Hugging Face CLI is not installed by Karnel"
+    return 2
+  fi
+  _hugging_face_verify_ownership || return 1
+
+  _hugging_face_wrapper_owned && rm -f "$HUGGING_FACE_WRAPPER"
+  _hugging_face_data_owned && rm -rf "$HUGGING_FACE_DATA_DIR"
+  log_success "Hugging Face CLI uninstalled; credentials and model cache were preserved"
+}
+
+update_hugging_face() {
+  _hugging_face_data_owned && _hugging_face_wrapper_owned || {
+    log_error "Hugging Face CLI is not installed by Karnel"
+    return 1
+  }
+  _hugging_face_verify_ownership || return 1
+  _hugging_face_install_packages || return 1
+  _hugging_face_validate || return 1
+  log_success "Hugging Face CLI updated"
+}
+
+reinstall_hugging_face() {
+  uninstall_hugging_face || [[ $? -eq 2 ]] || return 1
+  install_hugging_face
+}

package/karnel/tools/ai/kilocode-cli/install.sh

@@ -195,10 +195,10 @@ uninstall_kilocode_cli() {
 
   if ! _kilocode_wrapper_owned && ! _kilocode_alias_owned && ! _kilocode_data_owned; then
     log_warn "Kilo Code CLI is not installed"
-    return 1
+    return 2
   fi
 
-  loading "Uninstalling Kilo Code CLI" _uninstall_kilocode_cli_impl
+  loading "Uninstalling Kilo Code CLI" _uninstall_kilocode_cli_impl || return 1
 }
 
 _uninstall_kilocode_cli_impl() {
@@ -213,6 +213,6 @@ update_kilocode_cli() {
 }
 
 reinstall_kilocode_cli() {
-  uninstall_kilocode_cli
+  uninstall_kilocode_cli || [[ $? -eq 2 ]] || return 1
   install_kilocode_cli
 }

package/karnel/tools/ai/kimi-code/install.sh

@@ -69,7 +69,7 @@ uninstall_kimi_code() {
   log_info "Uninstalling Kimi Code..."
   mkdir -p "$(dirname "$LOG_FILE")"
 
-  loading "Removing Kimi Code" _uninstall_kimi_code_impl
+  loading "Removing Kimi Code" _uninstall_kimi_code_impl || return 1
 
   log_success "Kimi Code uninstalled successfully"
   return 0

package/karnel/tools/ai/minimax-cli/install.sh

@@ -69,7 +69,7 @@ uninstall_minimax_cli() {
   log_info "Uninstalling MiniMax CLI..."
   mkdir -p "$(dirname "$LOG_FILE")"
 
-  loading "Removing MiniMax CLI" _uninstall_minimax_cli_impl
+  loading "Removing MiniMax CLI" _uninstall_minimax_cli_impl || return 1
 
   log_success "MiniMax CLI uninstalled successfully"
   return 0

package/karnel/tools/ai/mistral-vibe/install.sh

@@ -79,7 +79,7 @@ uninstall_mistral_vibe() {
   log_info "Uninstalling Mistral Vibe..."
   mkdir -p "$(dirname "$LOG_FILE")"
 
-  loading "Removing Mistral Vibe" _uninstall_mistral_vibe_impl
+  loading "Removing Mistral Vibe" _uninstall_mistral_vibe_impl || return 1
 
   log_success "Mistral Vibe uninstalled"
   return 0

package/karnel/tools/ai/oh-my-pi/install.sh

@@ -226,10 +226,10 @@ _omp_is_proot() {
 uninstall_oh_my_pi() {
   mkdir -p "$(dirname "$LOG_FILE")"
   if _omp_is_native; then
-    loading "Uninstalling Oh-My-Pi (native)" _uninstall_omp_native_impl
+    loading "Uninstalling Oh-My-Pi (native)" _uninstall_omp_native_impl || return 1
     log_success "Oh-My-Pi (native) uninstalled"
   elif _omp_is_proot; then
-    loading "Uninstalling Oh-My-Pi (proot-distro)" _uninstall_omp_proot_impl
+    loading "Uninstalling Oh-My-Pi (proot-distro)" _uninstall_omp_proot_impl || return 1
     log_success "Oh-My-Pi (proot-distro) uninstalled"
   else
     log_info "Oh-My-Pi is not installed"

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

@@ -41,7 +41,7 @@ uninstall_ollama() {
   log_info "Uninstalling Ollama..."
   mkdir -p "$(dirname "$LOG_FILE")"
 
-  loading "Removing Ollama" _uninstall_ollama_impl
+  loading "Removing Ollama" _uninstall_ollama_impl || return 1
 
   log_success "Ollama uninstalled"
   return 0

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

@@ -70,7 +70,7 @@ uninstall_openclaude() {
   log_info "Uninstalling OpenClaude..."
   mkdir -p "$(dirname "$LOG_FILE")"
 
-  loading "Removing OpenClaude" _uninstall_openclaude_impl
+  loading "Removing OpenClaude" _uninstall_openclaude_impl || return 1
 
   log_success "OpenClaude uninstalled"
   return 0

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

@@ -72,7 +72,7 @@ uninstall_openclaw() {
   log_info "Uninstalling OpenClaw..."
   mkdir -p "$(dirname "$LOG_FILE")"
 
-  loading "Removing OpenClaw" _uninstall_openclaw_impl
+  loading "Removing OpenClaw" _uninstall_openclaw_impl || return 1
 
   log_success "OpenClaw uninstalled"
   return 0

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

@@ -67,7 +67,7 @@ uninstall_pi() {
   log_info "Uninstalling Pi Coding Agent..."
   mkdir -p "$(dirname "$LOG_FILE")"
 
-  loading "Removing Pi Coding Agent" _uninstall_pi_impl
+  loading "Removing Pi Coding Agent" _uninstall_pi_impl || return 1
 
   log_success "Pi uninstalled"
   return 0

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

@@ -259,10 +259,10 @@ uninstall_qoder() {
 
   if [ ! -f "$PREFIX/bin/qodercli" ]; then
     log_warn "Qoder is not installed"
-    return 1
+    return 2
   fi
 
-  loading "Uninstalling Qoder" _uninstall_qoder_impl
+  loading "Uninstalling Qoder" _uninstall_qoder_impl || return 1
 }
 
 _uninstall_qoder_impl() {

package/karnel/tools/ai/qwen-code/install.sh

@@ -71,7 +71,7 @@ uninstall_qwen_code() {
   log_info "Uninstalling Qwen Code..."
   mkdir -p "$(dirname "$LOG_FILE")"
 
-  loading "Removing Qwen Code" _uninstall_qwen_code_impl
+  loading "Removing Qwen Code" _uninstall_qwen_code_impl || return 1
 
   log_success "Qwen Code uninstalled"
   return 0

package/karnel/utils/tools.sh

@@ -13,7 +13,14 @@ _batch_tool_action() {
 
   for tool in "${tools[@]}"; do
     local func_name="${action}_${tool//-/_}"
-    if declare -f "$func_name" &>/dev/null; then
+    if [[ "$module" == "ai" ]] && declare -f _run_ai_tool_action &>/dev/null; then
+      _run_ai_tool_action "$action" "$tool"
+      case $? in
+        0) ((success_count++));;
+        2) ((skipped_count++));;
+        *) ((failed_count++));;
+      esac
+    elif declare -f "$func_name" &>/dev/null; then
       "$func_name"
       case $? in
         0) ((success_count++));;

package/package.json

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