METATRON — lightweight Ollama terminal harness

A minimal terminal harness for talking to Ollama (hosted on nightmare 10.30.20.29:11434) with full system access, internet search, and the Commando tool catalog organized as a lazy discovery tree. Type metatron to launch.

Flow

  1. Model selection — fetches the live model list from nightmare, numbered menu (sizes shown, Enter reuses the last model).
  2. Chat — streaming REPL against the selected model.
  3. System access — !command runs a shell command directly; the model can also call run_command natively (function calling).
  4. Search — ?query searches (SearXNG); ?fetch <url> reads a page.
  5. Tool discovery tree — the Commando toolset is organized by category and discovered lazily, so the model never has all tools dumped into context at once.

Tool discovery tree

The catalog (~55 tools across 10 categories) is NOT sent to the model. Instead the model gets 4 native tools and drills in on demand:

list_categories            -> see the 10 categories (recon, web, exploit, post, crack,
                              wireless, sniff, osint, forensics, utils)
list_tools("<category>")   -> see the tools + usage in one category
run_command                -> actually execute a tool
web_search                 -> internet facts

Categories:

  • recon (10) — nmap, masscan, rustscan, netdiscover, arp-scan, amass, sublist3r, theHarvester, dnsrecon, whatweb
  • web (7) — nikto, gobuster, dirb, ffuf, wpscan, sqlmap, commix
  • exploit (3) — msfconsole, searchsploit, msfvenom
  • post (10) — impacket-*, crackmapexec, evil-winrm, mimikatz, bloodhound-python, responder
  • crack (4) — hashcat, john, hydra, medusa
  • wireless (3) — aircrack-ng, airmon-ng, bettercap
  • sniff (4) — tshark, tcpdump, mitmproxy, ettercap
  • osint (4) — theHarvester, sherlock, holehe, spiderfoot
  • forensics (4) — volatility, binwalk, exiftool, strings
  • utils (6) — nc, socat, proxychains, curl, certutil, powershell

Controls

Input Action
exit / quit leave
!<command> run a shell command directly
?<query> search the internet (SearXNG) directly
?fetch <url> read a page's text
/tools list tool categories
/tools <cat> list tools in a category
/save save the session to markdown
/help help

Requirements

  • Python 3.11 (stdlib only — urllib, subprocess, json). No pip deps.
  • Network reach to 10.30.20.29:11434 and 10.30.20.35:6969.

Install (Commando VM)

mkdir C:\Tools\metatron
copy metatron.py metatron.bat C:\Tools\metatron\
setx PATH "%PATH%;C:\Tools\metatron"

Then metatron from any shell.

Hardcoded

  • Ollama URL: http://10.30.20.29:11434
  • SearXNG URL: http://10.30.20.35:6969 (self-hosted meta-search, CT 516)
  • System prompt, tool catalog, and run_command / web_search / list_categories / list_tools tool definitions
  • Only the model list is dynamic (fetched from /api/tags).

Notes

  • ?<query> is the guaranteed search path (no LLM needed).
  • Native tool-calling can degenerate on nightmare .29 under GPU load; the manual escapes (!, ?, /tools) always work.
  • keep_alive: "30m" keeps the model resident to avoid reload latency.
Description
METATRON - lightweight Ollama terminal harness (system access)
Readme 55 KiB
Languages
Python 95.5%
Shell 4.3%
Batchfile 0.2%