karnel-termux 0.0.1

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

@@ -0,0 +1,52 @@
+# Freebuff
+
+A 100% free coding agent, right from your terminal
+
+**Package:** freebuff  
+**Author:** israel marques  
+**Repository:** https://github.com/israelmarques1024-dotcom/karnel-termux  
+**Official:** https://freebuff.com
+**Releases:** https://github.com/CodebuffAI/codebuff
+**Type:** AI coding agent (Binary + glibc bootstrapper)  
+**License:** MIT
+
+## Description
+
+Freebuff is the free coding agent: a free CLI coding agent and Freebuff Web, the free way to build full-stack apps. No subscription, no setup, no lock-in. Karnel Termux offers two installation methods: native with glibc support for best performance, or via proot-distro Ubuntu container for maximum compatibility.
+
+## Dependencies
+
+- **Native mode:** glibc-repo, glibc, clang, git, curl, tar
+- **Proot mode:** proot-distro, curl, ca-certificates, tar
+
+## Install
+
+```bash
+karnel install ai --freebuff
+```
+
+You will be prompted to choose:
+
+1. **Native (recommended)** — Compiles a glibc bootstrapper and downloads the latest Freebuff binary from GitHub releases
+2. **Proot-distro (alternative)** — Runs Freebuff inside an Ubuntu proot-distro container
+
+## Uninstall
+
+```bash
+karnel uninstall ai --freebuff
+```
+
+## Update
+
+```bash
+karnel update ai --freebuff
+```
+
+## Notes
+
+- **Native mode** requires `glibc-repo`, `glibc`, `clang`, and other dependencies (installed automatically)
+- The native binary is stored in `~/.local/share/karnel-data/freebuff/`
+- A small C bootstrapper (`freebuff_helper.c`) handles ELF loading via the glibc dynamic linker
+- **Proot mode** uses `proot-distro ubuntu` and downloads the binary directly inside the container
+- Version is fetched automatically from GitHub releases (`CodebuffAI/codebuff-community`)
+- Data directory: `~/.local/share/karnel-data/freebuff/`

package/karnel/tools/ai/freebuff/bin/freebuff

@@ -0,0 +1,28 @@
+#!/data/data/com.termux/files/usr/bin/bash
+
+UBUNTU_ROOTFS="__UBUNTU_ROOTFS__"
+
+EXCLUDE_REGEX="^(PATH|LD_PRELOAD|LD_LIBRARY_PATH|PREFIX|HOME|PWD|OLDPWD|SHELL|IFS|_|SHLVL|PROMPT_COMMAND|TERMCAP|LS_COLORS|TERM)="
+
+ENV_ARGS=()
+while IFS= read -r line; do
+	if [[ -n "$line" && ! "$line" =~ $EXCLUDE_REGEX ]]; then
+		ENV_ARGS+=("--env" "$line")
+	fi
+done < <(env)
+
+ENV_ARGS+=(
+	"--env" "SSL_CERT_FILE=/etc/ssl/certs/ca-certificates.crt"
+	"--env" "TERM=$TERM"
+	"--env" "HOME=/root"
+)
+
+unset LD_PRELOAD
+proot-distro login \
+	"${ENV_ARGS[@]}" \
+	--termux-home \
+	--shared-tmp \
+	--bind "$UBUNTU_ROOTFS/root/.freebuff:/root/.freebuff" \
+	--work-dir $PWD \
+	ubuntu \
+	-- /root/.freebuff/freebuff "$@"

package/karnel/tools/ai/freebuff/helper/freebuff_helper.c

@@ -0,0 +1,47 @@
+#include <stdlib.h>
+#include <unistd.h>
+#include <string.h>
+#include <libgen.h>
+#include <limits.h>
+#include <stdio.h>
+
+int main(int argc, char** argv) {
+    unsetenv("LD_PRELOAD");
+    unsetenv("LD_LIBRARY_PATH");
+
+    setenv("GODEBUG", "netdns=cgo", 1);
+    setenv("SSL_CERT_FILE", "/data/data/com.termux/files/usr/etc/tls/cert.pem", 1);
+
+    char exec_path[PATH_MAX];
+    ssize_t len = readlink("/proc/self/exe", exec_path, sizeof(exec_path) - 1);
+    if (len == -1) {
+        return 1;
+    }
+    exec_path[len] = '\0';
+    char* dir = dirname(exec_path);
+
+    char* loader = "/data/data/com.termux/files/usr/glibc/lib/ld-linux-aarch64.so.1";
+    char real_bin[] = "/data/data/com.termux/files/home/.local/share/karnel-data/freebuff/freebuff";
+    char lib_path[] = "/data/data/com.termux/files/usr/glibc/lib";
+
+    char** new_argv = malloc((argc + 4) * sizeof(char*));
+    if (!new_argv) {
+        return 1;
+    }
+
+    new_argv[0] = loader;
+    new_argv[1] = "--library-path";
+    new_argv[2] = lib_path;
+    new_argv[3] = real_bin;
+
+    for (int i = 1; i < argc; i++) {
+        new_argv[i + 3] = argv[i];
+    }
+    new_argv[argc + 3] = NULL;
+
+    execv(loader, new_argv);
+
+    perror("execv");
+    free(new_argv);
+    return 1;
+}

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

@@ -0,0 +1,303 @@
+#!/usr/bin/env bash
+
+import "@/utils/log"
+import "@/utils/colors"
+
+LOG_FILE="$KARNEL_CACHE/install_ai.log"
+FREEBUFF_DATA_DIR="$HOME/.local/share/karnel-data/freebuff"
+
+_freebuff_detect_ubuntu_root() {
+  local root
+  root="$(find /data/data/com.termux -maxdepth 10 -type d \
+    -name "rootfs" -path "*/containers/ubuntu/*" 2>/dev/null | head -1)"
+
+  if [ -z "$root" ]; then
+    root="$(find /data/data/com.termux -maxdepth 10 -type d \
+      -name "ubuntu" -path "*/installed-rootfs/*" 2>/dev/null | head -1)"
+  fi
+
+  echo "$root"
+}
+
+_freebuff_proot_ubuntu() {
+  proot-distro login \
+    --shared-tmp \
+    ubuntu \
+    -- "$@"
+}
+
+_get_latest_freebuff_version() {
+  curl -fsSL https://api.github.com/repos/CodebuffAI/codebuff-community/releases/latest |
+    grep '"tag_name":' | sed -E 's/.*"freebuff-v([^"]+)".*/\1/'
+}
+
+_freebuff_install_deps_native() {
+  loading "Installing glibc and dependencies" _freebuff_install_deps_native_impl
+}
+
+_freebuff_install_deps_native_impl() {
+  if [[ ! -f $PREFIX/etc/apt/sources.list.d/glibc.list ]]; then
+    if ! pkg install glibc-repo -y &>>"$LOG_FILE"; then
+      log_error "Failed to install glibc-repo"
+      return 1
+    fi
+  fi
+
+  if [[ ! -f $PREFIX/glibc/lib/libc.so.6 ]]; then
+    if ! pkg install glibc -y &>>"$LOG_FILE"; then
+      log_error "Failed to install glibc"
+      return 1
+    fi
+  fi
+
+  declare -A DEPS=(
+    ["git"]="git"
+    ["curl"]="curl"
+    ["tar"]="tar"
+    ["clang"]="clang"
+  )
+
+  local pkg_name bin_name
+  for pkg_name in "${!DEPS[@]}"; do
+    bin_name="${DEPS[$pkg_name]}"
+    if ! command -v "$bin_name" &>/dev/null; then
+      if ! pkg install "$pkg_name" -y &>>"$LOG_FILE"; then
+        log_error "Failed to install $pkg_name"
+        return 1
+      fi
+    fi
+  done
+
+  return 0
+}
+
+_download_freebuff_binary() {
+  loading "Downloading Freebuff" _download_freebuff_binary_impl
+}
+
+_download_freebuff_binary_impl() {
+  local latest_version
+  latest_version=$(_get_latest_freebuff_version)
+  if [ -z "$latest_version" ]; then
+    log_error "Failed to fetch latest Freebuff version"
+    return 1
+  fi
+
+  mkdir -p "$FREEBUFF_DATA_DIR"
+
+  local tarball="freebuff-linux-arm64.tar.gz"
+  local download_url="https://codebuff.com/api/releases/download/$latest_version/$tarball"
+
+  if ! curl -fsSL "$download_url" -o "$FREEBUFF_DATA_DIR/$tarball" &>>"$LOG_FILE"; then
+    log_error "Failed to download Freebuff binary"
+    return 1
+  fi
+
+  if ! tar -zxf "$FREEBUFF_DATA_DIR/$tarball" -C "$FREEBUFF_DATA_DIR" &>>"$LOG_FILE"; then
+    log_error "Failed to extract Freebuff binary"
+    return 1
+  fi
+
+  rm -f "$FREEBUFF_DATA_DIR/$tarball"
+
+  if [ ! -f "$FREEBUFF_DATA_DIR/freebuff" ]; then
+    log_error "Freebuff binary not found after extraction"
+    return 1
+  fi
+
+  chmod +x "$FREEBUFF_DATA_DIR/freebuff"
+  return 0
+}
+
+_compile_freebuff_helper() {
+  loading "Compiling helper" _compile_freebuff_helper_impl
+}
+
+_compile_freebuff_helper_impl() {
+  local HELPER_SRC="$KARNEL_PATH/tools/ai/freebuff/helper/freebuff_helper.c"
+  if [ ! -f "$HELPER_SRC" ]; then
+    log_error "Helper source not found at $HELPER_SRC"
+    return 1
+  fi
+
+  if ! clang -O2 -o "$PREFIX/bin/freebuff" "$HELPER_SRC" &>>"$LOG_FILE"; then
+    log_error "Failed to compile freebuff helper"
+    return 1
+  fi
+
+  chmod +x "$PREFIX/bin/freebuff"
+  return 0
+}
+
+_install_freebuff_native() {
+  _freebuff_install_deps_native || return 1
+  _download_freebuff_binary || return 1
+  _compile_freebuff_helper || return 1
+  log_success "Freebuff installed natively"
+  return 0
+}
+
+_install_freebuff_proot() {
+  loading "Installing Freebuff (proot-distro)" _install_freebuff_proot_impl
+}
+
+_install_freebuff_proot_impl() {
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  if ! command -v proot-distro &>/dev/null; then
+    pkg install proot-distro -y &>>"$LOG_FILE"
+  fi
+
+  if [ ! -d "$(_freebuff_detect_ubuntu_root)" ]; then
+    proot-distro install ubuntu:24.04 &>>"$LOG_FILE"
+  fi
+
+  _freebuff_proot_ubuntu /bin/bash -c \
+    'apt-get update && apt-get upgrade -y && apt-get install -y curl ca-certificates tar' \
+    &>>"$LOG_FILE"
+
+  _freebuff_proot_ubuntu /bin/bash -c '
+    export SHELL=/bin/bash
+    export TMPDIR=/tmp
+    export HOME=/root
+    LATEST=$(curl -fsSL https://api.github.com/repos/CodebuffAI/codebuff-community/releases/latest | grep '"'"'tag_name'"'"' | sed -E '"'"'s/.*"freebuff-v([^"]+)".*/\1/'"'"')
+    TARBALL=$(mktemp /tmp/freebuff.XXXXXX.tar.gz)
+    curl -fsSL "https://codebuff.com/api/releases/download/${LATEST}/freebuff-linux-arm64.tar.gz" -o "$TARBALL"
+    mkdir -p /root/.freebuff
+    tar -zxf "$TARBALL" -C /root/.freebuff
+    rm -f "$TARBALL"
+    chmod +x /root/.freebuff/freebuff
+  ' &>>"$LOG_FILE"
+
+  local ubuntu_root
+  ubuntu_root="$(_freebuff_detect_ubuntu_root)"
+
+  if [ -z "$ubuntu_root" ]; then
+    log_error "Ubuntu rootfs not found"
+    return 1
+  fi
+
+  local freebuff_bin="$ubuntu_root/root/.freebuff/freebuff"
+
+  if [ ! -f "$freebuff_bin" ]; then
+    log_error "Freebuff binary not found after install"
+    return 1
+  fi
+
+  local wrapper_src="$KARNEL_PATH/tools/ai/freebuff/bin/freebuff"
+  if [ ! -f "$wrapper_src" ]; then
+    log_error "Wrapper template not found at $wrapper_src"
+    return 1
+  fi
+  sed "s|__UBUNTU_ROOTFS__|$ubuntu_root|g" "$wrapper_src" >"$PREFIX/bin/freebuff"
+  chmod +x "$PREFIX/bin/freebuff"
+
+  if ! grep -q '.freebuff' "$ubuntu_root/root/.bashrc" 2>/dev/null; then
+    printf '\n# freebuff\nexport PATH=/root/.freebuff:$PATH\n' >>"$ubuntu_root/root/.bashrc"
+  fi
+
+  return 0
+}
+
+install_freebuff() {
+  if command -v freebuff &>/dev/null; then
+    log_info "Freebuff is already installed"
+    return 2
+  fi
+
+  log_info "Installing Freebuff..."
+
+  if [[ -t 0 ]] && [[ -t 1 ]]; then
+    log_info "Select installation method for Freebuff:"
+    read_select "Installation method" SELECTED_METHOD \
+      "Native (recommended) - Compile with glibc support" \
+      "Proot-distro (alternative) - Ubuntu container"
+
+    case "$SELECTED_METHOD" in
+    *Native*)
+      _install_freebuff_native
+      ;;
+    *Proot-distro*)
+      _install_freebuff_proot
+      ;;
+    esac
+  else
+    _install_freebuff_native
+  fi
+}
+
+uninstall_freebuff() {
+  log_info "Uninstalling Freebuff..."
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  if [ ! -f "$PREFIX/bin/freebuff" ]; then
+    log_warn "Freebuff is not installed"
+    return 1
+  fi
+
+  if [ -f "$FREEBUFF_DATA_DIR/freebuff" ]; then
+    rm -f "$PREFIX/bin/freebuff"
+    rm -rf "$FREEBUFF_DATA_DIR"
+    log_success "Freebuff (native) uninstalled"
+    return 0
+  fi
+
+  _freebuff_proot_ubuntu /bin/bash -c 'rm -rf /root/.freebuff' &>>"$LOG_FILE"
+
+  local ubuntu_bashrc
+  ubuntu_bashrc="$(_freebuff_detect_ubuntu_root)/root/.bashrc"
+
+  if [ -f "$ubuntu_bashrc" ]; then
+    sed -i '/# freebuff/d; /export PATH=\/root\/.freebuff/d' "$ubuntu_bashrc"
+  fi
+
+  if rm -f "$PREFIX/bin/freebuff" &>>"$LOG_FILE"; then
+    log_success "Freebuff (proot-distro) uninstalled"
+    return 0
+  else
+    log_error "Failed to uninstall Freebuff"
+    return 1
+  fi
+}
+
+update_freebuff() {
+  log_info "Updating Freebuff..."
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  if [ -f "$FREEBUFF_DATA_DIR/freebuff" ]; then
+    _install_freebuff_native
+    return $?
+  fi
+
+  _freebuff_proot_ubuntu /bin/bash -c 'rm -rf /root/.freebuff' &>>"$LOG_FILE"
+
+  _freebuff_proot_ubuntu /bin/bash -c '
+    export SHELL=/bin/bash
+    export TMPDIR=/tmp
+    export HOME=/root
+    LATEST=$(curl -fsSL https://api.github.com/repos/CodebuffAI/codebuff-community/releases/latest | grep '"'"'tag_name'"'"' | sed -E '"'"'s/.*"freebuff-v([^"]+)".*/\1/'"'"')
+    TARBALL=$(mktemp /tmp/freebuff.XXXXXX.tar.gz)
+    curl -fsSL "https://codebuff.com/api/releases/download/${LATEST}/freebuff-linux-arm64.tar.gz" -o "$TARBALL"
+    mkdir -p /root/.freebuff
+    tar -zxf "$TARBALL" -C /root/.freebuff
+    rm -f "$TARBALL"
+    chmod +x /root/.freebuff/freebuff
+  ' &>>"$LOG_FILE"
+
+  local ubuntu_root
+  ubuntu_root="$(_freebuff_detect_ubuntu_root)"
+  local freebuff_bin="$ubuntu_root/root/.freebuff/freebuff"
+
+  if [ ! -f "$freebuff_bin" ]; then
+    log_error "Freebuff binary not found after update"
+    return 1
+  fi
+
+  log_success "Freebuff (proot-distro) updated"
+  return 0
+}
+
+reinstall_freebuff() {
+  uninstall_freebuff
+  install_freebuff
+}

package/karnel/tools/ai/gemini-cli/README.md

@@ -0,0 +1,46 @@
+# Gemini CLI
+
+Google's AI assistant with Gemini
+
+**Package:** @google/gemini-cli  
+**Author:** israel marques  
+**Repository:** https://github.com/israelmarques1024-dotcom/karnel-termux  
+**Official:** https://github.com/google-gemini/gemini-cli  
+**Type:** AI CLI assistant (npm global package)  
+**License:** MIT
+
+## Description
+
+Gemini CLI is Google's official command-line interface for interacting with the Gemini AI model. It provides code generation, explanation, debugging, and general AI assistance directly from your terminal.
+
+## Dependencies
+
+- Node.js LTS (nodejs-lts)
+- npm
+- git, ripgrep
+
+## Install
+
+```bash
+karnel install ai --gemini-cli
+```
+
+## Uninstall
+
+```bash
+karnel uninstall ai --gemini-cli
+```
+
+## Update
+
+```bash
+karnel update ai --gemini-cli
+```
+
+## Notes
+
+- Installed as a global npm package: `@google/gemini-cli`
+- Command: `gemini`
+- Requires an API key from Google AI Studio
+- Environment variable: `GEMINI_API_KEY`
+

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

@@ -0,0 +1,111 @@
+#!/usr/bin/env bash
+
+import "@/utils/log"
+
+LOG_FILE="$KARNEL_CACHE/install_ai.log"
+
+_gemini_cli_dependencies() {
+  loading "Installing dependencies" _gemini_cli_dependencies_impl
+}
+
+_gemini_cli_dependencies_impl() {
+  declare -A DEPS=(
+    ["nodejs-lts"]="node"
+    ["git"]="git"
+    ["ripgrep"]="rg"
+  )
+
+  local pkg_name bin_name
+  for pkg_name in "${!DEPS[@]}"; do
+    bin_name="${DEPS[$pkg_name]}"
+    if ! command -v "$bin_name" &>/dev/null; then
+      if ! pkg install "$pkg_name" -y &>>"$LOG_FILE"; then
+        log_error "Failed to install $pkg_name"
+        return 1
+      fi
+    fi
+  done
+
+  return 0
+}
+
+_install_gemini_cli_npm() {
+  loading "Installing Gemini CLI" _install_gemini_cli_npm_impl
+}
+
+_install_gemini_cli_npm_impl() {
+  export GYP_DEFINES="android_ndk_path=''"
+  export ANDROID_API_LEVEL=24
+
+  if ! npm install -g @google/gemini-cli &>>"$LOG_FILE"; then
+    log_error "Failed to install Gemini CLI"
+    return 1
+  fi
+
+  return 0
+}
+
+install_gemini_cli() {
+  if command -v gemini &>/dev/null; then
+    log_info "Gemini CLI is already installed"
+    return 2
+  fi
+
+  log_info "Installing Gemini CLI..."
+
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  _gemini_cli_dependencies || return 1
+  _install_gemini_cli_npm || return 1
+
+  log_success "Gemini CLI installed"
+  return 0
+}
+
+uninstall_gemini_cli() {
+  if ! command -v gemini &>/dev/null; then
+    log_info "Gemini CLI is not installed"
+    return 2
+  fi
+  log_info "Uninstalling Gemini CLI..."
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  loading "Removing Gemini CLI" _uninstall_gemini_cli_impl
+
+  log_success "Gemini CLI uninstalled"
+  return 0
+}
+
+_uninstall_gemini_cli_impl() {
+  if ! npm uninstall -g @google/gemini-cli &>>"$LOG_FILE"; then
+    log_error "Failed to uninstall Gemini CLI"
+    return 1
+  fi
+  return 0
+}
+
+update_gemini_cli() {
+  log_info "Updating Gemini CLI..."
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  loading "Updating Gemini CLI" _update_gemini_cli_impl
+
+  log_success "Gemini CLI updated"
+  return 0
+}
+
+_update_gemini_cli_impl() {
+  export GYP_DEFINES="android_ndk_path=''"
+  export ANDROID_API_LEVEL=24
+
+  if ! npm update -g @google/gemini-cli &>>"$LOG_FILE"; then
+    log_error "Failed to update Gemini CLI"
+    return 1
+  fi
+  return 0
+}
+
+reinstall_gemini_cli() {
+  uninstall_gemini_cli
+  install_gemini_cli
+}

package/karnel/tools/ai/gentle-ai/README.md

@@ -0,0 +1,42 @@
+# Gentle-AI
+
+Ecosystem, Frameworks, Workflows for AI coding agents
+
+**Package:** gentle-ai  
+**Author:** Gentleman-Programming  
+**Repository:** https://github.com/Gentleman-Programming/gentle-ai  
+**Type:** AI ecosystem configurator (Go source compile)  
+**License:** MIT
+
+## Description
+
+Gentle-AI is an ecosystem configurator for AI coding agents. It provides persistent memory (Engram), Spec-Driven Development workflows, curated coding skills, MCP servers, an AI provider switcher, a teaching-oriented persona with security-first permissions, and per-phase model assignment for 15+ supported agents.
+
+## Dependencies
+
+- golang (1.23+), git, curl
+
+## Install
+
+```bash
+karnel install ai --gentle-ai
+```
+
+## Uninstall
+
+```bash
+karnel uninstall ai --gentle-ai
+```
+
+## Update
+
+```bash
+karnel update ai --gentle-ai
+```
+
+## Notes
+
+- Source cloned from GitHub and compiled natively with Go
+- Termux-specific patches applied automatically for Android compatibility
+- Data directory: `~/.local/share/karnel-data/gentle-ai/`
+- Command: `gentle-ai`