karnel-termux 0.0.1

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

@@ -0,0 +1,104 @@
+#!/usr/bin/env bash
+
+import "@/utils/log"
+
+LOG_FILE="$KARNEL_CACHE/install_ai.log"
+
+_codex_dependencies() {
+	loading "Installing dependencies" _codex_dependencies_impl
+}
+
+_codex_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_codex_npm() {
+	loading "Installing Codex CLI" _install_codex_npm_impl
+}
+
+_install_codex_npm_impl() {
+	if ! npm i -g @mmmbuto/codex-cli-termux@latest &>>"$LOG_FILE"; then
+		log_error "Failed to install Codex CLI"
+		return 1
+	fi
+
+	return 0
+}
+
+install_codex() {
+	if command -v codex &>/dev/null; then
+		log_info "Codex CLI is already installed"
+		return 2
+	fi
+	log_info "Installing Codex CLI..."
+
+	mkdir -p "$(dirname "$LOG_FILE")"
+
+	_codex_dependencies || return 1
+	_install_codex_npm || return 1
+
+	log_success "Codex CLI installed"
+	return 0
+}
+
+uninstall_codex() {
+	if ! command -v codex &>/dev/null; then
+		log_info "Codex CLI is not installed"
+		return 2
+	fi
+	log_info "Uninstalling Codex CLI..."
+	mkdir -p "$(dirname "$LOG_FILE")"
+
+	loading "Removing Codex CLI" _uninstall_codex_impl
+
+	log_success "Codex CLI uninstalled"
+	return 0
+}
+
+_uninstall_codex_impl() {
+	if ! npm uninstall -g @mmmbuto/codex-cli-termux &>>"$LOG_FILE"; then
+		log_error "Failed to uninstall Codex CLI"
+		return 1
+	fi
+	return 0
+}
+
+update_codex() {
+	log_info "Updating Codex CLI..."
+	mkdir -p "$(dirname "$LOG_FILE")"
+
+	loading "Updating Codex CLI" _update_codex_impl
+
+	log_success "Codex CLI updated"
+	return 0
+}
+
+_update_codex_impl() {
+	if ! npm update -g @mmmbuto/codex-cli-termux &>>"$LOG_FILE"; then
+		log_error "Failed to update Codex CLI"
+		return 1
+	fi
+	return 0
+}
+
+reinstall_codex() {
+	uninstall_codex
+	install_codex
+}

package/karnel/tools/ai/command-code/README.md

@@ -0,0 +1,62 @@
+# Command Code
+
+The coding agent that learns your coding taste.
+
+**Package:** command-code  
+**Author:** israel marques  
+**Repository:** https://github.com/israelmarques1024-dotcom/karnel-termux  
+**Official:** https://github.com/CommandCodeAI/command-code
+**Type:** AI coding assistant (npm local package with wrapper)  
+**License:** MIT
+
+## Description
+
+The first frontier coding agent that both builds software and continuously learns your coding taste. Ships full-stack projects, features, fixes bugs, writes tests, and refactors, all while learning how you write code.
+
+## Why Local Install?
+
+On Termux, the global `npm install -g command-code` creates a binary named `cmd` which conflicts with the existing Termux `cmd` binary. Karnel Termux solves this by:
+
+1. Installing `command-code` locally in `~/.local/share/karnel-data/command-code/`
+2. Creating a wrapper script at `$PREFIX/bin/command-code`
+3. Adding an alias `cmdc` via symlink
+
+## Dependencies
+
+- Node.js LTS (nodejs-lts)
+- npm
+- git
+- ripgrep
+
+## Install
+
+```bash
+karnel install ai --command-code
+```
+
+## Uninstall
+
+```bash
+karnel uninstall ai --command-code
+```
+
+## Update
+
+```bash
+karnel update ai --command-code
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `command-code` | Run Command Code |
+| `cmdc` | Alias for command-code |
+
+## Notes
+
+- Installed as a local npm package (avoids `cmd` binary conflict)
+- Wrapper script created at `$PREFIX/bin/command-code`
+- Alias `cmdc` created via symlink
+- Data directory: `~/.local/share/karnel-data/command-code/`
+- Requires Node.js LTS (installed automatically if missing)

package/karnel/tools/ai/command-code/install.sh

@@ -0,0 +1,136 @@
+#!/usr/bin/env bash
+
+import "@/utils/log"
+
+LOG_FILE="$KARNEL_CACHE/install_ai.log"
+COMMAND_CODE_DATA_DIR="$HOME/.local/share/karnel-data/command-code"
+
+_command_code_dependencies() {
+  loading "Installing dependencies" _command_code_dependencies_impl
+}
+
+_command_code_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_command_code_npm() {
+  loading "Installing command-code via npm" _install_command_code_npm_impl
+}
+
+_install_command_code_npm_impl() {
+  mkdir -p "$COMMAND_CODE_DATA_DIR"
+
+  if ! (cd "$COMMAND_CODE_DATA_DIR" && npm init -y &>>"$LOG_FILE"); then
+    log_error "Failed to initialize npm project"
+    return 1
+  fi
+
+  if ! (cd "$COMMAND_CODE_DATA_DIR" && npm install command-code@latest &>>"$LOG_FILE"); then
+    log_error "Failed to install command-code package"
+    return 1
+  fi
+
+  return 0
+}
+
+_install_command_code_wrappers() {
+  loading "Creating command-code and cmdc wrappers" _install_command_code_wrappers_impl
+}
+
+_install_command_code_wrappers_impl() {
+  local wrapper_content='#!'"$PREFIX"'/bin/bash
+
+exec node '"$COMMAND_CODE_DATA_DIR"'/node_modules/command-code/dist/index.mjs "$@"'
+
+  echo "$wrapper_content" >"$PREFIX/bin/command-code"
+  chmod +x "$PREFIX/bin/command-code"
+
+  ln -sf "$PREFIX/bin/command-code" "$PREFIX/bin/cmdc"
+
+  return 0
+}
+
+install_command_code() {
+  if command -v command-code &>/dev/null; then
+    log_info "Command Code is already installed"
+    return 2
+  fi
+
+  log_info "Installing Command Code..."
+
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  _command_code_dependencies || return 1
+  _install_command_code_npm || return 1
+  _install_command_code_wrappers || return 1
+
+  log_success "Command Code installed successfully"
+  return 0
+}
+
+uninstall_command_code() {
+  if ! command -v command-code &>/dev/null; then
+    log_info "Command Code is not installed"
+    return 2
+  fi
+  log_info "Uninstalling Command Code..."
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  loading "Removing Command Code files" _uninstall_command_code_impl
+
+  log_success "Command Code uninstalled"
+  return 0
+}
+
+_uninstall_command_code_impl() {
+  rm -f "$PREFIX/bin/command-code"
+  rm -f "$PREFIX/bin/cmdc"
+  rm -rf "$COMMAND_CODE_DATA_DIR"
+  return 0
+}
+
+update_command_code() {
+  log_info "Updating Command Code..."
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  if [ ! -d "$COMMAND_CODE_DATA_DIR" ]; then
+    log_warn "Command Code is not installed"
+    return 1
+  fi
+
+  loading "Updating command-code package" _update_command_code_impl
+
+  log_success "Command Code updated"
+  return 0
+}
+
+_update_command_code_impl() {
+  if (cd "$COMMAND_CODE_DATA_DIR" && npm update command-code &>>"$LOG_FILE"); then
+    return 0
+  else
+    log_error "Failed to update Command Code"
+    return 1
+  fi
+}
+
+reinstall_command_code() {
+  uninstall_command_code
+  install_command_code
+}

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

@@ -0,0 +1,17 @@
+# Crush
+
+> Your new coding bestie, now available in your favourite terminal.
+
+Crush is a terminal-based AI coding assistant from Charm. It supports multiple LLMs, session-based context, LSP integration, and MCPs.
+
+**Install:** `karnel install ai --crush`  
+**Command:** `crush`  
+**Docs:** https://github.com/charmbracelet/crush
+
+## Features
+
+- Multi-Model support (OpenAI, Anthropic, custom APIs)
+- Session-based workflow with context preservation
+- LSP-enhanced code understanding
+- Extensible via MCPs (http, stdio, sse)
+- Works on macOS, Linux, Windows, Android, FreeBSD

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

@@ -0,0 +1,89 @@
+#!/usr/bin/env bash
+
+import "@/utils/log"
+import "@/utils/colors"
+
+LOG_FILE="$KARNEL_CACHE/install_ai.log"
+CRUSH_VERSION="0.82.0"
+
+install_crush() {
+  if command -v crush &>/dev/null; then
+    log_info "Crush is already installed"
+    return 2
+  fi
+
+  log_info "Installing Crush..."
+
+  # Try npm first
+  if command -v npm &>/dev/null; then
+    log_info "Attempting npm install..."
+    if npm install -g @charmland/crush &>>"$LOG_FILE"; then
+      if command -v crush &>/dev/null; then
+        log_success "Crush installed via npm"
+        return 0
+      fi
+    fi
+    log_warn "npm install failed, trying GitHub release..."
+  fi
+
+  # Fallback: download from GitHub releases
+  local arch
+  arch=$(uname -m)
+  local tarball="crush_${CRUSH_VERSION}_Android_arm64.tar.gz"
+  local url="https://github.com/charmbracelet/crush/releases/download/v${CRUSH_VERSION}/${tarball}"
+
+  log_info "Downloading Crush v${CRUSH_VERSION} for Android arm64..."
+
+  local tmpdir
+  tmpdir=$(mktemp -d)
+  if curl -fsSL --connect-timeout 15 --max-time 120 "$url" -o "$tmpdir/$tarball" 2>>"$LOG_FILE"; then
+    if tar xzf "$tmpdir/$tarball" -C "$tmpdir" 2>>"$LOG_FILE"; then
+      local bin_path
+      bin_path=$(find "$tmpdir" -name "crush" -type f -executable 2>/dev/null | head -1)
+      if [[ -n "$bin_path" ]]; then
+        rm -f "$PREFIX/bin/crush"
+        cp "$bin_path" "$PREFIX/bin/crush"
+        chmod +x "$PREFIX/bin/crush"
+        rm -rf "$tmpdir"
+        if command -v crush &>/dev/null; then
+          log_success "Crush installed from GitHub release"
+          return 0
+        fi
+      fi
+    fi
+  fi
+
+  rm -rf "$tmpdir"
+  log_error "Failed to install Crush"
+  log_info "Check log: $LOG_FILE"
+  return 1
+}
+
+uninstall_crush() {
+  if ! command -v crush &>/dev/null; then
+    log_info "Crush is not installed"
+    return 0
+  fi
+
+  log_info "Uninstalling Crush..."
+  rm -f "$PREFIX/bin/crush"
+  npm uninstall -g @charmland/crush &>>"$LOG_FILE" 2>/dev/null
+  log_success "Crush uninstalled"
+  return 0
+}
+
+update_crush() {
+  if ! command -v crush &>/dev/null; then
+    log_info "Crush is not installed"
+    return 0
+  fi
+
+  log_info "Updating Crush..."
+  uninstall_crush
+  install_crush
+}
+
+reinstall_crush() {
+  uninstall_crush
+  install_crush
+}

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

@@ -0,0 +1,26 @@
+# ctx7 (Context7)
+
+Real-time documentation provider for AI coding assistants.
+
+## What is it?
+
+[Context7](https://github.com/context7) solves stale knowledge issues by providing AI tools with real-time, version-specific documentation and code examples on-demand.
+
+## Install
+
+```bash
+karnel install ai --ctx7
+```
+
+## Usage
+
+- As an MCP server for Claude Code, Cursor, etc.
+- CLI: `ctx7` to fetch library documentation
+
+## Requirements
+
+- Node.js (install with `karnel install lang --nodejs`)
+
+---
+
+*Adapted for Karnel-Termux by israel marques*

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

@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+
+# ctx7 (Context7) - Real-time documentation provider for AI coding assistants
+# Provides version-specific library docs and code examples on-demand
+# Solves stale knowledge issues in AI tools like Claude Code, Cursor
+# Official: npm install -g ctx7
+
+install_ctx7() {
+  if command -v ctx7 &>/dev/null; then
+    log_info "ctx7 is already installed"
+    return 2
+  fi
+
+  log_info "Installing ctx7 (Context7 documentation provider)..."
+  npm install -g ctx7 2>/dev/null
+  local rc=$?
+
+  local _t
+  _t=$(readlink -f "$PREFIX/bin/ctx7" 2>/dev/null)
+  [ -f "$_t" ] && sed -i '1s|^#!/usr/bin/env node|#!/data/data/com.termux/files/usr/bin/env node|' "$_t"
+
+  if [[ $rc -eq 0 ]] && command -v ctx7 &>/dev/null; then
+    log_success "ctx7 installed successfully"
+    log_info "Use as MCP server: ctx7 --help"
+    return 0
+  else
+    log_error "ctx7 installation failed"
+    return 1
+  fi
+}
+
+uninstall_ctx7() {
+  if ! command -v ctx7 &>/dev/null; then
+    log_info "ctx7 is not installed"
+    return 0
+  fi
+
+  log_info "Uninstalling ctx7..."
+  npm uninstall -g ctx7 2>/dev/null
+  return $?
+}
+
+update_ctx7() {
+  if ! command -v ctx7 &>/dev/null; then
+    log_warn "ctx7 is not installed"
+    return 1
+  fi
+
+  log_info "Updating ctx7..."
+  npm update -g ctx7 2>/dev/null
+  local _t
+  _t=$(readlink -f "$PREFIX/bin/ctx7" 2>/dev/null)
+  [ -f "$_t" ] && sed -i '1s|^#!/usr/bin/env node|#!/data/data/com.termux/files/usr/bin/env node|' "$_t"
+  return $?
+}
+
+reinstall_ctx7() {
+  uninstall_ctx7 2>/dev/null
+  install_ctx7
+  return $?
+}

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

@@ -0,0 +1,44 @@
+# Engram
+
+Persistent memory system for AI coding agents
+
+**Package:** engram  
+**Author:** israel marques  
+**Repository:** https://github.com/israelmarques1024-dotcom/karnel-termux  
+**Official:** https://github.com/Gentleman-Programming/engram  
+**Type:** AI memory system (Go binary)  
+**License:** MIT
+
+## Description
+
+Engram is a persistent memory system designed for AI coding agents. It provides long-term memory storage and retrieval, allowing AI assistants to maintain context across sessions. Built with Go for performance and reliability.
+
+## Dependencies
+
+- golang, git, sqlite
+
+## Install
+
+```bash
+karnel install ai --engram
+```
+
+## Uninstall
+
+```bash
+karnel uninstall ai --engram
+```
+
+## Update
+
+```bash
+karnel update ai --engram
+```
+
+## Notes
+
+- Built from source using Go
+- Source cloned to `$KARNEL_DATA/engram/`
+- Binary installed to `$PREFIX/bin/engram`
+- Requires Go toolchain (installed automatically)
+

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

@@ -0,0 +1,127 @@
+#!/usr/bin/env bash
+
+import "@/utils/log"
+
+LOG_FILE="$KARNEL_CACHE/install_ai.log"
+
+_engram_dependencies() {
+  loading "Installing dependencies" _engram_dependencies_impl
+}
+
+_engram_dependencies_impl() {
+  declare -A DEPS=(
+    ["golang"]="go"
+    ["git"]="git"
+    ["sqlite"]="sqlite"
+  )
+
+  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
+}
+
+_clone_engram_repo() {
+  loading "Cloning engram repository" _clone_engram_repo_impl
+}
+
+_clone_engram_repo_impl() {
+  if ! git clone --quiet https://github.com/Gentleman-Programming/engram "$KARNEL_DATA/engram" &>>"$LOG_FILE"; then
+    log_error "Failed to clone engram repository"
+    return 1
+  fi
+
+  return 0
+}
+
+_build_engram() {
+  loading "Building engram binary" _build_engram_impl
+}
+
+_build_engram_impl() {
+  if ! go build -C "$KARNEL_DATA/engram/cmd/engram" -o $PREFIX/bin/engram &>>"$LOG_FILE"; then
+    log_error "Failed to build engram"
+    return 1
+  fi
+
+  return 0
+}
+
+install_engram() {
+  if command -v engram &>/dev/null; then
+    log_info "Engram is already installed"
+    return 2
+  fi
+  log_info "Installing Engram..."
+
+  export GOPATH="$HOME/.local/go"
+  export GOCACHE="$HOME/.cache/go"
+  export GOMODCACHE="$GOPATH/pkg/mod"
+
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  _engram_dependencies || return 1
+  _clone_engram_repo || return 1
+  _build_engram || return 1
+
+  log_success "Engram installed"
+  return 0
+}
+
+uninstall_engram() {
+  if ! command -v engram &>/dev/null; then
+    log_info "Engram is not installed"
+    return 2
+  fi
+  log_info "Uninstalling Engram..."
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  loading "Removing Engram" _uninstall_engram_impl
+
+  log_success "Engram uninstalled"
+  return 0
+}
+
+_uninstall_engram_impl() {
+  if rm -rf "$KARNEL_DATA/engram" && rm "$PREFIX/bin/engram" &>>"$LOG_FILE"; then
+    return 0
+  else
+    log_error "Failed to uninstall Engram"
+    return 1
+  fi
+}
+
+update_engram() {
+  log_info "Updating Engram..."
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  loading "Updating Engram" _update_engram_impl
+
+  log_success "Engram updated"
+  return 0
+}
+
+_update_engram_impl() {
+  export GOPATH="$HOME/.local/go"
+  export GOCACHE="$HOME/.cache/go"
+  export GOMODCACHE="$GOPATH/pkg/mod"
+
+  if ! git -C "$KARNEL_DATA/engram" pull &>>"$LOG_FILE" && go build -C "$KARNEL_DATA/engram/cmd/engram" -o $PREFIX/bin/engram &>>"$LOG_FILE"; then
+    log_error "Failed to update Engram"
+    return 1
+  fi
+  return 0
+}
+
+reinstall_engram() {
+  uninstall_engram
+  install_engram
+}