karnel-termux 4.17.43 → 4.17.45

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="https://raw.githubusercontent.com/israelmarques1024-dotcom/karnel-termux/main/assets/images/karnel-logo.png" alt="Karnel Termux Logo" width="400">
+  <img src="https://raw.githubusercontent.com/karnel-termuxOFC/karnel-termux/main/assets/images/karnel-logo.png" alt="Karnel Termux Logo" width="400">
 </p>
 
 <p align="center">
@@ -7,8 +7,8 @@
 </p>
 
 <p align="center">
-  <a href="https://github.com/israelmarques1024-dotcom/karnel-termux">
-    <img src="https://img.shields.io/badge/version-4.17.43-0078D4?style=for-the-badge" alt="Version">
+  <a href="https://github.com/karnel-termuxOFC/karnel-termux">
+    <img src="https://img.shields.io/badge/version-4.17.45-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">
@@ -16,7 +16,7 @@
   <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>
-  <a href="https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/LICENSE">
+  <a href="https://github.com/karnel-termuxOFC/karnel-termux/blob/main/LICENSE">
     <img src="https://img.shields.io/badge/license-MIT-0078D4?style=for-the-badge" alt="License">
   </a>
   <a href="https://termux.dev/">
@@ -78,9 +78,9 @@ Why it's great:
 ### Via checksummed GitHub release (recommended)
 
 ```bash
-version=4.17.43
+version=4.17.45
 tmpdir=$(mktemp -d) && trap 'rm -rf "$tmpdir"' EXIT
-base="https://github.com/israelmarques1024-dotcom/karnel-termux/releases/download/v$version"
+base="https://github.com/karnel-termuxOFC/karnel-termux/releases/download/v$version"
 curl -fsSL "$base/karnel-termux-install.sh" -o "$tmpdir/karnel-termux-install.sh"
 curl -fsSL "$base/karnel-termux-install.sh.sha256" -o "$tmpdir/karnel-termux-install.sh.sha256"
 (cd "$tmpdir" && sha256sum -c karnel-termux-install.sh.sha256) && bash "$tmpdir/karnel-termux-install.sh" --ref "v$version"
@@ -250,7 +250,7 @@ optional checksum, and informational capabilities. Native command names and
 plugin-to-plugin command collisions are rejected.
 
 The installed plugin directory is `${XDG_DATA_HOME:-$HOME/.local/share}/karnel-data/plugins`.
-See the [official plugin registry](https://github.com/israelmarques1024-dotcom/karnel-plugins)
+See the [official plugin registry](https://github.com/karnel-termuxOFC/karnel-plugins)
 for schemas, review policy, and safe publication requirements.
 
 ## AI CLIs
@@ -408,7 +408,7 @@ definitions across 68 distinct tool labels. It detects subprojects, executes
 checks in the matching project or subproject directory, preserves command exit status, and writes
 timestamped text reports under `$KARNEL_DATA/doctor_code_reports/`.
 
-Read the **[complete Doctor reference](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/docs/doctor/index.md)** for modes,
+Read the **[complete Doctor reference](https://github.com/karnel-termuxOFC/karnel-termux/blob/main/docs/doctor/index.md)** for modes,
 supported ecosystems, tool coverage, JSON schema, reports, and auto-fix safety.
 
 ---
@@ -565,12 +565,12 @@ Documentation loads from https://karneltermux.vercel.app.
 
 ## Documentation
 
-- [Documentation index](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/docs/index.md)
-- [CLI reference](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/docs/cli/index.md)
-- [Doctor reference](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/docs/doctor/index.md)
-- [Troubleshooting](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/docs/troubleshooting/index.md)
-- [Architecture](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/docs/ARCHITECTURE/index.md)
-- [Documentation changelog](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/docs/CHANGELOG.md)
+- [Documentation index](https://github.com/karnel-termuxOFC/karnel-termux/blob/main/docs/index.md)
+- [CLI reference](https://github.com/karnel-termuxOFC/karnel-termux/blob/main/docs/cli/index.md)
+- [Doctor reference](https://github.com/karnel-termuxOFC/karnel-termux/blob/main/docs/doctor/index.md)
+- [Troubleshooting](https://github.com/karnel-termuxOFC/karnel-termux/blob/main/docs/troubleshooting/index.md)
+- [Architecture](https://github.com/karnel-termuxOFC/karnel-termux/blob/main/docs/ARCHITECTURE/index.md)
+- [Documentation changelog](https://github.com/karnel-termuxOFC/karnel-termux/blob/main/docs/CHANGELOG.md)
 - [Official website](https://karneltermux.vercel.app)
 
 ---

package/docs/CHANGELOG.md

@@ -6,6 +6,113 @@ layout: base
 
 # Documentation Changelog
 
+## 4.17.45
+
+- **npm on a real Termux host:** every npm call goes through `karnel_npm()`, which runs npm through `node` when its `#!/usr/bin/env node` shebang cannot be executed (Termux ships no `/usr`, so the kernel answered `bad interpreter`) and retries with `--force` only on `EBADPLATFORM`. The remaining bare `npm install/uninstall/update/view/ls` calls in the installers were converted; guests inside proot keep plain npm.
+- **Installers that could never succeed:** wpscan and wafw00f read their recorded backend with a redirection-only command (`< file`) that prints nothing, so update and uninstall always failed; KeelCode validated the base package digest instead of the `linux-arm64` release it actually downloads; Cline, Command Code, Copilot Termux and Walkie repaired the shebang on the failure branch, leaving the installed binary unrunnable.
+- **Stub detection:** `karnel_is_stub_binary()` replaces a word-list heuristic that reported real CLIs (`supercode`, `python-config`) as offline placeholders right after a successful install.
+- **Test harness:** `run_test` runs the body under `set -e` so intermediate failures surface. This exposed a Turbopack contract that always failed on the x86_64 CI runner, a Kilo Code install aborted by a `tar` stub and an Odysseus uninstall that had to assert its refusal explicitly.
+- **Output noise:** the version spinner probes `/dev/tty` for real instead of trusting `-c`, which passed without a controlling terminal and leaked `No such device or address` into every `karnel update`.
+
+## 4.17.44
+
+- **CLI correctness:** `karnel search` builds its catalog from tool READMEs in one pass instead of per-directory subshells; `karnel stats` counts modules that actually carry install markers and prints `not installed` instead of empty probes; `karnel open` gained routes for `doctor`, `brain`, `pg`, `init`, `env`, `backup`, `show`, `cleanup`, `supabase`, `linux`, `plugin`, `voice`, `security`, `osint`, `termux`, `termux-api` and `terms`.
+- **Confirmation safety:** `--auto` now takes the safe answer on destructive prompts instead of answering `y`, and the agent declines to run code unless `-y`/`AGENT_YES` says so explicitly; doctor's dangerous fixes require `-t 0` and a non-auto run.
+- **Installer method selection:** menus only list methods that can succeed — AMP Code, Codebuff, MiMo Code and Antigravity CLI no longer offer a proot entry that always failed, and Antigravity's proot install/update refuse before provisioning or mutating a container.
+- **Installer fixes:** Freebuff repairs the npm shebang after a successful install instead of inside the failure branch; Claude Code and OpenCode no longer call a host-only shebang helper inside the Ubuntu container; the doctor markdownlint entry no longer passes a nonexistent `--no-missiglob` flag.
+- **Ownership and stats:** central ownership covers 96 of 166 tools (was 61), modules write install markers on success, and security installers keep their per-package ownership intact.
+- **Packaging:** `pack:check` normalizes modes from the git index on a real filesystem (shared storage masks every mode to 0660), asserts the CLI entry point ships executable, and `npm run release` publishes the validated tarball.
+- **Links and data safety:** Zork downloads over HTTP with pinned SHA-256 digests because the host's TLS does not validate; dead `karnelroute.online` references were dropped and GitHub Pages links now name the Vercel production site as canonical.
+- **Banner portability:** `banner.sh` keys its colour, figlet and tip tables as associative arrays so bash and zsh draw the same picture (zsh was losing the left border and shifting the gradient), resolves `KARNEL_VERSION` from `package.json` instead of always showing `v4.x`, draws the text logo as valid UTF-8 at the exact terminal width, caches per width for the `clear()` override, bounds the tip picker and restores the caller's traps.
+- **List coverage:** every group exposes the same `Install Flag`/`Status` columns, `karnel list plugins` is accepted, the TUI counts installers at runtime instead of advertising a stale `AI Tools (43)`, and dialog menus/checklists show the whole list (they used to render half and a third of it, which hid lower entries such as Walkie).
+- **Installer exit codes:** KeelCode and Supercode CLI now capture npm's exit status instead of a `rc` that was always zero, and repair the shebang only after a successful install.
+- **Regression tests:** `tests/list-coverage.sh` proves all 17 targets list all 166 installers, `tests/banner.sh` renders in bash and zsh at the exact width as valid UTF-8, and the site catalog is checked against the CLI registries.
+- **Housekeeping:** removed 11 unreferenced `.proot` wrapper templates, `gga/termux.patch`, `cline/helper/cline_helper.c` and `assets/banner/banner.txt`; restored 16 files deleted from the site worktree; `lint:shell` no longer depends on how the suite was invoked.
+
+## 4.17.43
+
+- Added `stats` to the bash and zsh completion catalogs.
+
+## 4.17.42
+
+- **Audit fixes:** `$module` vs `$target` in `reinstall` for full security/deploy reinstalls; games routed through the module layer for consistent headers and error handling; security module gained separator/box/log feedback; `ia.sh` hardcoded paths now respect `KARNEL_DATA`; the default `LOG_FILE` moved off `install_ai.log`; `upgrade` captures the cleanup exit code.
+
+## 4.17.41
+
+- Version references bumped to `4.17.41`.
+
+## 4.17.40
+
+- **Deduplication:** extracted `pkg-tool.sh` (14 security tools) and a `module-lifecycle.sh` factory (4 modules), converting deploy, games, network, utils and 14 pkg-only security installers to them — roughly 700 lines of duplicated boilerplate removed.
+
+## 4.17.39
+
+- **Plugins:** `karnel plugin enable|disable <name>` and `karnel plugin config <name> [key] [value]`; metadata tracks enabled state (default `true`) and a config object; disabled plugins are skipped by command collection and tagged in listings.
+
+## 4.17.38
+
+- **Installer consistency:** 129 `reinstall_*` functions now check the uninstall return code; 13 AI tools gained the Termux shebang repair they were missing.
+
+## 4.17.37
+
+- **Installer bugs:** nine utils tools logged to `install_dev.log` instead of `install_utils.log`; 14 security pkg uninstallers silently ignored failures; the opencode uninstall `sed` pattern mangled unrelated `.bashrc` lines.
+
+## 4.17.36
+
+- **Managed lifecycle:** netlify, vercel, masscan and metasploit installers preserve managed files, and `utils/env.sh` hardened the environment they run in.
+
+## 4.17.35
+
+- **Ownership hardening:** `update.sh` and the amass, burpsuite, ffuf, gobuster and subfinder installers refuse to touch installs Karnel does not own.
+
+## 4.17.34
+
+- **Auto mode:** added non-interactive `--auto` (`read_confirm` gained an auto answer, `agent_actions` participates) with matching completion entries and tests.
+
+## 4.17.33
+
+- **Supply chain:** hardened release downloads across installers.
+
+## 4.17.32
+
+- **Supply chain:** GitHub release asset digests are verified before install.
+
+## 4.17.31
+
+- **Docs:** README synchronized with the current AI catalog.
+
+## 4.17.30
+
+- **10Router:** repaired Termux shebangs on already-installed 10Router CLIs.
+
+## 4.17.29
+
+- **10Router:** added the 10Router AI server CLI to the AI catalog, registry and completions.
+
+## 4.17.28
+
+- **QR Code:** resolved launcher symlinks.
+
+## 4.17.27
+
+- **QR Code:** isolated dependency tests.
+
+## 4.17.26
+
+- **QR Code:** stabilized release validation.
+
+## 4.17.25
+
+- **QR Code:** covered installer dependencies in tests.
+
+## 4.17.24
+
+- **QR Code:** made QR code installation Termux-safe.
+
+## 4.17.23
+
+- **Tool installation:** repaired the Termux tool installation runtime across doctor, AI installers and the npm module.
+
 ## 4.17.22
 
 - **Data safety and correctness (8):** restore rejects ambiguous multiple archives; Brain preserves same-day title collisions, uses file paths for AI context, initializes/pushes `main`, detects missing `origin`, and supports editors with arguments; PostgreSQL backup filenames are path-safe; AI-session persistence escapes JSON correctly.

package/docs/_layouts/base.html

@@ -9,7 +9,7 @@ layout: default
   <a href="{{ '/troubleshooting/' | relative_url }}">Troubleshooting</a>
   <a href="{{ '/ARCHITECTURE/' | relative_url }}">Architecture</a>
   <a href="{{ '/CHANGELOG/' | relative_url }}">Changelog</a>
-  <a href="https://github.com/israelmarques1024-dotcom/karnel-termux">GitHub</a>
+  <a href="https://github.com/karnel-termuxOFC/karnel-termux">GitHub</a>
 </nav>
 
 {{ content }}

package/docs/cli/index.md

@@ -349,7 +349,7 @@ karnel robin doctor --network
 karnel robin purge-data --yes
 ```
 
-See the [Robin reference](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/karnel/tools/osint/robin/README.md) for detailed
+See the [Robin reference](https://github.com/karnel-termuxOFC/karnel-termux/blob/main/karnel/tools/osint/robin/README.md) for detailed
 lifecycle, data locations, and troubleshooting.
 
 ---

package/docs/index.md

@@ -37,11 +37,11 @@ Open its docs with `karnel open herdr`.
   <a href="./cli/">CLI Commands — full reference for every <code>karnel</code> subcommand</a>
   <a href="./doctor/">Doctor System — environment checks and the code-analysis engine</a>
   <a href="./troubleshooting/">Troubleshooting — common issues and fixes</a>
-  <a href="https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/karnel/tools/osint/robin/README.md">Robin OSINT — responsible use, lifecycle, data locations</a>
-  <a href="https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/karnel/tools/network/dark/README.md">Network Tools — dark, dedsec-network</a>
-  <a href="https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/karnel/tools/ai/keelcode/README.md">KeelCode — hosted coding-agent CLI</a>
-  <a href="https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/karnel/tools/utils/superfile/README.md">SuperFile — terminal file manager</a>
-  <a href="https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/karnel/tools/utils/fconv/README.md">Utility Scripts — fconv, notes, treex, and more</a>
+  <a href="https://github.com/karnel-termuxOFC/karnel-termux/blob/main/karnel/tools/osint/robin/README.md">Robin OSINT — responsible use, lifecycle, data locations</a>
+  <a href="https://github.com/karnel-termuxOFC/karnel-termux/blob/main/karnel/tools/network/dark/README.md">Network Tools — dark, dedsec-network</a>
+  <a href="https://github.com/karnel-termuxOFC/karnel-termux/blob/main/karnel/tools/ai/keelcode/README.md">KeelCode — hosted coding-agent CLI</a>
+  <a href="https://github.com/karnel-termuxOFC/karnel-termux/blob/main/karnel/tools/utils/superfile/README.md">SuperFile — terminal file manager</a>
+  <a href="https://github.com/karnel-termuxOFC/karnel-termux/blob/main/karnel/tools/utils/fconv/README.md">Utility Scripts — fconv, notes, treex, and more</a>
   <a href="./cli/#supabase--remote-project-helpers">Supabase CLI — remote-project helpers</a>
   <a href="./CHANGELOG/">Changelog — version history and fixes</a>
 </div>

package/docs/karnel/ai/index.md

@@ -12,6 +12,6 @@ AI coding agents and assistants (Claude Code, Codex, Cline, Goose, and many more
 | `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`, `--cactus-needle`, `--walkie`, `--hugging-face` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#ai) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/ai.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/ai.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/auto/index.md

@@ -12,6 +12,6 @@ Automation and workflow tooling (n8n).
 | `auto`    | `--n8n` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#auto) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/auto.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/auto.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/db/index.md

@@ -12,6 +12,6 @@ Databases such as PostgreSQL, MongoDB, Redis and companions.
 | `db`      | `--postgresql`, `--mariadb`, `--sqlite`, `--mongodb`, `--redis` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#db) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/db.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/db.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/deploy/index.md

@@ -12,6 +12,6 @@ Deploy CLIs (Railway, Netlify, Vercel, Supabase).
 | `deploy`  | `--vercel`, `--railway`, `--netlify`, `--supabase` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#deploy) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/deploy.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/deploy.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/dev/index.md

@@ -12,6 +12,6 @@ General development utilities (fzf, bat, make, proot, tmux, and more).
 | `dev`     | `--gh`, `--wget`, `--curl`, `--lsd`, `--bat`, `--proot`, `--ncurses`, `--tmate`, `--openssh`, `--tmux`, `--cloudflared`, `--translate`, `--html2text`, `--jq`, `--bc`, `--tree`, `--fzf`, `--imagemagick`, `--shfmt`, `--make`, `--udocker`, `--snyk` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#dev) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/dev.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/dev.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/editor/index.md

@@ -12,6 +12,6 @@ Terminal and browser-based editors (code-server, Neovim, and more).
 | `editor`  | `--code-server`, `--neovim`, `--nvchad` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#editor) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/editor.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/editor.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/games/index.md

@@ -12,6 +12,6 @@ Terminal games to relax between sessions.
 | `games`   | `--buzz`, `--ctfgod`, `--detective`, `--pet-friends`, `--tamagotchi`, `--arcade` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#games) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/games.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/games.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/lang/index.md

@@ -12,6 +12,6 @@ Programming-language runtimes (Python, Node.js, Rust, Go, and more).
 | `lang`    | `--bun`, `--nodejs`, `--python`, `--perl`, `--php`, `--rust`, `--clang`, `--golang` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#lang) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/lang.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/lang.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/network/index.md

@@ -12,6 +12,6 @@ Network utilities (dark, dedsec-network).
 | `network` | `--dark`, `--dedsec-network` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#network) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/network.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/network.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/npm/index.md

@@ -12,6 +12,6 @@ Node.js packages and JavaScript tooling.
 | `npm`     | `--typescript`, `--nestjs`, `--prettier`, `--live-server`, `--localtunnel`, `--vercel`, `--markserv`, `--psqlformat`, `--ncu`, `--ngrok`, `--turbopack` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#npm) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/npm.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/npm.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/osint/index.md

@@ -12,6 +12,6 @@ OSINT tooling, centered on Robin.
 | `osint`   | Robin OSINT |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#osint) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/osint.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/osint.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/plugin/index.md

@@ -12,6 +12,6 @@ The plugin system and manager.
 | `plugin`         | Plugin system |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#plugin) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/plugin.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/plugin.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/security/index.md

@@ -12,6 +12,6 @@ Security and pentest tooling (30 tools).
 | `security`       | Security tools |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#security) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/security.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/security.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/shell/index.md

@@ -12,6 +12,6 @@ Shell enhancements (ZSH, Oh My Zsh, zoxide).
 | `shell`   | `--powerlevel10k`, `--zsh-defer`, `--zsh-autosuggestions`, `--zsh-syntax-highlighting`, `--history-substring`, `--zsh-completions`, `--fzf-tab`, `--you-should-use`, `--zsh-autopair`, `--better-npm` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#shell) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/shell.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/shell.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/ui/index.md

@@ -12,6 +12,6 @@ Termux UI components.
 | `ui`      | `--font`, `--extra-keys`, `--cursor`, `--banner` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#ui) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/ui.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/ui.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/utils/index.md

@@ -16,6 +16,6 @@ and tracked with Karnel ownership markers so `karnel uninstall utils --herdr` is
 | `utils`   | `--fconv`, `--filecheck`, `--websites`, `--notes`, `--treex`, `--passman`, `--applaunch`, `--splash`, `--httptmux`, `--zork`, `--qrcode`, `--superfile`, `--herdr` |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#utils) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/utils.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/utils.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/karnel/voice/index.md

@@ -12,6 +12,6 @@ Voice commands for AI agents.
 | `voice`          | Voice command |
 
 See the [CLI reference]({{ '/cli/' | relative_url }}#voice) for the full command list, or the
-[source on GitHub](https://github.com/israelmarques1024-dotcom/karnel-termux/tree/main/karnel/modules/voice.sh).
+[source on GitHub](https://github.com/karnel-termuxOFC/karnel-termux/tree/main/karnel/modules/voice.sh).
 
 [← Back to docs]({{ '/' | relative_url }}) · [CLI reference]({{ '/cli/' | relative_url }})

package/docs/troubleshooting/index.md

@@ -40,7 +40,7 @@ Create an npm **granular access token** with:
 - **Permissions**: Automation (Bypass 2FA)
 
 Save it as the `NPM_TOKEN` Actions secret in the
-`israelmarques1024-dotcom/karnel-termux` repository. Never paste a token into
+`karnel-termuxOFC/karnel-termux` repository. Never paste a token into
 issues, chat, shell history, or screenshots. If a token is ever exposed,
 revoke it immediately at https://www.npmjs.com/settings/<user>/tokens.
 
@@ -53,13 +53,13 @@ exists and the token used by GitHub Actions has write access.
 
 ## Documentation mirror (GitHub Pages)
 
-The documentation mirror is a Jekyll (cayman theme) site built from the `docs/`
-directory and published to GitHub Pages by the `Publish Docs` workflow
-(`.github/workflows/docs.yml`) on every push to `main` that changes `docs/**`.
-The workflow runs `actions/jekyll-build-pages` (from `docs/`, output to
-`docs/_site`), uploads the result as a Pages artifact, and deploys it to the
-`github-pages` environment. The mirror is
-`https://israelmarques1024-dotcom.github.io/karnel-termux/`.
+The documentation source is the `docs/` directory, and the published site is
+the Vercel production site, `https://karneltermux.vercel.app`. The `Publish Docs`
+workflow (`.github/workflows/docs.yml`) runs `actions/jekyll-build-pages` on
+every push to `main` that changes `docs/**`, uploads the result as a Pages
+artifact and deploys it to the `github-pages` environment; that mirror,
+`https://karnel-termuxOFC.github.io/karnel-termux/`, is served only
+while GitHub Pages is enabled for the repository.
 
 If a build fails, open the Actions run for the failing job and read the Jekyll
 output: the usual causes are invalid `_config.yml` YAML, an SCSS compile error

package/install.sh

@@ -11,7 +11,7 @@ readonly P_FAIL='\e[1;31m'
 readonly P_HL='\e[38;5;213m'
 readonly P_NC='\e[0m'
 
-REPO="https://github.com/israelmarques1024-dotcom/karnel-termux"
+REPO="https://github.com/karnel-termuxOFC/karnel-termux"
 BRANCH="main"
 RELEASE_REF=""
 INSTALL_SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"

package/karnel/RELEASE_COMMIT

@@ -1 +1 @@
-3b64b17a6f9d7a93bcbfbcd7f0c86e858cd5195d
+29fb2632bc7558b002e10d68272418bcb4450cb1

package/karnel/bin/karnel

@@ -36,7 +36,7 @@ set -- "${_karnel_args[@]}"
 
 # Informational flags must not initialize user state or trigger update checks.
 case "${1:-}" in
-  --help|-h|--version|help|version|list|show) KARNEL_READ_ONLY=1 ;;
+  --help|-h|--version|help|version|list|show|search|stats|status) KARNEL_READ_ONLY=1 ;;
 esac
 
 # cargar entorno
@@ -90,7 +90,7 @@ check_for_updates() {
     fi
     if ! _valid_semver "$remote_version"; then
       remote_version=""
-      if remote_output=$(curl -fsSL --max-time 5 "https://raw.githubusercontent.com/israelmarques1024-dotcom/karnel-termux/main/package.json" 2>/dev/null); then
+      if remote_output=$(curl -fsSL --max-time 5 "https://raw.githubusercontent.com/karnel-termuxOFC/karnel-termux/main/package.json" 2>/dev/null); then
         remote_version=$(printf '%s\n' "$remote_output" | sed -nE 's/^[[:space:]]*"version":[[:space:]]*"([^"]+)".*/\1/p' | head -1)
       fi
     fi

package/karnel/cli/commands/agent.sh

@@ -115,7 +115,7 @@ agent_main() {
 		log_error "Unknown subcommand: ${D_CYAN}$cmd${D_NC}"
 		echo
 		agent_help
-		exit 1
+		return 1
 		;;
 	esac
 }

package/karnel/cli/commands/brain.sh

@@ -1122,7 +1122,7 @@ brain_skill() {
 	local skill_dir="$base_dir/$skill_name"
 	if [[ -d "$skill_dir" ]]; then
 		log_warn "Skill already exists: $skill_dir"
-		read_confirm "Overwrite?" confirm
+		read_confirm "Overwrite?" confirm n
 		[[ "$confirm" != "y" ]] && return 0
 		rm -rf "$skill_dir"
 	fi
@@ -1294,7 +1294,7 @@ brain_delete() {
 	title=$(_brain_title "$file")
 	echo
 	log_warn "Delete memory: ${D_CYAN}$title${D_NC}?"
-	read_confirm "This cannot be undone" confirm
+	read_confirm "This cannot be undone" confirm n
 	if [[ "$confirm" != "y" ]]; then
 		log_info "Cancelled"
 		return 0
@@ -1344,7 +1344,7 @@ brain_reset() {
 	list_item "Location: ${D_CYAN}$BRAIN_DIR${D_NC}"
 	echo
 
-	read_confirm "Are you sure?" confirm
+	read_confirm "Are you sure?" confirm n
 	if [[ "$confirm" != "y" ]]; then
 		log_info "Cancelled"
 		separator

package/karnel/cli/commands/cleanup.sh

@@ -63,7 +63,8 @@ cleanup_main() {
   fi
 
   # karnel banner cache (regenerate)
-  rm -f "$KARNEL_CACHE/banner_cache" 2>/dev/null
+  # The cache is keyed by terminal width (banner_cache.<cols>).
+  rm -f "$KARNEL_CACHE"/banner_cache* 2>/dev/null
   rm -f "$KARNEL_CACHE/.last_tip_index" 2>/dev/null
 
   echo

package/karnel/cli/commands/doctor/code_langs.sh

@@ -13,7 +13,7 @@ _init_lang_tools() {
   LANG_TOOLS["JavaScript:npm_audit"]="npm audit|deps|npm audit --audit-level=high|||native"
   LANG_TOOLS["JavaScript:vitest"]="vitest|test|npx --no-install vitest run|||native"
   LANG_TOOLS["JavaScript:jest"]="jest|test|npx --no-install jest|||native"
-  LANG_TOOLS["JavaScript:markdownlint"]="markdownlint-cli2|docs|npx --no-install markdownlint-cli2 \"**/*.md\" --no-missiglob|npx --no-install markdownlint-cli2 --fix \"**/*.md\"|safe|native"
+  LANG_TOOLS["JavaScript:markdownlint"]="markdownlint-cli2|docs|npx --no-install markdownlint-cli2 \"**/*.md\"|npx --no-install markdownlint-cli2 --fix \"**/*.md\"|safe|native"
 
   # TypeScript
   LANG_TOOLS["TypeScript:tsc"]="tsc|type-check|npx --no-install tsc --noEmit|||native"

package/karnel/cli/commands/doctor/fixes.sh

@@ -13,7 +13,9 @@ _fix_storage() {
 _fix_mkdir() {
   local rc=0
   for dir in "$KARNEL_CONFIG" "$KARNEL_CACHE" "$KARNEL_DATA"; do
-    mkdir -p "$dir" && chmod 755 "$dir" 2>/dev/null || { rc=1; log_warn "Failed to create $dir"; }
+    mkdir -p -m 700 "$dir" 2>/dev/null &&
+      { [[ -d "$dir" && ! -L "$dir" ]] && chmod 700 "$dir"; } ||
+      { rc=1; log_warn "Failed to create $dir"; }
   done
   return $rc
 }
@@ -120,27 +122,12 @@ _fix_symlinks() {
 }
 
 _fix_banner() {
-  local shell_config=""
-  if [[ -f "$HOME/.zshrc" ]]; then
-    shell_config="$HOME/.zshrc"
-  elif [[ -f "$HOME/.bashrc" ]]; then
-    shell_config="$HOME/.bashrc"
-  fi
-  if [[ -z "$shell_config" ]]; then
-    shell_config="$HOME/.zshrc"
-    touch "$shell_config"
-  fi
-  local marker="# ===== Karnel Banner ====="
-  if ! grep -qF "$marker" "$shell_config" 2>/dev/null; then
-    cat >>"$shell_config" <<EOF
-
-$marker
-source "$KARNEL_UTILS/banner.sh"
-render_banner
-EOF
-    return 0
-  fi
-  return 0
+  # Always go through the canonical installer: it writes the full block with
+  # start *and* end markers (plus the zsh precmd hook), which is what the
+  # uninstall path expects. Hand-rolled blocks used to leave `render_banner`
+  # orphaned in .zshrc after an uninstall.
+  import "@/tools/ui/banner/install"
+  install_banner
 }
 
 _fix_ai_install() {