karnel-termux 4.9.4 → 4.9.6

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.9.0-0078D4?style=for-the-badge" alt="Version">
+    <img src="https://img.shields.io/badge/version-4.9.6-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">
@@ -44,6 +44,8 @@ Created by **Israel Marques**.
 - **Professional editor** — code-server (VS Code in browser)
 - **Second brain** — Memory system with AI search and idea graph
 - **Voice commands** — Speak to your AI agents
+- **Plugin system** — Install community plugins from GitHub: `karnel plugin install <user/repo>`
+- **Security tools** — Nmap, Hydra, SQLMap, Metasploit and more: `karnel install security`
 
 > [!IMPORTANT]
 > Designed exclusively for **Termux on Android**. Does not work on other platforms.
@@ -125,6 +127,34 @@ karnel
 | `utils` | fconv, notes, treex, 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` | Plugin manager — install extensions from GitHub | `karnel install plugin` |
+| `security` | Nmap, Hydra, SQLMap, Metasploit, Gobuster and more | `karnel install security` |
+
+---
+
+## Plugin System
+
+Extend Karnel with community plugins from GitHub:
+
+```bash
+karnel plugin install <user/repo>   # Install a plugin
+karnel plugin list                  # List installed plugins
+karnel plugin remove <name>         # Uninstall a plugin
+karnel plugin create <name>         # Scaffold a new plugin
+```
+
+Each plugin needs a `karnel-plugin.json` manifest at the root of its repo. Commands go in a `commands/` directory — Karnel discovers them automatically at startup.
+
+## Security Tools
+
+Install security auditing tools:
+
+```bash
+karnel install security                           # Install all
+karnel install security --nmap --hydra --sqlmap    # Install specific ones
+```
+
+Includes: Nmap, Hydra, Nikto, SQLMap, Gobuster, Dirb, WPScan, John the Ripper, Aircrack-ng, Metasploit.
 
 ---
 

package/karnel/cli/commands/brain.sh

@@ -150,7 +150,11 @@ _brain_pick_file() {
 _brain_editor() {
 	local title="$1"
 
-	if ! command -v ${EDITOR:-nano} &>/dev/null; then
+	local editor_bin
+	editor_bin="${EDITOR:-nano}"
+	editor_bin="${editor_bin%% *}"
+
+	if ! command -v "$editor_bin" &>/dev/null; then
 		log_error "${EDITOR:-nano} not found"
 		list_item "Install it: ${D_CYAN}karnel install editor${D_NC}"
 		return 1
@@ -1082,7 +1086,10 @@ brain_edit() {
 	fi
 
 	local editor="${EDITOR:-}"
-	if command -v ${EDITOR:-nano} &>/dev/null; then
+	local editor_bin
+	editor_bin="${EDITOR:-nano}"
+	editor_bin="${editor_bin%% *}"
+	if command -v "$editor_bin" &>/dev/null; then
 		editor="${EDITOR:-nano}"
 	elif [[ -z "$editor" ]] || ! command -v "$editor" &>/dev/null; then
 		for e in vim nano vi; do

package/karnel/cli/commands/install.sh

@@ -152,6 +152,14 @@ _install_full_module() {
     import "@/modules/utils"
     install_utils
     ;;
+  plugin)
+    import "@/modules/plugin"
+    install_plugin_module
+    ;;
+  security)
+    import "@/modules/security"
+    install_security
+    ;;
   *)
     log_warn "Unknown install target: $target"
     echo "Run 'karnel install' to see available targets"
@@ -806,6 +814,9 @@ _install_specific_tools() {
   utils)
     _batch_tool_action "utils" "install" "${tools[@]}"
     ;;
+  security)
+    _batch_tool_action "security" "install" "${tools[@]}"
+    ;;
   *)
     log_warn "Unknown install target: $module"
     echo "Run 'karnel install' to see available targets"

package/karnel/cli/commands/list.sh

@@ -76,6 +76,14 @@ list_main() {
     utils)
       _list_utils
       ;;
+    plugin)
+      import "@/tools/plugins/install"
+      echo "Installed Plugins:"
+      _list_plugins
+      ;;
+    security)
+      _list_security
+      ;;
     voice)
       _list_voice
       ;;
@@ -523,6 +531,30 @@ _grep_config() {
   fi
 }
 
+# ===== LIST SECURITY =====
+_list_security() {
+  echo
+  box "Security Tools"
+  echo
+  log_info "Available security tools:"
+  echo
+  table_start "Tool" "Install Flag" "Command" "Status"
+  table_row "Nmap" "--nmap" "nmap" "$(_check_cmd "nmap")"
+  table_row "Hydra" "--hydra" "hydra" "$(_check_cmd "hydra")"
+  table_row "Nikto" "--nikto" "nikto" "$(_check_cmd "nikto")"
+  table_row "SQLMap" "--sqlmap" "sqlmap" "$(_check_cmd "sqlmap")"
+  table_row "Gobuster" "--gobuster" "gobuster" "$(_check_cmd "gobuster")"
+  table_row "Dirb" "--dirb" "dirb" "$(_check_cmd "dirb")"
+  table_row "WPScan" "--wpscan" "wpscan" "$(_check_cmd "wpscan")"
+  table_row "John the Ripper" "--john" "john" "$(_check_cmd "john")"
+  table_row "Aircrack-ng" "--aircrack-ng" "aircrack-ng" "$(_check_cmd "aircrack-ng")"
+  table_row "Metasploit" "--metasploit" "msfconsole" "$(_check_cmd "msfconsole")"
+  table_end
+  echo
+  log_info "Install all: ${D_CYAN}karnel install security${NC}"
+  echo
+}
+
 # ===== LIST VOICE =====
 _list_voice() {
   echo

package/karnel/cli/commands/open.sh

@@ -63,6 +63,12 @@ open_main() {
   voice)
     url="$OPEN_BASE_URL/karnel/voice"
     ;;
+  plugin)
+    url="$OPEN_BASE_URL/karnel/plugin"
+    ;;
+  security)
+    url="$OPEN_BASE_URL/karnel/security"
+    ;;
   osint|robin)
     url="$OPEN_BASE_URL/karnel/osint"
     ;;

package/karnel/cli/commands/plugin.sh

@@ -0,0 +1,110 @@
+import "@/tools/plugins/install"
+
+plugin_main() {
+  if [[ $# -eq 0 ]]; then
+    plugin_help
+    return
+  fi
+
+  local subcmd="$1"
+  shift
+
+  case "$subcmd" in
+  install)
+    if [[ $# -lt 1 ]]; then
+      log_error "Usage: karnel plugin install <user/repo>"
+      return 1
+    fi
+    install_plugin "$1"
+    ;;
+  remove|uninstall)
+    if [[ $# -lt 1 ]]; then
+      log_error "Usage: karnel plugin remove <name>"
+      return 1
+    fi
+    uninstall_plugin "$1"
+    ;;
+  update)
+    if [[ $# -lt 1 ]]; then
+      log_error "Usage: karnel plugin update <name>"
+      return 1
+    fi
+    update_plugin "$1"
+    ;;
+  list|ls)
+    _list_plugins
+    ;;
+  create|scaffold)
+    if [[ $# -lt 1 ]]; then
+      log_error "Usage: karnel plugin create <name>"
+      return 1
+    fi
+    _scaffold_plugin "$1"
+    ;;
+  *)
+    log_error "Unknown plugin subcommand: $subcmd"
+    plugin_help
+    return 1
+    ;;
+  esac
+}
+
+plugin_help() {
+  echo
+  box "Plugin Manager"
+  echo
+  log_info "Usage: karnel plugin <subcommand> [options]"
+  echo
+  separator_section "Subcommands"
+  echo
+  printf "    ${D_CYAN}%-20s${NC} %s\n" "install <user/repo>" "Install a plugin from GitHub"
+  printf "    ${D_CYAN}%-20s${NC} %s\n" "remove <name>" "Uninstall a plugin"
+  printf "    ${D_CYAN}%-20s${NC} %s\n" "update <name>" "Update a plugin"
+  printf "    ${D_CYAN}%-20s${NC} %s\n" "list" "List installed plugins"
+  printf "    ${D_CYAN}%-20s${NC} %s\n" "create <name>" "Scaffold a new plugin"
+  echo
+  echo "Plugins are installed from GitHub repos."
+  echo "Each plugin must have a karnel-plugin.json manifest at root."
+  echo
+  separator_section "Examples"
+  echo
+  echo "  karnel plugin install username/my-karnel-plugin"
+  echo "  karnel plugin list"
+  echo "  karnel plugin remove my-karnel-plugin"
+  echo "  karnel plugin create my-plugin"
+}
+
+_scaffold_plugin() {
+  local name="$1"
+  local dir="$(_plugin_dir "$name")"
+
+  if [[ -d "$dir" ]]; then
+    log_error "Plugin '$name' already exists"
+    return 1
+  fi
+
+  mkdir -p "$dir/commands" "$dir/tools"
+
+  cat > "$dir/karnel-plugin.json" <<EOF
+{
+  "name": "$name",
+  "version": "1.0.0",
+  "description": "My Karnel plugin",
+  "commands": ["hello"],
+  "tools": []
+}
+EOF
+
+  cat > "$dir/commands/hello.sh" <<'EOF'
+hello_main() {
+  echo "Hello from plugin '$1'!"
+  echo "Args: $*"
+}
+EOF
+
+  chmod +x "$dir/commands/"*.sh
+  log_success "Plugin '$name' scaffolded at $dir"
+  echo "Edit $dir/karnel-plugin.json to configure"
+  echo "Add commands in $dir/commands/"
+  echo "Run: karnel hello"
+}

package/karnel/cli/commands/reinstall.sh

@@ -143,6 +143,14 @@ _reinstall_full_module() {
     import "@/modules/utils"
     reinstall_utils
     ;;
+  plugin)
+    import "@/modules/plugin"
+    reinstall_plugin_module
+    ;;
+  security)
+    import "@/modules/security"
+    reinstall_security
+    ;;
   *)
     log_warn "Unknown reinstall target: $target"
     echo "Run 'karnel reinstall' to see available targets"

package/karnel/cli/commands/show.sh

@@ -78,7 +78,13 @@ show_main() {
     return
   fi
 
-  local readme_path="$KARNEL_PATH/tools/$module/$tool/README.md"
+  local readme_path
+  readme_path="$(realpath "$KARNEL_PATH/tools/$module/$tool/README.md" 2>/dev/null)"
+
+  if [[ -z "$readme_path" || "$readme_path" != "$KARNEL_PATH/tools/"* ]]; then
+    log_error "No documentation found for $module/$tool"
+    return 1
+  fi
 
   if [[ ! -f "$readme_path" ]]; then
     log_error "No documentation found for $module/$tool"

package/karnel/cli/commands/uninstall.sh

@@ -137,6 +137,14 @@ _uninstall_full_module() {
     import "@/modules/utils"
     uninstall_utils
     ;;
+  plugin)
+    import "@/modules/plugin"
+    uninstall_plugin_module
+    ;;
+  security)
+    import "@/modules/security"
+    uninstall_security
+    ;;
   games)
     import "@/tools/games/all"
     uninstall_all_games

package/karnel/cli/commands/update.sh

@@ -143,6 +143,14 @@ _update_full_module() {
     import "@/modules/utils"
     update_utils
     ;;
+  plugin)
+    import "@/modules/plugin"
+    update_plugin_module
+    ;;
+  security)
+    import "@/modules/security"
+    update_security
+    ;;
   deploy)
     import "@/modules/deploy"
     update_deploy

package/karnel/cli/karnel.sh

@@ -36,16 +36,21 @@ karnel_main() {
 
   local command_file="$KARNEL_PATH/cli/commands/$cmd.sh"
 
-  # verificar si existe el comando
   if [[ -f "$command_file" ]]; then
     import "@/cli/commands/$cmd"
     "${cmd}_main" "$@"
-  else
-    log_error "Command not found: $cmd"
-    echo
-    karnel_help
-    return 1
+    return $?
   fi
+
+  import "@/tools/plugins/install"
+  if _plugin_dispatch "$cmd" "$@"; then
+    return $?
+  fi
+
+  log_error "Command not found: $cmd"
+  echo
+  karnel_help
+  return 1
 }
 
 karnel_help() {
@@ -72,6 +77,7 @@ karnel_help() {
   printf "    ${D_CYAN}%-12s${NC} %s\n" "list" "List available tools in a module"
   printf "    ${D_CYAN}%-12s${NC} %s\n" "open" "Open docs in browser for a module"
   printf "    ${D_CYAN}%-12s${NC} %s\n" "pg" "PostgreSQL database manager"
+  printf "    ${D_CYAN}%-12s${NC} %s\n" "plugin" "Plugin manager — install, list, remove"
   printf "    ${D_CYAN}%-12s${NC} %s\n" "reinstall" "Uninstall + install a module"
   printf "    ${D_CYAN}%-12s${NC} %s\n" "restore" "Restore Termux from a backup"
   printf "    ${D_CYAN}%-12s${NC} %s\n" "robin" "Dark Web OSINT tool (Tor + LLM)"
@@ -109,6 +115,8 @@ karnel_help() {
   printf "    ${D_GREEN}%-10s${NC} %s\n" "npm" "Node.js global npm packages"
   printf "    ${D_GREEN}%-10s${NC} %s\n" "osint" "OSINT Tools (Robin — Dark Web + LLM)"
   printf "    ${D_GREEN}%-10s${NC} %s\n" "network" "Network tools (Dark Web, DedSec Network)"
+  printf "    ${D_GREEN}%-10s${NC} %s\n" "plugin" "Plugin manager — install plugins from GitHub"
+  printf "    ${D_GREEN}%-10s${NC} %s\n" "security" "Nmap, Hydra, Metasploit, SQLMap, Gobuster, etc."
   printf "    ${D_GREEN}%-10s${NC} %s\n" "shell" "ZSH + Oh My Zsh + 10 plugins"
   printf "    ${D_GREEN}%-10s${NC} %s\n" "ui" "Font, Cursor, Extra-keys, Banner"
   printf "    ${D_GREEN}%-10s${NC} %s\n" "voice" "Speech-to-agent via microphone"

package/karnel/modules/plugin.sh

@@ -0,0 +1,34 @@
+install_plugin_module() {
+  separator
+  box "Plugin Manager"
+  separator
+
+  log_info "Plugin system is built-in. No additional installation needed."
+  echo
+  log_info "Installing example plugin..."
+  install_plugin "israelmarques1024-dotcom/karnel-termux" || true
+}
+
+uninstall_plugin_module() {
+  log_info "Plugin system is built-in. Nothing to uninstall."
+}
+
+update_plugin_module() {
+  log_info "Updating all plugins..."
+  mkdir -p "$PLUGINS_DIR"
+  for dir in "$PLUGINS_DIR"/*/; do
+    [[ -d "$dir" ]] || continue
+    local name; name="$(basename "$dir")"
+    update_plugin "$name"
+  done
+}
+
+reinstall_plugin_module() {
+  log_info "Reinstalling all plugins..."
+  mkdir -p "$PLUGINS_DIR"
+  for dir in "$PLUGINS_DIR"/*/; do
+    [[ -d "$dir" ]] || continue
+    local name; name="$(basename "$dir")"
+    reinstall_plugin "$name"
+  done
+}

package/karnel/modules/security.sh

@@ -0,0 +1,22 @@
+install_security() {
+  separator
+  box "Installing Security Tools"
+  separator
+  import "@/tools/security/all"
+  install_all_security
+}
+
+uninstall_security() {
+  import "@/tools/security/all"
+  uninstall_all_security
+}
+
+update_security() {
+  import "@/tools/security/all"
+  update_all_security
+}
+
+reinstall_security() {
+  import "@/tools/security/all"
+  reinstall_all_security
+}

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

@@ -108,15 +108,19 @@ update_engram() {
 }
 
 _update_engram_impl() {
-  export GOPATH="$HOME/.local/go"
-  export GOCACHE="$HOME/.cache/go"
-  export GOMODCACHE="$GOPATH/pkg/mod"
-
-  if ! git -C "$KARNEL_DATA/engram" pull &>>"$LOG_FILE" && go build -C "$KARNEL_DATA/engram/cmd/engram" -o "$PREFIX/bin/engram" &>>"$LOG_FILE"; then
-    log_error "Failed to update Engram"
-    return 1
-  fi
-  return 0
+	export GOPATH="$HOME/.local/go"
+	export GOCACHE="$HOME/.cache/go"
+	export GOMODCACHE="$GOPATH/pkg/mod"
+
+	if ! git -C "$KARNEL_DATA/engram" pull &>>"$LOG_FILE"; then
+		log_error "Failed to pull engram repository"
+		return 1
+	fi
+	if ! go build -C "$KARNEL_DATA/engram/cmd/engram" -o "$PREFIX/bin/engram" &>>"$LOG_FILE"; then
+		log_error "Failed to build Engram"
+		return 1
+	fi
+	return 0
 }
 
 reinstall_engram() {

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

@@ -31,7 +31,10 @@ _install_hermes_agent_impl() {
   if [ -d "$HERMES_DIR/.git" ]; then
     cd "$HERMES_DIR" && git pull
   else
-    git clone https://github.com/NousResearch/hermes-agent.git "$HERMES_DIR"
+    git clone https://github.com/NousResearch/hermes-agent.git "$HERMES_DIR" || {
+      log_error "Failed to clone hermes-agent repository"
+      return 1
+    }
   fi
 
   cd "$HERMES_DIR"

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

@@ -24,10 +24,15 @@ install_kiro() {
 
   # Try the official installer first
   log_info "Running official Kiro installer..."
-  if echo "y" | curl -fsSL https://cli.kiro.dev/install 2>/dev/null | bash 2>>"$LOG_FILE"; then
-    if command -v kiro &>/dev/null || command -v kiro-cli &>/dev/null; then
-      log_success "Kiro installed successfully"
-      return 0
+  local install_script
+  install_script=$(curl -fsSL https://cli.kiro.dev/install 2>/dev/null)
+  if [[ -n "$install_script" ]]; then
+    if echo "y" | bash -s -- <<<"$install_script" 2>>"$LOG_FILE"; then
+      hash -r
+      if command -v kiro &>/dev/null || command -v kiro-cli &>/dev/null; then
+        log_success "Kiro installed successfully"
+        return 0
+      fi
     fi
   fi
 
@@ -93,6 +98,7 @@ for p in d['packages']:
         # Create symlink for convenience
         ln -sf "$PREFIX/bin/kiro-cli" "$PREFIX/bin/kiro"
         rm -rf "$tmpdir"
+        hash -r
         if command -v kiro-cli &>/dev/null || command -v kiro &>/dev/null; then
           log_success "Kiro installed from direct download"
           return 0