aergia

Aergia turns a phone into a control plane for fleets of autonomous coding agents. Its defining piece is a transparent sandboxing layer: SDK PreToolUse hooks intercept each agent's file and shell tools — Read, Write, Edit, Glob, Grep, Bash — and re-execute them inside a per-project Docker container. Paths are rewritten between host and workspace, and every container is locked down with no-new-privileges, a read-only root filesystem, disabled networking, a non-root user, and memory/CPU caps.

A single Node.js gateway composes a 40-command grammY Telegram bot, a Hono HTTP/WebSocket API, and a typed 115-event bus that streams agent output and state live into a React 19 dashboard.

On top sits a multi-agent workflow engine with four execution topologies: single, pipeline, parallel fan-out, and shared-memory collaborative. It adds rate-limit-aware model failover, mid-stream token-limit enforcement, git checkpoint/restore, and scoped persistent memory. GitHub automation is gated by three autonomy levels, and force-push always requires human approval.

It runs 24/7 on self-hosted infrastructure and is built like a service: ordered startup-recovery and graceful-shutdown sequences, container health monitoring with auto-restart, prompt-injection scanning, and output secret-scrubbing. The codebase is an 11-package TypeScript monorepo (~28K LOC over an 18-table SQLite schema under Drizzle), held to strict TypeScript, zero-warning typed ESLint, and Knip dead-code gates.