GrokHunter v1.0.7
Release GitHub
Rootless · v1.0.7 No root required Grok Build 1.0.0 Agents · personas · roles

Kali NetHunter Rootless powered by Grok Build

Turn unrooted Android into a full AI coding lab. Real Linux toolchains, Grok Build 1.0.0 (TUI + headless), Coding Team multi-agents, Aider, and a low-latency desktop — one installer, no root.

Quick install 
bash <(curl -fsSL https://raw.githubusercontent.com/FineComputer14451/GrokHunter/main/install.sh)
Full install guide v1.0.7 release View on GitHub

Built on termux-nethunter / termux-distro by jorexdeveloper. Not affiliated with xAI, Offensive Security, or jorexdeveloper. Coding lab only.

install · rootless · 1.0.7
1.0.7 Product version
1.0.0+ Grok Build min
8 Runtime agents
8 Personas
7 Roles
0 Root required

Why this stack

A real lab on your phone

Learn languages, ship tools, and pair with Grok on device — without rooting Android.

Need What you get
Real Linux toolchain apt, gcc, python, node, rust, go inside Kali
No root Stock Android — rootless proot only
AI pair-programmer Grok Build 1.0.0 TUI + headless, agents, skills
Multi-agent coding Coding Team: design → build → harden + specialists
Git-native pair Aider via uv + managed Python 3.12 (works on Kali 3.13)
Desktop IDE feel XFCE + Termux:X11 (nh-x11)
Portability Entire lab lives under Termux

Features

Everything for an on-device coding agent

Overlay on official NetHunter — modular, idempotent, built for mobile pair sessions.

Rootless first

Termux + proot only. Stock Android, warranty intact — no Magisk, recovery, or firmware modules.

Grok Build 1.0.0

Official CLI with fullscreen TUI, headless -p, plan agent, skills, and stable channel defaults via NetHunter profile.

Coding Team agents

Benjamin · Lucas · Harper orchestrated with scout, review, fix, and desktop specialists for Design → Build → Harden.

Personas & roles

Tone overlays (mobile, design-card, …) and capability roles (architect, builder, …) for Grok Build 1.0.0 subagent resolution.

Real Linux toolchains

Full Kali apt: gcc, python, node, rust, go — a real coding lab, not a toy shell.

Desktop via Termux:X11

XFCE + low-latency nh-x11 helper for editors and browsers that feel like a mini workstation.

Aider + xAI

aider-grok with secrets.env and grok-4.5. Installer uses uv + managed Python 3.12 so Kali 3.13 does not break Aider.

Doctor & status

grokhunter doctor checks binary, profile, skills, agents, personas, roles, PATH, secrets, and lab readiness.

Overlay, not a fork

Sits on the official NetHunter rootfs. Idempotent install, clean uninstall, modular lib/.

Stack

Four layers under ~/.grok

Install once with grokhunter skills install — skills, agents, personas, and roles land where Grok Build 1.0.0 discovers them.

Skills

~/.grok/skills

Lab playbooks: grokhunter, pair-programming, aider-grok, x11-desktop, nethunter-recon.

skills-core=3/3
Agents

~/.grok/agents

Session types for /config-agents and spawn — Coding Team + specialists.

8 user agents
Personas

~/.grok/personas

Tone and card contracts: mobile, concise, design-card, build-card, harden-card, …

8 personas
Roles

~/.grok/roles

Capability defaults: architect, builder, reliability, mapper, surgical, …

7 roles
Mental model 
agent  = who            (benjamin, lucas, scout, …)
role   = capabilities   (architect, builder, mapper, …)
persona = tone / cards  (mobile, design-card, concise, …)

Agents

Coding Team + lab specialists

Runtime Grok Build agents — pick in /config-agents or spawn by name.

Core loop

1scout (optional map)
2benjamin design
3lucas / fix build
4harper harden
5review (optional)
Agent Mode Role
coding-team full Orchestrator — Design → Build → Harden
benjamin plan / read-only Senior architect, security, mobile constraints
lucas full Rapid builder — small shippable increments
harper full Reliability — tests, edge cases, harden cards
scout read-only Fast codebase / install-flow map
review read-only Diff / change review
fix full Surgical one-bug patches
desktop full Termux:X11 / nh-x11 / proot binds
Try headless 
grok --agent scout -p "Map install_aider"
grok --agent coding-team
grokhunter plan "Design overlay-only repair"

Personas & roles

Overlays for tone and capability

Personas inject behavioral reminders; roles set capability mode and reasoning effort. Manage in TUI via /personas and /config-agents.

Personas
mobileNetHunter / Termux constraints
conciseShort, scannable output
shell-firstScripts & lab tooling bias
pairPair-programming tone
security-labSecrets & installer safety
design-cardBenjamin-style design card
build-cardLucas-style build card
harden-cardHarper-style harden card
Roles
architectread-only · high effort
builderfull · medium
reliabilityfull · high
mapperread-only · medium
code-reviewfull · high
surgicalfull · medium
x11-desktopfull · medium

Install

One command, modular stack

Requires Termux from F-Droid or GitHub (not Play Store), Android 8+, aarch64 recommended, and SuperGrok / X Premium+ or an XAI_API_KEY for Grok Build.

01 One-liner 
bash <(curl -fsSL https://raw.githubusercontent.com/FineComputer14451/GrokHunter/main/install.sh)
02 Recommended full stack 
bash install.sh --full --de xfce --browser chromium \
  --with-grok --with-x11 --with-aider --with-v9-models
03 Clone (audit-friendly) 
git clone https://github.com/FineComputer14451/GrokHunter.git
cd GrokHunter
bash install.sh --full --de xfce --with-grok --with-x11
04 Overlay-only (no rootfs re-download) 
bash install.sh --overlay-only --with-grok --with-x11 --with-aider

Installer flags

  • -f, --fullFull installation (includes desktop)
  • -m, --miniMini (essential packages)
  • -n, --nanoNano (minimal footprint)
  • --de <desktop>e17 | gnome | i3 | kde | lxde | mate | xfce
  • --browser <name>chromium | firefox | both
  • --with-grokGrok Build ≥ 1.0.0 + profile
  • --with-x11Termux:X11 + nh-x11 helper
  • --with-aiderAider (uv + Python 3.12)
  • --with-v9-models/model chat-expert · multi · auto
  • --with-completionsShell completions + profile
  • --overlay-onlyOverlays only (no rootfs download)
  • --no-de / --no-grok / --no-x11Skip those stages

After install

  • nethunter — enter Kali shell
  • nh-x11 — low-latency desktop
  • grok — Grok Build TUI
  • grokhunter doctor — health report
  • grokhunter skills install — agents · personas · roles
  • aider-grok — git-native pair

CLI

grokhunter commands

Also: grok-nethunter fullscreen launcher · grok native TUI · aliases via profile (gh, ghd, ghp, …)

grokhunterInteractive fullscreen TUI
grokhunter statusShort status line
grokhunter doctorFull health report
grokhunter setupOne-shot: ensure + skills + doctor
grokhunter ensureGrok Build ≥ 1.0.0 + NetHunter profile
grokhunter skills installSkills, agents, personas, roles + wrappers
grokhunter teamLaunch Coding Team agent
grokhunter scout|review|fix|desktopSpecialist agent launchers
grokhunter agents statusInstalled Coding Team agents
grokhunter models installV9 / 4.5 model pickers
grokhunter ai-smokeSpaceXAI API smoke test
grokhunter install [args]Installer (supports --overlay-only)
grokhunter plan "…"Built-in plan agent (1.0.0)
grokhunter -p "…"Headless one-shot
bash scripts/install_aider.shRepair Aider (uv + 3.12)
bash scripts/ci-unit.shLocal unit checks

Upgrade to 1.0.7

From an existing lab

Already installed? Pull, ensure Grok Build 1.0.0+, refresh skills/agents, install the Kali menu, then doctor.

Paste-ready 
cd ~/GrokHunter && git pull
grokhunter ensure              # binary ≥ 1.0.0 + profile
grokhunter skills install      # skills · agents · personas · roles
grokhunter menu install        # Applications → GrokHunter (XFCE)
grokhunter models install      # optional /model aliases
grokhunter doctor
grokhunter credits             # upstream attribution
Release

v1.0.7 on GitHub

Grok Build docs

GROK-BUILD-1.0.md

Coding Team

CODING-TEAM.md

Architecture

Overlay on a living rootfs

Design goals: rootless first, coding focus, official Grok binary, idempotent install, mobile-first UX.

1
Androidstock / unrooted
2
TermuxF-Droid or GitHub (not Play Store)
3
proot → Kali NHnano / mini / full rootfs
4
GrokHunter overlay Grok CLI · agents · personas · roles · nh-x11 · doctor · skills
No root

No Magisk, HID, or custom recovery

Not a fork

Never rebuilds Kali rootfs or kernels

Idempotent

Safe to re-run; uninstall keeps your projects

FAQ

Common questions

Do I need root?

No. GrokHunter is rootless Termux + proot only. Use Termux from F-Droid or GitHub — not the Play Store.

Which Grok Build version?

GrokHunter 1.0.7 targets Grok Build 1.0.0+ (stable). Run grokhunter ensure to upgrade and apply the NetHunter profile.

How do I auth Grok?

SuperGrok / X Premium+ login via grok, or put XAI_API_KEY in ~/.grok/secrets.env (mode 600). Never commit secrets.

Aider failed on Kali Python 3.13?

Expected with plain pip. Use bash scripts/install_aider.sh — uv installs managed Python 3.12 + aider-chat. Then aider-grok.

Black screen on nh-x11?

Try NH_X11_LEGACY=1 nh-x11, install the Termux:X11 APK (sharedUid with GitHub Termux), and see docs/X11-PERFORMANCE.md. Or spawn the desktop agent.

Is this for penetration testing?

The product focus is a coding lab. Optional nethunter-recon skill is scoped for authorized lab/CTF only — not default.

Credits

Built on open-source shoulders

GrokHunter is an overlay for an AI coding lab. The rootless NetHunter install path depends on work by jorexdeveloper — please support those projects.

Author / project Contribution
jorexdeveloper termux-nethunter · termux-distro — rootless NetHunter install + shared engine (GPL-3.0)
Termux team termux.dev · app, packages, proot host · Termux:X11 for nh-x11
Kali Linux / Offensive Security Official NetHunter rootfs images + Kali package ecosystem (coding-lab use)
xAI Grok Build agent · Grok models / API · docs.x.ai

Full statement: CREDITS.md · Not affiliated with xAI, Offensive Security, Termux, or jorexdeveloper — we gratefully build upon their work.

Ship code from your pocket

Clone the repo, run the installer, open Grok. Coding Team, Aider, and a full Linux toolchain — ready on unrooted Android.

FineComputer14451/GrokHunter v1.0.7 release Install commands