Aegis & Klethron two-layer security for local agents.
OTHRYS runs local coding agents across desktop and workstation nodes to build and verify web utilities. Every live tool call passes through Aegis 1.0 (the ~14 µs hot-path firewall), while Klethron 0.1 watches repos, static CSP bundles, open sockets, and SHA-256 ledgers from an airgapped cold path.
Aegis 1.0 guards what an autonomous agent tries to do right now. Klethron 0.1 was added as an airgapped outer ring so OTHRYS can verify that repositories, deployed bundles, cloud RLS, open sockets, and the audit chain itself remain intact between sessions.
01 · WHAT AEGIS ALREADY COVERS
Inner pre-syscall enforcement
Aegis 1.0 inspects every agent tool call inline (~14 µs, zero LLM tokens). Inside an approved repo root, normal work passes silently; path escapes, secret reads, SSRF targets, and destructive shell ops trigger PASS, ASK, DENY, or LOCK.
02 · THE GAP WE CLOSED
Health outside single tool calls
Blocking one dangerous syscall does not prove whether surrounding repo commits carry leaked credentials, static utility bundles preserve strict CSP headers, cloud RLS policies remain closed, or stray 0.0.0.0 sockets stayed bound.
03 · THE KLETHRON ADDITION
Cold-path posture & ledger witness
Klethron 0.1 wraps a passive outer ring around Aegis: it merges bounded offline sensor snapshots with Aegis's SHA-256 hash-chained log without modifying disk, git, or policy—failing dark if any signal is missing or >24h stale.
Ring 01 (Aegis 1.0) vs. Ring 02 (Klethron 0.1) responsibilities
Dimension
Ring 01 · Aegis 1.0 (Hot Path)
Ring 02 · Klethron 0.1 (Cold Path)
Primary role
Enforces every live agent tool call before execution
PASS / HOLD / UNKNOWN status where Unknown != Green after 24h
02 / WHAT'S NEW · NOVEMBER 2026
Recent hardening & Klethron perimeter rollout
Following SIMPLIFY-01 consolidation, the security architecture pairs upgraded inner parser & SSRF defenses with a lean 8-track passive perimeter—eliminating background collector daemons and silent false greens.
NEW · KLETHRON 0.1 PERIMETER
Cold-path threat fusion & posture ring
Adds a passive outer observation layer that correlates static bundle CSP/zero-egress, repo OPSEC, cloud RLS/quotas, and local socket posture without custom SIEM daemons.
HARDENED · OFFLINE DNS SSRF
Wildcard rebinding blocked offline
Custody now decodes .sslip.io, .nip.io, .xip.io, .traefik.me, localtest.me, lvh.me, and vcap.me (dotted, dashed, and 8-hex IPv4) locally before any HTTP fetch occurs.
HARDENED · MULTI-SHELL PARSER
ANSI-C hex & cmd caret unescaping
Tartarus strips POSIX $'\x72\x6d' hex/octal escapes and Windows cmd caret (^) obfuscation ahead of command classification, paired with PowerShell subexpression checks.
VERIFIED · LEDGER WITNESSING
Hash-chained aegis.decision.v1 trail
Every hot-path ALLOW, ASK, DENY, or LOCK writes an unbroken SHA-256 chain; Klethron verifies the rolling witnessTip and flags truncated or modified local logs.
POLICY · TRUTH-IN-STATUS
Unknown != Green enforcement
Missing credentials, disconnected sensors, or >24h stale readings automatically degrade to UNKNOWN across CLI reports and owner dashboards instead of silent green.
CORPUS · OWASP AGENTIC TOP 10
Offline adversarial Dojo regression
Aegis Dojo includes offline regression probes covering ANSI-C destruction, caret splitting, wildcard DNS SSRF, indirect prompt injections, and canary leaks.
03 / ARCHITECTURE MAP
How the hot path and cold perimeter work together
Select a scenario below to trace how ordinary workspace calls clear silently, boundary violations quarantine pre-syscall, high-blast commands ask the owner directly, and Klethron audits everything offline.
Trace a request or audit path
All LayersFull two-ring architecture: every agent call passes through Aegis 1.0 in ~14 µs, writes to an append-only SHA-256 ledger, and is audited offline by Klethron 0.1 without granting automated control.
Autonomous Coding Agents
Untrusted Tool CallsFile · Shell · HTTP / MCP
Local coding assistants and build workers emit filesystem, command, or network calls. No agent ever holds raw bypass authority over the OS gate.
Pre-syscall interception (file read/write, subprocess, or egress)
Asking a second language model to judge the first adds latency, burns tokens, and fails under indirect prompt injection. Aegis & Klethron run pure deterministic parsers and hash checks—no prompt can persuade a parser.
PRINCIPLE 02 · ERGONOMICS
Zero prompts inside the workspace
Inside an approved repository root, agents read files, edit code, and run test suites without confirmation popups. The gate only intervenes when a call crosses workspace, credential, or destructive-command boundaries.
PRINCIPLE 03 · AIRGAP
Observe vs. Deny separation
Aegis subtracts authority via a monotonic 7-level ratchet. Klethron only observes on a cold read-only path (authorityGranted: false) behind an execution airgap—eliminating solo-operator self-lockout risk.
05 / INNER & OUTER DOMAINS
Five defense clans plus one cold-path perimeter
Mythological names map directly to concrete engineering boundaries—making it clear at a glance which subsystem owns path containment, shell normalization, secret scrubbing, rate limits, tripwires, or estate posture.
CLAN 01 · PATH · Workspace & Path Containment
Labyrinth
Resolves symlinks, recursive URL encodings, null bytes, Windows Alternate Data Streams, and credential dotfiles (~/.ssh, ~/.aws, .env) before any file operation executes.
CLAN 02 · EXEC · Shell, SQL & Process Shield
Tartarus
Quote-aware POSIX, PowerShell, and CMD parser with ANSI-C $'...' and caret (^) unescaping—blocking destructive chains while keeping in-workspace builds silent.
CLAN 03 · EGRESS · Secrets & SSRF Airlock
Custody
Redacts live keys and tokens in flight and blocks cloud-metadata SSRF across hex, octal, IPv6, and offline wildcard DNS services (.sslip.io / .nip.io / localtest.me).
CLAN 04 · RATE · Loop & Escalation Brakes
Hecatoncheires
Concurrency sentinel that halts runaway identical tool calls in milliseconds and locks sessions that trip repeated boundary violations within a rolling window.
CLAN 05 · SENSOR · Canary Tripwires & Leak Sensor
Minotaur
Monitors decoy credential files that legitimate tasks never touch and escalates immediately if private reads combine with untrusted inputs and outbound egress.
OUTER RING · KLETHRON 0.1 · Cold-Path Posture & Witness
Klethron Perimeter
Audits public repos for LAN/path leaks, verifies static utility CSP headers and zero-egress, checks 0.0.0.0 local binds, and anchors Aegis SHA-256 ledger tips read-only.
06 / INTERACTIVE WALKTHROUGH
Inspect gate verdicts in your browser
Select a workspace task or an adversarial probe below (including offline .sslip.io DNS rebinding and POSIX ANSI-C / caret escapes) to see how Aegis decides with zero model tokens.