METATRON — lightweight Ollama terminal harness with system access

README.md

@@ -0,0 +1,34 @@
+# 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. Type `metatron` to launch.
+
+## Flow
+1. **Model selection** — fetches the live model list from nightmare, numbered menu.
+2. **Chat** — streaming REPL against the selected model.
+3. **System access** — two ways:
+   - `!command` — run a shell command directly (e.g. `!dir`, `!whoami`).
+   - The model calls `run_command` natively (function calling) to execute commands itself.
+
+## Requirements
+- Python 3.11 (stdlib only — `urllib`, `subprocess`, `json`). No pip deps.
+- Network reach to `10.30.20.29:11434`.
+
+## 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`
+- System prompt + `run_command` tool definition
+- Only the model list is dynamic (fetched from `/api/tags`).
+
+## Controls
+| Input | Action |
+|-------|--------|
+| `exit` / `quit` | leave |
+| `!<command>` | run a shell command directly |