Skip to content

FAQ.md

Latest commit

 

History

History
104 lines (66 loc) · 3.82 KB

FAQ.md

File metadata and controls

104 lines (66 loc) · 3.82 KB
Raw

FAQ — GrokHunter Rootless

What is GrokHunter?

A rootless Kali NetHunter lab on Termux, optimized for coding and building, with Grok Build as the on-device pair programmer. No root, no custom kernel.

Who should get credit for this stack?

GrokHunter is an overlay. Full statement: CREDITS.md · grokhunter credits

Layer Credit
Install engine jorexdeveloper — termux-nethunter, termux-distro
Host Termux team — app, packages, Termux:X11
Guest OS images Kali / Offensive Security — NetHunter rootfs
AI agent xAI — Grok Build, Grok models

We are not affiliated with those projects; we depend on them and give credit.

Does it require root?

No. It uses Termux + proot only.

Is this for penetration testing?

The current focus is coding and building. The stack is general-purpose Linux on Android; treat it as a portable development lab.

How is this different from bare Termux?

Bare Termux GrokHunter Rootless
Packages Termux repos Full Kali apt
Grok Extra setup One flag (--with-grok)
Desktop Limited XFCE + Termux:X11
Identity Generic shell Coding-lab profile + skills

What is the default AI agent?

Grok Build (grok / grokhunter). Optional: Aider with the same xAI key.

Which desktop should I pick?

XFCE is the recommended default (light, familiar, works well with Termux:X11).

Do I need Termux:X11?

Only if you want a graphical desktop. Shell + grok is enough for most pair-programming sessions.

Can I use this on a tablet?

Yes. Larger screens work well with nh-x11 + XFCE.

How do I update?

Use overlay-only so you do not re-enter the termux-distro / rootfs path:

# Clone:
cd ~/GrokHunter && git pull
bash install.sh --overlay-only --with-completions
grokhunter ensure
grokhunter skills install

# One-liner (no git):
GROKHUNTER_REFRESH=1 bash <(curl -fsSL https://raw.githubusercontent.com/FineComputer14451/GrokHunter/main/install.sh) \
  --overlay-only --with-completions

Can I add features without re-downloading Kali?

Yes — overlay-only (no rootfs / termux-distro):

bash install.sh --overlay-only --with-x11 --with-aider
bash install.sh --overlay-only --with-grok --with-v9-models --with-completions
# refreshes CLI wrappers + skills under ~/.local/bin and ~/.grok/skills

Product skills are any skills/<name>/SKILL.md in the repo. grokhunter skills install copies all of them. Core health is still the coding trio (skills=N/3); x11-desktop and nethunter-recon are optional.

Coding Team agents (true multi-agent system prompts): benjamin, lucas, harper, coding-team install to ~/.grok/agents/. Grok loads them at runtime via /config-agents or spawn subagent_type. See CODING-TEAM.md.

Requires at least one --with-* flag.

How do I check V9 model pickers / API key?

grokhunter models status
grokhunter models install
grokhunter ai-smoke          # SpaceXAI Responses smoke (needs XAI_API_KEY)
bash scripts/ci-unit.sh      # local unit checks (no network)

Where are secrets stored?

~/.grok/secrets.env (mode 600). Never commit this file.

Can I use local models?

Grok Build is cloud-oriented. For local models, use tools like Cline/Aider with Ollama on a machine that can run them; phones rarely have enough RAM for strong local coding models.

Is this affiliated with xAI or Offensive Security?

No.