ZES System — Zero Entropy System

One-command installer for the ZES agent trinity on Termux/Android.

Quick Install

curl -fsSL https://raw.githubusercontent.com/zesxdev/zes/main/install.sh | bash

What It Sets Up

• VPN Bridge — 3 Tor circuits (:19050 Hermes, :19051 Codex, :19052 Claude)
• Error Bridge — Kiwi/Chrome extension for capturing devtools errors
• Rate Monitor — Auto-rotate Tor at 90% backoff via runsv
• SSH — Admin access on :8022
• CLI Tools — zproxy, zsupercontext, zautofetch, zerrors, ztree-obsidian

Architecture

Agent → zproxy(:1905X) → Tor Circuit X → Provider
         Each agent gets a unique exit IP

Post-Install

1. Add API keys to ~/.secure-credentials/master.env
2. Start bridge: zproxy start && zproxy status
3. Load extension in Kiwi: chrome://extensions → Load unpacked

Files

Path	Purpose
install.sh	One-command installer
bin/*	CLI tools (zproxy, zerrors, etc.)
extension/*	Kiwi/Chrome error bridge extension
configs/*	Configuration templates

Private backup

The full config + per-agent restore instructions live in the private sibling repo zes-private (collaborator-only, secrets excluded).