GrokHunter

Ship code from your pocket.

Kali NetHunter (rootless) × Grok Build — AI coding lab for unrooted Android

Turn Termux + proot Kali into a Linux development environment on your phone, with Grok as an on-device pair programmer. No root required.

Built on termux-nethunter / termux-distro by jorexdeveloper.
Not affiliated with xAI, Offensive Security, or jorexdeveloper — we credit and depend on their work. See CREDITS.md.

Product site: finecomputer14451.github.io/GrokHunter
Release: v1.0.9 · Grok Build 1.0.5+ · Grok 4.6

Source: website/ · deploy: push website/** or branding/**, or Actions → Deploy website.

---

Quick install

# One-liner (Termux from F-Droid / GitHub — not Play Store)
bash <(curl -fsSL https://raw.githubusercontent.com/FineComputer14451/GrokHunter/main/install.sh)

# Or clone
git clone https://github.com/FineComputer14451/GrokHunter.git
cd GrokHunter && bash install.sh

Recommended full stack

bash install.sh --full --de xfce --browser chromium \
  --with-grok --with-x11 --with-aider --with-v9-models

Component	What you get
Kali rootfs	Latest NetHunter rootless image (proot)
Desktop	XFCE (or other DE) + Chromium
Grok Build	1.0.5+ TUI / headless pair programmer (default model grok-4.6)
Termux:X11	Low-latency GUI + nh-x11 helper
Aider	Optional git-native pair (uv + Python 3.12)
Agents / personas / roles	Coding Team + lab specialists (skills install)
V9 pickers	/model chat-expert · multi · auto · grok-v9 aliases

Refresh cached modules after upgrades:

GROKHUNTER_REFRESH=1 bash install.sh --help

---

Why this stack?

Need	What you get
Real Linux toolchain	apt, gcc, python, node, rust, go inside Kali
No root	Stock Android
AI pair-programmer	Grok Build TUI + headless + optional Aider
Desktop	XFCE via Termux:X11 (nh-x11)
Portability	Lab lives entirely under Termux

---

Install flags

-f, --full              Full install (desktop-capable rootfs)
-m, --mini              Mini (essential packages)
-n, --nano              Nano (minimal footprint)
--de <desktop>          e17 | gnome | i3 | kde | lxde | mate | xfce
--browser <browser>     chromium | firefox | both
--no-de                 Skip desktop environment
--with-grok / --no-grok
--with-x11 / --no-x11
--with-aider / --no-aider
--with-v9-models / --no-v9-models
--with-completions / --no-completions
--overlay-only          Optional overlays only (no rootfs re-download)
-h, --help

Unknown --de / --browser values are rejected.

---

After install

nethunter              # Kali shell (rootless proot)
nh-x11                 # XFCE via Termux:X11 (compositor off by default)
grok                   # Interactive Grok session
grokhunter             # Primary CLI / TUI
grokhunter status      # auth / x11 / v9 quick line
grokhunter doctor      # Full health report
grokhunter git-identity  # GitHub-attributable git user.name / email
grokhunter setup       # One-shot: ensure + skills + doctor
grokhunter ensure      # Grok Build ≥ 1.0.5 + NetHunter profile
grokhunter team        # Coding Team multi-agent
grokhunter scout "…"   # Fast map agent (headless when prompt given)
grokhunter overlay|ship|docs "…"  # Lab specialists (install / release / docs)
grokhunter modeler|ci|aider "…"   # Models/V9, CI, Aider (modeler ≠ grokhunter models)
grokhunter session|host|mcp "…"   # tmux/resume, Termux vs Kali, MCP (mcp ≠ grok mcp)
grokhunter plugin|flow|storage "…"  # plugins (≠ grok plugin), workflows, disk
grokhunter editor|hook|shell "…"  # nvim/micro, Grok hooks, profile/completions
grokhunter models      # Install or status V9 model pickers
grokhunter ai-smoke    # SpaceXAI API smoke (needs XAI_API_KEY)
grokhunter plan "…"    # Plan agent (Grok Build 1.0.5)
grokhunter -p "…"      # Headless one-shot

Grok Build 1.0.5 + Grok 4.6

grokhunter ensure                  # binary ≥ 1.0.5 + stable profile
bash scripts/install_grok_profile.sh --force
grokhunter models install          # optional /model aliases → grok-4.6
grokhunter models status

In-session: /model chat-expert · /model multi · /model auto · /model grok-v9
Base model is grok-4.6. See docs/GROK-46.md and docs/GROK-BUILD-1.0.md.

Termux:X11

1. Install the Termux:X11 APK (prefer sharedUserId builds with GitHub Termux).
2. Run nh-x11.
3. Black screen? NH_X11_LEGACY=1 nh-x11
4. Performance tips: docs/X11-PERFORMANCE.md

Aider (optional)

aider-grok             # uses XAI_API_KEY from ~/.grok/secrets.env

Details: docs/EDITORS.md.

---

Architecture

install.sh                 Termux one-liner entry (wake-lock, module cache)
lib/
  cli.sh                   Flags & help
  actions.sh               Rootfs / DE / Grok / X11 / Aider / V9 hooks
  grok.sh                  Grok Build + Aider + V9 helpers
  x11.sh                   Termux:X11 + nh-x11 + /tmp bind patch
bin/
  grokhunter               status | doctor | models | ai-smoke | ensure | plan | install
  grokhunter-doctor        Health report
  grok-nethunter           Full-screen launcher
  nh-x11 / aider-grok      Desktop + Aider helpers
scripts/
  install_v9_grok_models.sh   Atomic V9 [model.*] picker install
  spacexai_smoke.sh           SpaceXAI Responses API smoke
  ci-unit.sh                  Local unit checks (bash scripts/ci-unit.sh)
config/                    Completions, profile, model examples
skills/                    grokhunter · pair-programming · aider-grok · x11-desktop · nethunter-recon
                           toolchain · github-lab · grok-models · ci-lab · secrets-lab
                           session-lab · host-lab · mcp-lab · plugin-lab · flow-lab · storage-lab
                           editor-lab · hooks-lab · shell-lab (optional)
agents/                    benjamin · lucas · harper · coding-team · scout · review · fix · desktop
                           overlay · ship · docs · models · ci · aider · session · host · mcp
                           plugin · flow · storage · editor · hook · shell
docs/                      INSTALL, FAQ, X11, PROOT, EDITORS, GROK-46

---

Requirements

• Termux from F-Droid or GitHub (not Play Store)
• Android 8+ (aarch64 recommended)
• No root
• Several GB free for full desktop (mini/nano need less)
• SuperGrok / X Premium+ or XAI_API_KEY for Grok Build

Keep API keys in ~/.grok/secrets.env (mode 600).

---

Docs

Doc	Topic
INSTALL.md	Step-by-step install
GROK-46.md	Grok 4.6 profile + V9 pickers
GROK-BUILD-1.0.md	Grok Build 1.0.5 compatibility
CODING-TEAM.md	Agents · personas · roles
X11-PERFORMANCE.md	Termux:X11 tuning
EDITORS.md	Aider / editors
PROOT.md	proot binds & storage
FAQ.md	Common questions
TROUBLESHOOTING.md	Fixes
ARCHITECTURE.md	Design
CREDITS.md	jorexdeveloper + upstream attribution

---

License

• This repository (GrokHunter overlay, CLI, docs): see LICENSE
• Upstream install engine (termux-distro / termux-nethunter): GPL-3.0, © jorexdeveloper and contributors

GrokHunter Rootless enhancements © 2026 FineComputer14451 and contributors.

Credits

Full attribution: CREDITS.md · CLI: grokhunter credits

Pillar	Who	What GrokHunter uses
Install engine	jorexdeveloper	termux-nethunter · termux-distro (GPL-3.0)
Host platform	Termux team	Termux app/packages · Termux:X11 · termux.dev
Guest rootfs	Kali / Offensive Security	Official NetHunter rootfs images · Kali apt toolchains
AI agent	xAI	Grok Build · Grok models / API · docs.x.ai

Thank you to jorexdeveloper, the Termux project, Kali/OffSec, and xAI. Please support their work directly.

Also: Aider (optional pair tool).

Not affiliated with xAI, Offensive Security, Termux, or jorexdeveloper. We credit and depend on their work.