karnel-termux 4.17.6 → 4.17.8

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.17.6-0078D4?style=for-the-badge" alt="Version">
+    <img src="https://img.shields.io/badge/version-4.17.8-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">
@@ -25,9 +25,6 @@
   <a href="https://karneltermux.vercel.app">
     <img src="https://img.shields.io/badge/Site-karneltermux.vercel.app-0078D4?style=for-the-badge" alt="Website">
   </a>
-  <a href="https://www.youtube.com/@capideb">
-    <img src="https://img.shields.io/badge/YouTube-Capi.deb-FF0000?style=for-the-badge&logo=youtube&logoColor=white" alt="YouTube — Capi.deb">
-  </a>
 </p>
 
 ---
@@ -38,7 +35,7 @@ Created by **Israel Marques**.
 
 Core agent contributions by **devcorex**.
 
-- **43 AI tools** — Claude, Gemini, OpenCode, Cactus, Hugging Face, Ollama, KeelCode, Goose, Factory Droid and more
+- **45 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
@@ -64,7 +61,7 @@ Core agent contributions by **devcorex**.
 ### Via checksummed GitHub release (recommended)
 
 ```bash
-version=4.17.6
+version=4.17.8
 tmpdir=$(mktemp -d) && trap 'rm -rf "$tmpdir"' EXIT
 base="https://github.com/israelmarques1024-dotcom/karnel-termux/releases/download/v$version"
 curl -fsSL "$base/karnel-termux-install.sh" -o "$tmpdir/karnel-termux-install.sh"
@@ -115,6 +112,7 @@ aliases, or options; use `karnel help` and the CLI reference for the full set.
 | `karnel brain` | Second brain — memories and search |
 | `karnel env` | Manage environment variables |
 | `karnel voice` | Voice commands for AI agents |
+| `karnel agent` | Local AI assistant — chat (`ask`) and task agent (`run`) |
 | `karnel start editor` | Start code-server (VS Code in browser) |
 | `karnel pg` | PostgreSQL manager |
 | `karnel init <template>` | Initialize projects with templates |
@@ -129,7 +127,7 @@ aliases, or options; use `karnel help` and the CLI reference for the full set.
 |--------|-------------|--------------|
 | `lang` | Node.js, Python, Go, Rust, C/C++, PHP, Perl, Bun | `karnel install lang` |
 | `db` | PostgreSQL, MariaDB, SQLite, MongoDB, Redis | `karnel install db` |
-| `ai` | 43 AI tools, agents, and local inference clients | `karnel install ai` |
+| `ai` | 45 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` |
@@ -273,7 +271,7 @@ See the bundled reference with `karnel show osint --robin`.
 
 ---
 
-## AI Tools (43)
+## AI Tools (45)
 
 ```bash
 karnel install ai                             # Install all
@@ -328,7 +326,9 @@ karnel install ai --opencode --ollama         # Install specific agents
 | **Supercode CLI** | `--supercode-cli` | Supercode CLI — official npm package |
 | **Puter CLI** | `--puter` | Puter CLI for sites and workers |
 | **KeelCode** | `--keelcode` | Hosted coding-agent CLI |
- 
+| **Cactus Needle** | `--cactus-needle` | Lightweight Cactus inference helper |
+| **Walkie Agent** | `--walkie` | Voice-first Walkie AI agent |
+  
 </details>
 
 ---
@@ -357,7 +357,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](docs/doctor/README.md)** for modes,
+Read the **[complete Doctor reference](docs/doctor/index.md)** for modes,
 supported ecosystems, tool coverage, JSON schema, reports, and auto-fix safety.
 
 ---
@@ -513,11 +513,11 @@ Documentation loads from https://karneltermux.vercel.app.
 
 ## Documentation
 
-- [Documentation index](docs/README.md)
-- [CLI reference](docs/cli/README.md)
-- [Doctor reference](docs/doctor/README.md)
-- [Troubleshooting](docs/troubleshooting.md)
-- [Architecture](docs/ARCHITECTURE.md)
+- [Documentation index](docs/index.md)
+- [CLI reference](docs/cli/index.md)
+- [Doctor reference](docs/doctor/index.md)
+- [Troubleshooting](docs/troubleshooting/index.md)
+- [Architecture](docs/ARCHITECTURE/index.md)
 - [Documentation changelog](docs/CHANGELOG.md)
 - [Official website](https://karneltermux.vercel.app)
 
@@ -564,7 +564,7 @@ karnel/
 │   │   └── karnel.sh    # Main CLI (with TUI)
 │   ├── modules/       # Module orchestrators
 │   ├── tools/         # Tool installers
-│   │   ├── ai/        # 43 AI tools
+│   │   ├── ai/        # 45 AI tools
 │   │   ├── lang/      # 8 languages
 │   │   ├── db/        # 5 databases
 │   │   ├── dev/       # 22 dev tools

package/docs/ARCHITECTURE/index.md

@@ -27,7 +27,7 @@ karnel-termux/
 │   │       ├── dev.sh          # Dev tools installer
 │   │       └── ...
 │   ├── tools/                  # Individual tool installers
-│   │   ├── ai/                 # 43 AI tools
+│   │   ├── ai/                 # 45 AI tools
 │   │   ├── lang/               # 8 languages
 │   │   ├── db/                 # 5 databases
 │   │   ├── dev/                # 22 dev tools
@@ -139,4 +139,4 @@ _tool_postinstall() { ... }      # Post-installation setup
 
 ## Doctor Subsystem Architecture
 
-See [Doctor System](./doctor/) for the complete breakdown of the doctor code analysis engine.
+See [Doctor System](../doctor/) for the complete breakdown of the doctor code analysis engine.

package/docs/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Documentation Changelog
 
+## 4.17.7
+
+- Documentation site overhauled: valid `_config.yml`, cayman-compatible custom
+  stylesheet that imports the full theme, a workflow that builds Jekyll before
+  deploying to GitHub Pages, and tool counts reconciled with the actual
+  `karnel/tools/*` and `karnel/tools/ai/*` directories (45 AI tools, 3 editors,
+  8 languages, 5 databases, 22 dev tools, 11 npm packages, 10 shell plugins,
+  4 UI components, 4 deploy CLIs, 6 games, 2 network tools, 12 utility tools,
+  30 security tools, 1 automation tool).
+
 ## 4.16.1 - 2026-08-22
 
 - `karnel agent ask/run`: when the model endpoint is unreachable and Cactus is

package/docs/_config.yml

@@ -1,7 +1,15 @@
 title: Karnel Termux
-description: Modular Dev Environment for Termux — install languages, databases, AI agents, editors, and more with one command.
+description: >-
+  Modular Dev Environment for Termux — install languages, databases, AI agents,
+  editors, and more with one command.
+author: Israel Marques
+lang: en-US
 theme: jekyll-theme-cayman
 markdown: kramdown
+logo: /assets/images/karnel-logo.png
+custom_css: /assets/css/style.css
+baseurl: /karnel-termux
+show_downloads: false
 exclude:
   - vendor
   - Gemfile

package/docs/assets/css/style.scss

@@ -0,0 +1,237 @@
+---
+---
+
+@import "jekyll-theme-cayman";
+
+/* Karnel Termux — custom styling layered on top of jekyll-theme-cayman */
+
+:root {
+  --karnel-bg: #0d1117;
+  --karnel-panel: #161b22;
+  --karnel-border: #30363d;
+  --karnel-accent: #2f81f7;
+  --karnel-accent-2: #0078d4;
+  --karnel-text: #c9d1d9;
+  --karnel-muted: #8b949e;
+  --karnel-code-bg: #161b22;
+}
+
+html {
+  scroll-behavior: smooth;
+}
+
+body {
+  font-size: 16px;
+  line-height: 1.6;
+  color: #24292f;
+}
+
+/* Logo (added in page content; cayman's default.html does not render site.logo) */
+.karnel-logo {
+  display: block;
+  margin: 0 auto 1.25rem;
+  max-width: 220px;
+  height: auto;
+  border-radius: 14px;
+  box-shadow: 0 6px 22px rgba(0, 0, 0, 0.18);
+}
+
+@media (prefers-color-scheme: dark) {
+  body {
+    background: var(--karnel-bg);
+    color: var(--karnel-text);
+  }
+  .page-header {
+    background-image: linear-gradient(120deg, #0078d4, #2f81f7);
+  }
+  .main-content h1,
+  .main-content h2,
+  .main-content h3,
+  .main-content h4 {
+    color: #e6edf3;
+    border-bottom-color: var(--karnel-border);
+  }
+  .main-content a {
+    color: var(--karnel-accent);
+  }
+  .main-content code {
+    color: #e6edf3;
+  }
+}
+
+.page-header {
+  padding: 2.5rem 1rem;
+}
+
+.page-header .project-tagline {
+  opacity: 0.95;
+  font-size: 1.1rem;
+}
+
+/* Landing navigation */
+.karnel-nav {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.6rem;
+  margin: 1.5rem 0 2rem;
+  padding: 0;
+  list-style: none;
+}
+
+.karnel-nav li {
+  margin: 0;
+}
+
+.karnel-nav a {
+  display: inline-block;
+  padding: 0.5rem 1rem;
+  border: 1px solid var(--karnel-accent-2, #0078d4);
+  border-radius: 999px;
+  text-decoration: none;
+  font-weight: 600;
+  font-size: 0.92rem;
+  color: #fff;
+  background: rgba(0, 120, 212, 0.12);
+  transition: background 0.15s ease, transform 0.15s ease;
+}
+
+.karnel-nav a:hover {
+  background: rgba(0, 120, 212, 0.28);
+  transform: translateY(-1px);
+}
+
+@media (prefers-color-scheme: dark) {
+  .karnel-nav a {
+    color: #c9d1d9;
+    border-color: var(--karnel-border);
+  }
+}
+
+/* Tables */
+.main-content table {
+  display: table;
+  width: 100%;
+  border-collapse: collapse;
+  font-size: 0.95rem;
+  margin: 1.5rem 0;
+}
+
+.main-content th,
+.main-content td {
+  border: 1px solid var(--karnel-border, #d0d7de);
+  padding: 0.55rem 0.75rem;
+  text-align: left;
+}
+
+.main-content thead th {
+  background: #f3f5f8;
+  font-weight: 700;
+}
+
+@media (prefers-color-scheme: dark) {
+  .main-content th,
+  .main-content td {
+    border-color: var(--karnel-border);
+  }
+  .main-content thead th {
+    background: var(--karnel-panel);
+    color: #e6edf3;
+  }
+  .main-content tbody tr:nth-child(2n) {
+    background: rgba(255, 255, 255, 0.03);
+  }
+}
+
+/* Code blocks */
+.main-content pre {
+  border-radius: 8px;
+  padding: 1rem 1.1rem;
+  font-size: 0.9rem;
+  line-height: 1.5;
+  overflow: auto;
+}
+
+.main-content code {
+  font-size: 0.88em;
+}
+
+/* Inline code should not be wrapped in its own block styling */
+.main-content p code,
+.main-content li code,
+.main-content td code {
+  background: rgba(120, 120, 120, 0.12);
+  padding: 0.12em 0.4em;
+  border-radius: 4px;
+}
+
+/* Blockquotes */
+.main-content blockquote {
+  border-left: 4px solid var(--karnel-accent-2, #0078d4);
+  background: rgba(0, 120, 212, 0.06);
+  padding: 0.75rem 1rem;
+  color: inherit;
+  border-radius: 0 6px 6px 0;
+}
+
+/* Admonition callouts */
+.karnel-note {
+  border: 1px solid var(--karnel-accent-2, #0078d4);
+  border-left-width: 4px;
+  border-radius: 8px;
+  padding: 0.75rem 1rem;
+  margin: 1.25rem 0;
+  background: rgba(0, 120, 212, 0.06);
+}
+
+/* Section spacing */
+.main-content h2 {
+  margin-top: 2.5rem;
+  padding-bottom: 0.4rem;
+  border-bottom: 1px solid #e1e4e8;
+}
+
+.main-content h3 {
+  margin-top: 1.75rem;
+}
+
+/* Lists of links on the index page */
+.karnel-links {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
+  gap: 0.75rem;
+  margin: 1.5rem 0;
+  padding: 0;
+  list-style: none;
+}
+
+.karnel-links a {
+  display: block;
+  padding: 0.9rem 1rem;
+  border: 1px solid #d0d7de;
+  border-radius: 10px;
+  text-decoration: none;
+  font-weight: 600;
+  color: #24292f;
+  background: #fff;
+  transition: border-color 0.15s ease, box-shadow 0.15s ease;
+}
+
+.karnel-links a:hover {
+  border-color: var(--karnel-accent-2, #0078d4);
+  box-shadow: 0 2px 10px rgba(0, 120, 212, 0.15);
+}
+
+@media (prefers-color-scheme: dark) {
+  .karnel-links a {
+    background: var(--karnel-panel);
+    border-color: var(--karnel-border);
+    color: #e6edf3;
+  }
+}
+
+/* Footer credit spacing */
+.site-footer {
+  margin-top: 2.5rem;
+  border-top: 1px solid #e1e4e8;
+  padding-top: 1rem;
+}

package/docs/cli/index.md

@@ -23,7 +23,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`      | 43 AI tools (OpenCode, Cactus, Hugging Face, Claude Code, KeelCode, Goose, Factory Droid, Ollama, etc.) |
+| `ai`      | 45 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. |
@@ -43,7 +43,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`, `--cactus`, `--hugging-face` |
+| `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` |
 | `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`      | 43 AI tools |
+| `ai`      | 45 AI tools |
 | `editor`  | 3 editor components |
 | `dev`     | 22 development tools |
 | `npm`     | 11 npm global modules |
@@ -340,7 +340,7 @@ karnel robin doctor --network
 karnel robin purge-data --yes
 ```
 
-See the [Robin reference](../../karnel/tools/osint/robin/README.md) for detailed
+See the [Robin reference](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/karnel/tools/osint/robin/README.md) for detailed
 lifecycle, data locations, and troubleshooting.
 
 ---
@@ -512,6 +512,45 @@ karnel ia routes
 
 ---
 
+## agent — Local AI assistant
+
+```bash
+karnel agent <ask|run|config> [options]
+```
+
+| Subcommand | Description |
+|------------|-------------|
+| `ask`  | Streamed AI chat assistant (markdown TUI). With no prompt, opens an interactive chat. |
+| `run`  | Task agent: the LLM answers in a plan/build/execute loop and can run shell commands. |
+| `config` | Show or set the assistant configuration. |
+
+### Options (ask / run)
+
+| Flag | Description |
+|------|-------------|
+| `-p`, `--prompt <text>` | Task or question (omit for interactive mode) |
+| `-m`, `--model <name>` | Model id (default from config) |
+| `-u`, `--endpoint <url>` | OpenAI-compatible endpoint (default from config) |
+| `-t`, `--temperature <n>` | Sampling temperature |
+| `--max-tokens <n>` | Maximum output tokens |
+| `-n`, `--max-iterations <n>` | Agent loop iteration limit (`run`) |
+| `-y`, `--yes` | Auto-approve commands, skip the y/N prompt (`run`) |
+| `-w`, `--workspace <dir>` | Working directory for the task agent (`run`) |
+
+```bash
+karnel agent ask -p "Explain rsync"
+karnel agent ask                       # interactive chat
+karnel agent run -p "create a backup script"
+karnel agent run -p "..." -m gemma-4-e2b-it-cq4 -u http://127.0.0.1:8000/v1
+karnel agent config                    # show current settings
+karnel agent config model gpt-4o        # set the default model id
+```
+
+`karnel agent ask` connects to the configured OpenAI-compatible endpoint; if it is
+unreachable and Cactus is not installed, it offers to install Cactus on the spot.
+
+---
+
 ## init — Project configuration
 
 ```bash

package/docs/index.md

@@ -1,38 +1,45 @@
 # Karnel Termux Documentation
 
+<img class="karnel-logo" src="{{ '/assets/images/karnel-logo.png' | relative_url }}" alt="Karnel Termux">
+
 > Modular Dev Environment for Termux — install languages, databases, AI agents, editors, and more with one command
 
-## Quick Links
+Navigate the docs:
 
-- [CLI Commands](./cli/) — All `karnel` subcommands
-- [Doctor System](./doctor/) — Environment diagnosis and code analysis
-- [Troubleshooting](./troubleshooting/) — Common issues and fixes
-- [Architecture Overview](./ARCHITECTURE/)
-- [Bug Fixes & Changelog](./CHANGELOG.md)
-- [Published Documentation Site](https://israelmarques1024-dotcom.github.io/karnel-termux/)
+<ul class="karnel-nav">
+  <li><a href="./cli/">CLI Commands</a></li>
+  <li><a href="./doctor/">Doctor System</a></li>
+  <li><a href="./troubleshooting/">Troubleshooting</a></li>
+  <li><a href="./ARCHITECTURE/">Architecture</a></li>
+  <li><a href="./CHANGELOG.md">Changelog</a></li>
+  <li><a href="https://israelmarques1024-dotcom.github.io/karnel-termux/">Live Site</a></li>
+</ul>
 
 ## What is Karnel?
 
 Karnel Termux transforms your Android device into a complete development workstation.
-With a single CLI (`karnel`), you can install and manage 43 AI tools, 8 languages,
-5 databases, 22 dev tools, 11 npm packages, 10 shell plugins, 4 UI components,
-4 deploy CLIs, 6 games, 2 network tools, 12 utility tools, 30 security tools,
-responsible OSINT, a second brain, voice commands, and reviewed plugins — all
-from modules: `ai`, `auto`, `db`, `deploy`, `dev`, `editor`, `games`, `lang`,
-`network`, `npm`, `osint`, `security`, `shell`, `ui`, `utils`, `voice`, `plugin`.
+With a single CLI (`karnel`), you can install and manage 45 AI tools, 3 editors,
+8 languages, 5 databases, 22 dev tools, 11 npm packages, 10 shell plugins,
+4 UI components, 4 deploy CLIs, 6 games, 2 network tools, 12 utility tools,
+30 security tools, 1 automation tool, responsible OSINT, a second brain,
+voice commands, and reviewed plugins — all from modules: `ai`, `auto`, `db`,
+`deploy`, `dev`, `editor`, `games`, `lang`, `network`, `npm`, `osint`,
+`security`, `shell`, `ui`, `utils`, `voice`, `plugin`.
 
 ## Sections
 
-- **[CLI Commands](./cli/)** — Full reference for every `karnel` subcommand
-- **[Doctor System](./doctor/)** — How `karnel doctor` works, code analysis engine, environment checks
-- **[Robin OSINT](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/karnel/tools/osint/robin/README.md)** — Responsible use, lifecycle, data locations, and troubleshooting
-- **[Network Tools](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/karnel/tools/network/dark/README.md)** — dark, dedsec-network
-- **[KeelCode](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/karnel/tools/ai/keelcode/README.md)** — Hosted coding-agent CLI: `karnel install ai --keelcode`
-- **[SuperFile](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/karnel/tools/utils/superfile/README.md)** — Terminal file manager: `karnel install utils --superfile`
-- **[Utility Scripts](https://github.com/israelmarques1024-dotcom/karnel-termux/blob/main/karnel/tools/utils/fconv/README.md)** — fconv, notes, treex, SuperFile, passman, applaunch, splash, httptmux, zork, qrcode and more
-- **[Supabase CLI](./cli/#supabase--remote-project-helpers)** — `karnel supabase` remote-project helpers
-- **[Architecture](./ARCHITECTURE/)** — Project structure, module system, import mechanism
-- **[Changelog](./CHANGELOG.md)** — Version history, bug fixes, known issues
+<div class="karnel-links">
+  <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="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="./cli/#supabase--remote-project-helpers">Supabase CLI — remote-project helpers</a>
+  <a href="./ARCHITECTURE/">Architecture — project structure and module system</a>
+  <a href="./CHANGELOG.md">Changelog — version history and fixes</a>
+</div>
 
 ## Credits
 

package/karnel/RELEASE_COMMIT

@@ -1 +1 @@
-0b701b2757116687f7022e331187baa382cf63a9
+ad787cd9d5efa67b498b0b1dc5e00203553b32e7

package/karnel/cli/commands/agent.sh

@@ -448,7 +448,7 @@ agent_repl_handle() {
 		;;
 	/model*)
 		local m="${line#/model }"
-		m="${m#/model}"
+		[[ "$m" == "$line" ]] && m=""
 		m=$(echo "$m" | xargs)
 		if [[ -z "$m" ]]; then
 			log_info "Available models:"
@@ -462,7 +462,7 @@ agent_repl_handle() {
 		;;
 	/endpoint*)
 		local e="${line#/endpoint }"
-		e="${e#/endpoint}"
+		[[ "$e" == "$line" ]] && e=""
 		e=$(echo "$e" | xargs)
 		if [[ -z "$e" ]]; then agent_read_input "Endpoint URL (e.g. http://127.0.0.1:8000/v1)" e; fi
 		if [[ -z "$e" ]]; then return 0; fi
@@ -472,7 +472,7 @@ agent_repl_handle() {
 		;;
 	/temp*)
 		local t="${line#/temp }"
-		t="${t#/temp}"
+		[[ "$t" == "$line" ]] && t=""
 		t=$(echo "$t" | xargs)
 		if [[ -z "$t" ]]; then agent_read_input "Temperature (0-2)" t; fi
 		if [[ -n "$t" ]]; then AGENT_TEMPERATURE="$t"; log_success "Temperature → ${D_CYAN}$AGENT_TEMPERATURE${D_NC}"; fi
@@ -480,7 +480,7 @@ agent_repl_handle() {
 		;;
 	/max*)
 		local mx="${line#/max }"
-		mx="${mx#/max}"
+		[[ "$mx" == "$line" ]] && mx=""
 		mx=$(echo "$mx" | xargs)
 		if [[ -z "$mx" ]]; then agent_read_input "Max tokens" mx; fi
 		if [[ -n "$mx" ]]; then AGENT_MAX_TOKENS="$mx"; log_success "Max tokens → ${D_CYAN}$AGENT_MAX_TOKENS${D_NC}"; fi
@@ -488,9 +488,8 @@ agent_repl_handle() {
 		;;
 	/workspace*)
 		local ws="${line#/workspace }"
-		ws="${ws#/workspace}"
+		[[ "$ws" == "$line" ]] && ws=""
 		ws=$(echo "$ws" | xargs)
-		if [[ -z "$ws" ]]; then agent_read_input "Workspace directory (absolute path)" ws; fi
 		if [[ -n "$ws" ]]; then
 			mkdir -p "$ws"
 			AGENT_WORKSPACE="$ws"

package/karnel/cli/commands/brain.sh

@@ -163,8 +163,9 @@ _brain_remove_related() {
 	head -n $((frontmatter_end - 1)) "$file" >"$tmp"
 	local escaped
 	escaped=$(_brain_slug_escape "$slug")
-	sed -i "s/related: \[\(.*\)$escaped\(.*\)\]/related: [\1\2]/" "$tmp"
-	sed -i 's/related: \[, */related: [/; s/, *, */, /g; s/related: \[ *\]//' "$tmp"
+	# Only touch the `related:` line, and only strip the slug as a discrete
+	# comma-separated token (never as a substring inside another slug).
+	sed -i "/^related:/ s/, ${escaped}//g; s/${escaped}, //g; s/\[${escaped}\]/[]/g; s/\[, /[/g; s/, \]/]/g" "$tmp"
 	tail -n +$((frontmatter_end)) "$file" >>"$tmp"
 	mv "$tmp" "$file"
 }
@@ -443,7 +444,7 @@ brain_save() {
 					done
 					$already || related_slugs+=("$match_slug")
 				fi
-			done < <(_brain_rg -i "tags:.*$tag" || true)
+			done < <(_brain_rg -l -i "tags:.*$tag" || true)
 		done
 		IFS=$' \t\n'
 
@@ -1296,11 +1297,12 @@ brain_delete() {
 	fi
 
 	# Remove relations from related files
-	local file_slug
+	local file_slug escaped_slug
 	file_slug=$(basename "$file" .md)
+	escaped_slug=$(_brain_slug_escape "$file_slug")
 	while IFS= read -r rfile; do
 		_brain_remove_related "$rfile" "$file_slug"
-	done < <(_brain_rg "$file_slug" || true)
+	done < <(_brain_rg -l "related:.*${escaped_slug}" || true)
 
 	if [[ "$file" != "$BRAIN_DIR"/* ]]; then
 		log_error "Refusing to delete file outside brain directory"

package/karnel/cli/commands/env.sh

@@ -3,13 +3,15 @@
 import "@/utils/log"
 import "@/utils/colors"
 
-# ── Detect rc file: zsh > bash ─────────────────────────────
+# ── Detect rc file based on the ACTIVE shell (not just presence) ──
 _env_rc_file() {
-	if [[ -f "$HOME/.zshrc" ]]; then
-		echo "$HOME/.zshrc"
-	else
-		echo "$HOME/.bashrc"
-	fi
+	local shell_name
+	shell_name=$(basename "${SHELL:-${0:-bash}}" 2>/dev/null)
+	shell_name="${shell_name#-}"   # strip leading '-' from login-shell names (e.g. -bash)
+	case "$shell_name" in
+		zsh) echo "$HOME/.zshrc" ;;
+		*) echo "$HOME/.bashrc" ;;
+	esac
 }
 
 # ── Validate variable name ─────────────────────────────────