agentos-mirror

Documentation

Overview

Command agentos-mirror serves the AgentOS oversight console over a READ-ONLY proxy to an upstream agentosd — e.g. a live production org. It lets you watch the REAL fleet (real lanes, real failures, real tamper-proof audit chain) in the same console you'd demo, without any ability to change it.

Only safe, read-only paths reach the upstream:

GET  /proc, /proc/...   — the measured-truth projection
GET  /audit, /audit/verify, /audit/export — the tamper-evident trail
POST /audit/verify      — re-prove a SUPPLIED chain (never mutates the upstream)

Every other request (ticket submission, signals, org-config — every mutation) is refused with 405. The console reads `/__console_config__`, sees readonly, hides "Start agents", and renders the upstream's real lanes as the agents.

agentos-mirror --upstream http://127.0.0.1:8088 --addr 127.0.0.1:18090 --label "live org"

Standard library only.