| name | evez-os |
| description | Forensic game engine with immutable audit spine, FSC (Failure-Surface Compression), contradiction detection SAT solver, self-play loop, and visual cognition mapping. Runs offline. Zero dependencies beyond Python 3. ClawHub-ready.
|
| version | 1.0.0 |
| metadata | {"openclaw":{"requires":{"bins":["python3"]},"emoji":"🔬","homepage":"https://github.com/EvezArt/evez-os","os":["linux","macos"]}} |
EVEZ OS — Forensic Game Engine
"The game can't end because the attack surface can't end."
A self-auditing forensic game engine that probes systems, detects contradictions,
maps failure surfaces, and generates infinite adversarial missions from its own traces.
Quick Start
cd core
python3 tools/evez.py init
python3 tools/evez.py play --seed 42 --steps 14
One-Command Demo
cd core && python3 tools/run_all.py --seed --mode spicy
Play Forever
python3 tools/evez.py play --loop --steps 14
Android (Termux)
pkg install python
git clone https://github.com/EvezArt/evez-os.git
cd evez-os/core
python tools/evez.py init
python tools/run_all.py --seed --mode spicy
Add to Termux:Boot for autorun — see ANDROID.md.
All Commands
| Command | What It Does |
|---|
evez.py init | Initialize event + ARG spines |
evez.py play --seed N --steps N | Generate forensic episode |
evez.py play --loop | Infinite self-play |
evez.py cycle --ring R4 --anomaly "desc" | Log FSC cycle |
evez.py lint | Audit spine for violations |
evez.py arg-init | Initialize ARG spine |
evez.py arg-narrate --tail N | Narrate from spine tail |
evez.py trigger | Auto-generate missions |
self_cartography.py | Mermaid + DOT diagrams |
run_all.py --seed --mode spicy | Full demo |
Packs
- CTF (
packs/ctf/) — 6 forensic challenges + contradiction engine (SAT solver)
- Cheatcodes (
packs/cheatcodes/) — 5 cognitive debugging tools
- Reality Map (
packs/reality_map/) — Architecture diagrams
Truth Planes
- PERCEPTION — One vantage. Never trust alone.
- PENDING — Hypothesis with named falsifier. Default.
- FINAL — Passed falsifier gate from 2+ vantages.
- CANON — Community-verified, spine-logged.
License
AGPL-3.0 — Community edition. Commercial license available.
Author
Steven Crawford-Maggard (EVEZ) — @EVEZ666
