karnel-termux 4.13.5 → 4.13.7

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.5-0078D4?style=for-the-badge" alt="Version">
+    <img src="https://img.shields.io/badge/version-4.13.7-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>
@@ -39,7 +39,7 @@ Created by **Israel Marques**.
 - **22 dev tools** — gh, curl, fzf, bat, lsd, jq, tmux, openssh, snyk and more
 - **11 utility scripts** — fconv, notes, treex, qrcode, zork and more
 - **2 network tools** — dark, dedsec-network
-- **3 deploy CLIs** — Vercel, Railway, Netlify
+- **4 deploy CLIs** — Vercel, Railway, Netlify, Supabase
 - **Responsible OSINT** — Robin v2.8 through Tor with a loopback-only web UI
 - **3 editors** — code-server (VS Code in browser), Neovim, NvChad
 - **Second brain** — Memory system with AI search and idea graph
@@ -104,7 +104,7 @@ karnel
 | `karnel start editor` | Start code-server (VS Code in browser) |
 | `karnel pg` | PostgreSQL manager |
 | `karnel init <template>` | Initialize projects with templates |
-| `karnel deploy` | Deploy projects (Vercel, Railway, Netlify) |
+| `karnel deploy` | Deploy projects (Vercel, Railway, Netlify, Supabase) |
 | `karnel robin` | Manage the Robin OSINT service |
 | `karnel --version` | Show installed version |
 
@@ -115,13 +115,13 @@ 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` |
-| `editor` | code-server (VS Code in browser) | `karnel install editor` |
+| `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` |
 | `shell` | ZSH + Oh My Zsh + 10 plugins | `karnel install shell` |
 | `ui` | Font, cursor, extra-keys, banner | `karnel install ui` |
 | `auto` | Automation with n8n | `karnel install auto` |
-| `deploy` | Vercel, Railway, Netlify | `karnel install deploy` |
+| `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` |
@@ -240,7 +240,7 @@ See the bundled reference with `karnel show osint --robin`.
 
 ---
 
-## AI Agents (37)
+## AI Agents (39)
 
 ```bash
 karnel install ai                             # Install all
@@ -273,7 +273,8 @@ karnel install ai --opencode --ollama         # Install specific agents
 | **Hermes Agent** | `--hermes-agent` | Nous Research self-improving agent |
 | **Kimi Code** | `--kimi-code` | Kimi Code CLI |
 | **Command Code** | `--command-code` | Agent that learns your style |
-| **Freebuff** | `--freebuff` | Free community agent |
+| **Codebuff** | `--codebuff` | Free community coding agent |
+| **Freebuff** | `--freebuff` | Free AI coding agent |
 | **Kilo Code CLI** | `--kilocode-cli` | Native glibc CLI for Termux |
 | **Kiro CLI** | `--kiro` | AWS AI coding assistant |
 | **Crush CLI** | `--crush` | Charm AI agents CLI |
@@ -289,6 +290,8 @@ karnel install ai --opencode --ollama         # Install specific agents
 | **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) |
+| **Supercode CLI** | `--supercode-cli` | Supercode CLI — official npm package |
+| **Puter CLI** | `--puter` | Puter CLI for sites and workers |
  
 </details>
 
@@ -408,17 +411,17 @@ karnel pg shell                      # Open psql console
 
 ## karnel init — Project Templates
 
-Create pre-configured projects in seconds:
+Configure existing projects in seconds:
 
 ```bash
-cd my-app && karnel init next         # Next.js + TypeScript + Tailwind
+cd my-next-app && karnel init next    # Next.js + TypeScript + Tailwind
 cd my-api && karnel init express      # Express + TypeORM
 cd backend && karnel init nest        # NestJS + authentication
 ```
 
 | Template | Description |
 |----------|-------------|
-| `next` | Next.js with Turbopack, TypeScript, Tailwind, React Query, Zustand |
+| `next` | Next.js with webpack, TypeScript, Tailwind, React Query, Zustand |
 | `react` | React + Vite with modern structure |
 | `express` | Express API with TypeScript + TypeORM + migrations |
 | `nest` | NestJS with TypeORM and JWT auth |
@@ -433,7 +436,7 @@ cd backend && karnel init nest        # NestJS + authentication
 Manage environment variables securely:
 
 ```bash
-karnel env set OPENAI_API_KEY        # Add key (hidden input)
+karnel env set                       # Add key (hidden input)
 karnel env list                      # List variables
 karnel env ls                        # List variables
 ```
@@ -448,20 +451,20 @@ Deploy your projects directly from terminal:
 karnel deploy vercel                  # Deploy to Vercel
 karnel deploy railway                 # Deploy to Railway
 karnel deploy netlify                 # Deploy to Netlify
+karnel deploy supabase                # Deploy to Supabase
 ```
 
-Platform CLIs are installed automatically.
+Install a platform CLI first with `karnel install deploy --<tool>`.
 
 ---
 
 ## karnel open
 
-Open documentation for any module or tool in browser:
+Open documentation for any module in browser:
 
 ```bash
 karnel open ai                        # Open AI module docs
 karnel open db                        # Open DB module docs
-karnel open ai --opencode             # Open OpenCode docs on site
 ```
 
 Documentation loads from https://karneltermux.vercel.app.

package/karnel/cli/commands/deploy.sh

@@ -15,6 +15,7 @@ deploy_main() {
     list_item "vercel    - Deploy to Vercel"
     list_item "railway   - Deploy to Railway"
     list_item "netlify   - Deploy to Netlify"
+    list_item "supabase  - Deploy to Supabase"
     echo
     log_info "Usage: ${D_CYAN}karnel deploy vercel${NC}"
     echo
@@ -34,6 +35,7 @@ deploy_main() {
     list_item "vercel    - Deploy to Vercel"
     list_item "railway   - Deploy to Railway"
     list_item "netlify   - Deploy to Netlify"
+    list_item "supabase  - Deploy to Supabase"
     echo
     log_info "Usage: ${D_CYAN}karnel deploy vercel${NC}"
     echo
@@ -60,9 +62,16 @@ deploy_main() {
     fi
     exec netlify "${@:2}"
     ;;
+  supabase)
+    if ! command -v supabase &>/dev/null; then
+      log_warn "Supabase CLI not installed. Run: karnel install deploy --supabase"
+      return 1
+    fi
+    exec supabase "${@:2}"
+    ;;
   *)
     log_warn "Unknown deploy tool: $tool"
-    echo "Available: vercel, railway, netlify"
+    echo "Available: vercel, railway, netlify, supabase"
     return 1
     ;;
   esac

package/karnel/cli/commands/doctor.sh

@@ -594,11 +594,20 @@ doctor_termux() {
   separator_section "AI Tools Installed"
   echo
 
-  local -a ai_cmds=("opencode" "claude" "gemini" "codex" "qwen" "vibe" "mimo" "hermes" "kimi" "ollama" "freebuff" "pi" "agy" "mmx" "gentle-ai" "gga" "engram" "codegraph" "kilocode" "kiro" "crush" "odysseus" "openclaude" "openclaw" "command-code" "kimchi" "cline" "omni-route" "ctx7" "openspec" "copilot" "supercode" "puter")
+  local registry_file="$KARNEL_PATH/tools/ai/all.sh"
+  local -a ai_cmds=()
+  local registry_line registry_entry binaries
+  while IFS= read -r registry_line; do
+    registry_entry="${registry_line#*\"}"
+    registry_entry="${registry_entry%\"*}"
+    binaries="${registry_entry##*:}"
+    ai_cmds+=("$binaries")
+  done < <(grep -E '^[[:space:]]*"[^:]+:[^:]+:[^"]+"' "$registry_file")
   local ai_count=0
 
   for cmd in "${ai_cmds[@]}"; do
-    if command -v "$cmd" &>/dev/null; then
+    IFS=, read -r -a binaries <<< "$cmd"
+    if command -v "${binaries[0]}" &>/dev/null || { [[ ${#binaries[@]} -gt 1 ]] && command -v "${binaries[1]}" &>/dev/null; }; then
       log_success "$cmd: installed"
       ((ai_count++))
     fi
@@ -615,14 +624,15 @@ doctor_termux() {
   fi
 
   # Registry consistency check
-  local registry_file="$KARNEL_PATH/tools/ai/all.sh"
   if [[ -f "$registry_file" ]]; then
-    local registered_tools
-    registered_tools=$(grep -cE '^[[:space:]]*"[^:]+:[^:]+:[^"]+"' "$registry_file" 2>/dev/null || echo 0)
+    local registered_tools=${#ai_cmds[@]}
     local installed_ai
     installed_ai=0
     for cmd in "${ai_cmds[@]}"; do
-      command -v "$cmd" &>/dev/null && ((installed_ai++))
+      IFS=, read -r -a binaries <<< "$cmd"
+      if command -v "${binaries[0]}" &>/dev/null || { [[ ${#binaries[@]} -gt 1 ]] && command -v "${binaries[1]}" &>/dev/null; }; then
+        ((installed_ai++))
+      fi
     done
     log_info "AI registry: $registered_tools tools | Installed: $installed_ai"
   fi

package/karnel/cli/commands/ia.sh

@@ -217,6 +217,17 @@ ia_sessions() {
 		done
 	fi
 
+	# Codebuff sessions
+	if [[ -d "$HOME/.codebuff" ]]; then
+		for f in "$HOME/.codebuff"/*.json; do
+			[[ -f "$f" ]] || continue
+			local basename; basename=$(basename "$f")
+			local ts; ts=$(stat -c %Y "$f" 2>/dev/null || echo "unknown")
+			local readable_ts; readable_ts=$(date -d "@$ts" +%Y%m%d_%H%M%S 2>/dev/null || echo "unknown")
+			sessions+=("[codebuff]|$readable_ts|$basename")
+		done
+	fi
+
 	# Freebuff sessions
 	if [[ -d "$HOME/.freebuff" ]]; then
 		for f in "$HOME/.freebuff"/*.json; do
@@ -431,7 +442,7 @@ 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 freebuff kilocode kiro cline crush odysseus kimchi omni-route ctx7 openspec copilot amp cursor omp goose droid supercode puter; do
+	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
 		if command -v "$cmd" &>/dev/null; then
 			local path
 			path=$(command -v "$cmd")

package/karnel/cli/commands/install.sh

@@ -31,6 +31,8 @@ install_main() {
     list_item "deploy     - Deploy CLIs (Vercel, Railway, Netlify, Supabase)"
     list_item "games      - Games (Buzz, CTF God, Detective, etc.)"
     list_item "voice      - Voice command (speech-to-agent)"
+    list_item "plugin     - Install plugins from the official registry"
+    list_item "supabase   - Supabase CLI (types, migrate, functions, secrets)"
     echo
     log_info "Install specific tools with flags:"
     echo

package/karnel/cli/commands/list.sh

@@ -28,6 +28,8 @@ list_main() {
     list_item "utils      - List utility scripts"
     list_item "voice      - List voice commands"
     list_item "osint      - List OSINT tools"
+    list_item "security   - List security tools"
+    list_item "plugin     - List installed plugins"
     echo
     return
   fi
@@ -187,6 +189,7 @@ _list_ai() {
   table_row "Hermes Agent" "--hermes-agent" "hermes" "$(_check_cmd "hermes")"
   table_row "Kimi Code" "--kimi-code" "kimi" "$(_check_cmd "kimi")"
   table_row "Command Code" "--command-code" "command-code" "$(_check_cmd "command-code")"
+  table_row "Codebuff" "--codebuff" "codebuff" "$(_check_cmd "codebuff")"
   table_row "Freebuff" "--freebuff" "freebuff" "$(_check_cmd "freebuff")"
   table_row "Kilo Code CLI" "--kilocode-cli" "kilocode,kilo" "$(_check_cmd_any "kilocode,kilo")"
   table_row "Kiro CLI" "--kiro" "kiro,kiro-cli" "$(_check_cmd_any "kiro,kiro-cli")"
@@ -262,6 +265,8 @@ _list_dev() {
   table_row "Shfmt" "--shfmt" "$(_check_pkg "shfmt")"
   table_row "Make" "--make" "$(_check_pkg "make")"
   table_row "Udocker" "--udocker" "$(_check_pkg "udocker")"
+  table_row "OpenSSH" "--openssh" "$(_check_pkg "openssh")"
+  table_row "Tmux" "--tmux" "$(_check_pkg "tmux")"
   table_row "Snyk" "--snyk" "$(_check_cmd "snyk")"
   table_end
 
@@ -289,7 +294,7 @@ _list_games() {
   table_end
 
   echo
-  log_info "Install specific: ${D_CYAN}karnel install games --buzz --ctf-god${NC}"
+  log_info "Install specific: ${D_CYAN}karnel install games --buzz --ctfgod${NC}"
   log_info "Install all: ${D_CYAN}karnel install games${NC}"
   echo
 }

package/karnel/cli/commands/open.sh

@@ -137,7 +137,6 @@ open_help() {
   printf "    ${D_GREEN}%-14s${NC} ${D_DIM}%s${NC}\n" "osint" "OSINT tools"
   printf "    ${D_GREEN}%-14s${NC} ${D_DIM}%s${NC}\n" "plugin" "Plugin system"
   printf "    ${D_GREEN}%-14s${NC} ${D_DIM}%s${NC}\n" "security" "Security tools"
-  printf "    ${D_GREEN}%-14s${NC} ${D_DIM}%s${NC}\n" "backup" "Backup & Restore"
   echo
 	separator_section "Website"
 	echo

package/karnel/cli/commands/reinstall.sh

@@ -30,6 +30,9 @@ reinstall_main() {
     list_item "deploy     - Reinstall deploy CLIs (Vercel, Railway, Netlify, Supabase)"
     list_item "voice      - Reinstall voice command"
     list_item "osint      - Reinstall OSINT tools"
+    list_item "security   - Reinstall security tools"
+    list_item "plugin     - Reinstall plugins"
+    list_item "supabase   - Reinstall Supabase CLI"
     echo
     log_info "Reinstall specific tools with flags:"
     echo
@@ -166,6 +169,7 @@ _reinstall_full_module() {
   *)
     log_warn "Unknown reinstall target: $target"
     echo "Run 'karnel reinstall' to see available targets"
+    return 1
     ;;
   esac
 }
@@ -271,6 +275,10 @@ _reinstall_specific_tools() {
         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
@@ -291,6 +299,30 @@ _reinstall_specific_tools() {
         reinstall_puter
         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
@@ -819,9 +851,13 @@ _reinstall_specific_tools() {
   utils)
     _batch_tool_action "utils" "reinstall" "${tools[@]}"
     ;;
+  security|deploy)
+    _batch_tool_action "$module" "reinstall" "${tools[@]}"
+    ;;
   *)
     log_warn "Unknown reinstall target: $module"
     echo "Run 'karnel reinstall' to see available targets"
+    return 1
     ;;
   esac
 }

package/karnel/cli/commands/show.sh

@@ -22,7 +22,6 @@ show_main() {
     list_item "karnel show osint --robin"
     list_item "karnel show backup              Show backup docs"
     list_item "karnel show restore             Show restore docs"
-    list_item "karnel show all --<tool>"
 		echo
 		log_info "Run ${D_CYAN}karnel list <module>${NC} to see available tools"
 		echo
@@ -66,15 +65,21 @@ show_main() {
       log_error "Unknown module: $module"
       return 1
     fi
+    local documented_tools=0
     for t in "$tool_dir"/*/; do
       local name="${t%/}"
       name="${name##*/}"
       if [[ -f "$tool_dir/$name/README.md" ]]; then
+        ((documented_tools++))
         local first_line
         first_line=$(head -1 "$tool_dir/$name/README.md" 2>/dev/null)
         printf "    ${D_CYAN}%-16s${NC} %s\n" "$name" "${first_line#\# }"
       fi
     done
+    if [[ $documented_tools -eq 0 ]]; then
+      log_warn "No tool documentation is available for $module"
+      return 1
+    fi
     echo
     log_info "Run ${D_CYAN}karnel show $module --<tool>${NC} for details"
     echo

package/karnel/cli/commands/uninstall.sh

@@ -30,6 +30,9 @@ uninstall_main() {
     list_item "deploy     - Remove deploy CLIs (Vercel, Railway, Netlify, Supabase)"
     list_item "voice      - Remove voice command"
     list_item "osint      - Remove OSINT tools"
+    list_item "security   - Remove security tools"
+    list_item "plugin     - Remove plugins"
+    list_item "supabase   - Remove Supabase CLI"
     echo
     log_info "Uninstall specific tools with flags:"
     echo

package/karnel/cli/commands/update.sh

@@ -29,6 +29,7 @@ update_main() {
     list_item "utils      - Update utility scripts"
     list_item "games      - Update games"
     list_item "deploy     - Update deploy CLIs (Vercel, Railway, Netlify, Supabase)"
+    list_item "supabase   - Update Supabase CLI"
     list_item "voice      - Update voice command"
     list_item "osint      - Update OSINT tools"
     list_item "security   - Update security tools"

package/karnel/cli/commands/voice.sh

@@ -61,7 +61,14 @@ voice_main() {
   # Parse all arguments: flags can appear anywhere
   while [[ $# -gt 0 ]]; do
     case "$1" in
-      --lang) lang="${2:-}"; shift 2 ;;
+      --lang)
+        if [[ -z "${2:-}" || "${2:-}" == -* ]]; then
+          log_error "--lang requires a language code"
+          return 1
+        fi
+        lang="$2"
+        shift 2
+        ;;
       --raw) skip_edit=true; shift ;;
       --no-clip) no_clip=true; shift ;;
       --help|-h) voice_help; return ;;

package/karnel/cli/karnel.sh

@@ -70,9 +70,9 @@ karnel_help() {
   echo
   printf "    ${D_CYAN}%-18s${NC} %s\n" "--version" "Show current version"
   printf "    ${D_CYAN}%-18s${NC} %s\n" "backup [--cron,--cloud,snapshot,list]" "Backup all Termux configs + tools"
-  printf "    ${D_CYAN}%-18s${NC} %s\n" "brain [init,ls,save,search,ask,edit,graph,sync,reset]" "Second brain — save, search, and query memories"
+  printf "    ${D_CYAN}%-18s${NC} %s\n" "brain [subcommand]" "Second brain (run 'karnel brain --help' for commands)"
   printf "    ${D_CYAN}%-18s${NC} %s\n" "cleanup" "Clean caches, logs, and temp files"
-  printf "    ${D_CYAN}%-18s${NC} %s\n" "deploy [vercel,railway,netlify]" "Deploy projects to Vercel, Railway, Netlify"
+  printf "    ${D_CYAN}%-18s${NC} %s\n" "deploy [vercel,railway,netlify,supabase]" "Deploy projects to Vercel, Railway, Netlify, Supabase"
   printf "    ${D_CYAN}%-18s${NC} %s\n" "doctor [termux,code,robin]" "Run diagnostics"
   printf "    ${D_CYAN}%-18s${NC} %s\n" "env [set,unset,list]" "Manage environment variables"
   printf "    ${D_CYAN}%-18s${NC} %s\n" "help" "Show this help screen"
@@ -81,7 +81,7 @@ karnel_help() {
   printf "    ${D_CYAN}%-18s${NC} %s\n" "install <module> [--tool...]" "Install modules and specific tools"
   printf "    ${D_CYAN}%-18s${NC} %s\n" "list [module]" "List available tools in a module"
   printf "    ${D_CYAN}%-18s${NC} %s\n" "open [module]" "Open docs in browser for a module"
-  printf "    ${D_CYAN}%-18s${NC} %s\n" "pg [start,stop,restart,status,init,create,drop,backup,restore,schedule,list,shell]" "PostgreSQL manager"
+  printf "    ${D_CYAN}%-18s${NC} %s\n" "pg <command>" "PostgreSQL manager (run 'karnel pg --help' for commands)"
   printf "    ${D_CYAN}%-18s${NC} %s\n" "plugin [install,update,list,search,remove,create]" "Plugin manager"
   printf "    ${D_CYAN}%-18s${NC} %s\n" "reinstall <module>" "Uninstall + install a module"
   printf "    ${D_CYAN}%-18s${NC} %s\n" "restore [--list,--cloud,<file>]" "Restore Termux from a backup"
@@ -95,12 +95,12 @@ karnel_help() {
   printf "    ${D_CYAN}%-18s${NC} %s\n" "update [module]" "Update modules or framework"
   printf "    ${D_CYAN}%-18s${NC} %s\n" "upgrade" "Upgrade Karnel framework itself"
   printf "    ${D_CYAN}%-18s${NC} %s\n" "version" "Show current version"
-  printf "    ${D_CYAN}%-18s${NC} %s\n" "voice [kilo,opencode,codex,mimocode,openclaude,pi,crush,kiro]" "Speech-to-agent via microphone"
+  printf "    ${D_CYAN}%-18s${NC} %s\n" "voice [agent]" "Speech-to-agent via microphone (run 'karnel voice --help' for agents)"
   echo
   separator_section "Quick Start"
   echo
   list_item "Run: ${D_CYAN}karnel${NC} to see available commands"
-  list_item "Run: ${D_CYAN}karnel open${NC} for official documentation"
+  list_item "Run: ${D_CYAN}karnel open karnel${NC} for official documentation"
   list_item "Run: ${D_CYAN}karnel install <module>${NC} to install modules"
   list_item "Run: ${D_CYAN}karnel backup${NC} to save all configs"
   list_item "Run: ${D_CYAN}karnel restore${NC} to restore"
@@ -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" "38 AI tools (OpenCode, Claude, Ollama, Copilot-Termux, Goose, etc.)"
+   printf "    ${D_GREEN}%-10s${NC} %s\n" "ai" "39 AI tools (OpenCode, Claude, Ollama, Copilot-Termux, 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"
@@ -141,7 +141,7 @@ karnel_help() {
   echo
   list_item "Run ${D_CYAN}karnel <command>${NC} for command-specific help"
   list_item "Example: ${D_CYAN}karnel pg${NC}, ${D_CYAN}karnel init${NC}"
-  list_item "Docs: ${D_CYAN}karnel open${NC} — israel marques 🇧🇷 (12y)"
+  list_item "Docs: ${D_CYAN}karnel open karnel${NC} — israel marques 🇧🇷 (12y)"
   echo
 }
 
@@ -244,19 +244,19 @@ _tui_main_menu() {
       "pg" "PostgreSQL Database Manager" \
       "init" "Project Initializer" \
       "deploy" "Deploy Projects" \
-      "voice" "Speech-to-Agent" \
-      "ia" "AI Agent Manager" \
-      "robin" "Dark Web OSINT" \
-      "supabase" "Supabase CLI Manager" \
+      "voice" "Speech-to-Agent Help" \
+      "ia" "AI Agent Manager Help" \
+      "robin" "Dark Web OSINT Help" \
+      "supabase" "Supabase CLI Help" \
       "doctor" "Run Diagnostics (termux/code)" \
       "search" "Search Tools & Memories" \
-      "show" "Show Tool Documentation" \
+      "show" "Show Documentation Help" \
       "cleanup" "Clean caches and temp files" \
       "status" "Quick System Overview" \
       "upgrade" "Upgrade Karnel Framework" \
-      "update" "Update Karnel" \
-      "reinstall" "Reinstall Modules" \
-      "uninstall" "Remove Modules" \
+      "update" "Update Help" \
+      "reinstall" "Reinstall Help" \
+      "uninstall" "Remove Help" \
       "help" "Show Help Documentation" \
       "exit" "Exit")
     
@@ -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 (37)" \
+    "ai" "AI Agents (39)" \
     "db" "Databases" \
     "lang" "Programming Languages" \
     "editor" "Code Editors" \
@@ -386,8 +386,7 @@ _tui_list_menu() {
     "osint" "OSINT Tools" \
       "voice" "Voice Commands" \
       "plugin" "Plugin System" \
-      "security" "Security Tools" \
-      "supabase" "Supabase CLI" \
+    "security" "Security Tools" \
     "back" "Back to Main Menu")
   local es=$?
   if [[ $es -ne 0 || "$choice" == "back" || -z "$choice" ]]; then
@@ -575,6 +574,11 @@ _tui_brain_menu() {
       "list" "List all memories" \
       "init" "Initialize Brain" \
       "graph" "View memory graph" \
+      "edit" "Edit a memory" \
+      "delete" "Delete a memory" \
+      "show" "View a memory and its relations" \
+      "skill" "Create an AI skill from memories" \
+      "relate" "Link two memories" \
       "sync" "Sync memories" \
       "reset" "Reset / Destroy Brain" \
       "back" "Back to Main Menu")
@@ -595,9 +599,9 @@ _tui_brain_menu() {
           read -r -p "Press Enter to return..." temp
         fi
         ;;
-      save)
+      save|edit|delete|show|skill|relate)
         clear
-        karnel_main "brain" "save"
+        karnel_main "brain" "$sub_choice"
         echo
         read -r -p "Press Enter to return..." temp
         ;;
@@ -690,8 +694,8 @@ _tui_install_menu() {
     target=$(_dialog_menu "Install Modules" "Select target module to install:" \
       "ai" "AI Tools (OpenCode, Claude, Ollama, etc.)" \
       "auto" "Automation Tools (n8n)" \
-      "db" "Databases (PostgreSQL, MariaDB, SQLite, MongoDB)" \
-      "deploy" "Deploy CLIs (Vercel, Railway, Netlify)" \
+      "db" "Databases (PostgreSQL, MariaDB, SQLite, MongoDB, Redis)" \
+      "deploy" "Deploy CLIs (Vercel, Railway, Netlify, Supabase)" \
       "dev" "Development Tools (GitHub CLI, fzf, bat, etc.)" \
       "editor" "Code Editor (code-server)" \
       "games" "Games (Buzz, CTF God, Detective, etc.)" \
@@ -699,9 +703,11 @@ _tui_install_menu() {
       "npm" "Node.js Global npm Packages" \
       "osint" "OSINT Tools (Robin — Dark Web + LLM)" \
       "network" "Network Tools (Dark Web, DedSec Network)" \
+      "security" "Security Tools (Nmap, Hydra, SQLMap, etc.)" \
       "utils" "Utility Scripts (Fconv, Notes, QR Code)" \
       "shell" "ZSH + Oh My Zsh + Plugins" \
       "ui" "Termux UI (font, cursor, extra-keys, banner)" \
+      "plugin" "Plugins from the official registry" \
       "supabase" "Supabase CLI" \
       "voice" "Speech-to-Agent via microphone" \
       "back" "Back to Main Menu")
@@ -750,6 +756,7 @@ _tui_install_checklist() {
         "mariadb" "MariaDB" OFF
         "sqlite" "SQLite" OFF
         "mongodb" "MongoDB" OFF
+        "redis" "Redis" OFF
       )
       ;;
     ai)
@@ -774,6 +781,7 @@ _tui_install_checklist() {
         "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
@@ -819,24 +827,20 @@ _tui_install_checklist() {
         "tmux" "Tmux" OFF
         "openssh" "OpenSSH" OFF
         "snyk" "Snyk" OFF
-        "httptmux" "Httptmux" OFF
-        "zork" "Zork" OFF
-        "fconv" "File Converter" OFF
-        "filecheck" "File Checker" OFF
-        "websites" "Websites Creator" OFF
-        "notes" "Smart Notes" OFF
-        "treex" "Tree Explorer" OFF
-        "passman" "Password Master" OFF
-        "applaunch" "App Launcher" OFF
-        "splash" "Loading Screen" OFF
       )
       ;;
     shell)
       opts=(
-        "zsh" "ZSH shell" OFF
-        "ohmyzsh" "Oh My Zsh" OFF
-        "theme" "Powerlevel10k theme" OFF
-        "plugins" "Plugins (autosuggest, etc.)" OFF
+        "powerlevel10k" "Powerlevel10k" OFF
+        "zsh-defer" "Zsh Defer" OFF
+        "zsh-autosuggestions" "Zsh Autosuggestions" OFF
+        "zsh-syntax-highlighting" "Zsh Syntax Highlighting" OFF
+        "history-substring" "History Substring Search" OFF
+        "zsh-completions" "Zsh Completions" OFF
+        "fzf-tab" "Fzf Tab" OFF
+        "you-should-use" "You Should Use" OFF
+        "zsh-autopair" "Zsh Autopair" OFF
+        "better-npm" "Better NPM" OFF
       )
       ;;
     ui)
@@ -908,6 +912,8 @@ _tui_pg_menu() {
       "drop" "Drop a database" \
       "backup" "Backup a database" \
       "restore" "Restore a database from backup" \
+      "list-backups" "List database backups" \
+      "schedule" "Schedule automatic backups" \
       "shell" "Open psql shell" \
       "back" "Back to Main Menu")
       
@@ -917,7 +923,7 @@ _tui_pg_menu() {
     fi
     
     case "$sub_choice" in
-      status|start|stop|restart|init|list)
+      status|start|stop|restart|init|list|list-backups|schedule)
         clear
         karnel_main "pg" "$sub_choice"
         echo

package/karnel/tools/ai/all.sh

@@ -48,6 +48,7 @@ AI_TOOLS_REGISTRY=(
   "hermes-agent:Hermes Agent:hermes"
   "kimi-code:Kimi Code:kimi"
   "command-code:Command Code:command-code"
+  "codebuff:Codebuff:codebuff"
   "freebuff:Freebuff:freebuff"
   "kilocode-cli:Kilo Code CLI:kilocode,kilo"
   "kiro:Kiro CLI:kiro,kiro-cli"