Skip to content

EDITORS.md

Latest commit

 

History

History
93 lines (67 loc) · 3.01 KB

EDITORS.md

File metadata and controls

93 lines (67 loc) · 3.01 KB
Raw

Editors & Pair Programmers on GrokHunter Rootless

Default intelligence: Grok 4.6 via Grok Build (grok / grokhunter).
This doc covers optional tools that complement it.

Default path (--with-grok)

grok                       # interactive pair session (Grok 4.6-class)
grokhunter -p "…"          # headless one-shot
grokhunter plan "…"        # plan larger changes first
nh-x11                     # XFCE desktop for editors (if --with-x11)

See also: GROK-46.md.

Aider + Grok 4.6 (recommended optional)

Aider is a terminal pair-programmer that works well inside the Kali proot. Use the same xAI key.

Why installs used to fail

  • Python 3.13: Kali’s default python3 is often 3.13; aider-chat requires ≥3.10,<3.13.
  • Missing ensurepip: python3 -m venv fails without python3-venv / python3-full.
  • Plain pip install aider-chat into a 3.13 venv therefore fails on current NetHunter images.

GrokHunter’s installer now uses the official uv + managed Python 3.12 path (scripts/install_aider.sh).

Install

# Via installer flag (preferred):
bash install.sh --with-aider
# Or without touching rootfs:
bash install.sh --overlay-only --with-aider

# Repair / reinstall only Aider (inside nethunter or clone):
bash ~/GrokHunter/scripts/install_aider.sh
GROKHUNTER_FORCE_AIDER=1 bash ~/GrokHunter/scripts/install_aider.sh

# Official upstream one-liner (same idea):
curl -LsSf https://aider.chat/install.sh | sh

The installer also places the aider-grok helper in ~/.local/bin and (when possible) inside the rootfs.

Configure for Grok / xAI (Grok 4.6 tier)

[[ -f ~/.grok/secrets.env ]] && source ~/.grok/secrets.env
export OPENAI_API_BASE=https://api.x.ai/v1
export OPENAI_API_KEY="${XAI_API_KEY}"

# Default in aider-grok is already grok-4.6
# Override only if your account exposes a different coding id:
# export AIDER_MODEL=grok-4.6

Usage

cd /path/to/your/project
aider-grok                 # recommended helper (auto model + secrets)
# or (uv tool install puts aider on PATH)
aider --model "${AIDER_MODEL:-grok-4.6}"
aider-grok main.py utils.py   # limit to specific files

Tips:

  • Aider auto-commits by default — good for mobile history.
  • --no-auto-commits if you prefer manual commits.
  • Never commit ~/.grok/secrets.env.
  • Env: GROKHUNTER_AIDER_METHOD=auto|uv|venv|curl, GROKHUNTER_FORCE_AIDER=1.

Lightweight editors on device

Tool When to use
nh-x11 + XFCE Full desktop
nvim / micro Terminal editing inside nethunter
Acode Native Android editor beside Termux 
sudo apt install -y neovim micro

Recommendation

  1. Default: grok / grokhunter optimized for Grok 4.6.
  2. Aider (aider-grok) when you want git-native auto-commit pairs on the same key.
  3. Desktop: nh-x11 when you need a visual editor.

Playbook: skill editor-lab · grokhunter editor. Aider: skill aider-grok.