← Projekty

Aktivní · serverové preview

AgentBox

Izolované prostředí pro kódovací agenty s explicitním workspace a odděleným stavem.

Technologie

Python · Podman / Docker · Git worktrees

Vlastní přínos

Vlastní projekt pod účtem vojtabiberle; návrh vývojového prostředí a jeho bezpečnostních hranic.

Zdroje ověřeny

18. 10. 2026

Repozitář ↗ · Dokumentace ↗

Problém

Kódovací agent potřebuje spouštět příkazy, upravovat soubory a instalovat závislosti. Na běžném notebooku tak snadno dostane víc přístupu, než pro úkol potřebuje. AgentBox odděluje pracovní adresář, stav agenta a výslovně připojený kontext od zbytku počítače.

Architektura a rozhodnutí

Lokální profil spouští Claude Code, Hermes, Codex nebo Aider v Podmanu či Dockeru. Každý workspace a agent má vlastní perzistentní HOME. Další mounty a předané proměnné jsou explicitní; přihlašovací údaje hostitele se automaticky nesdílejí. Git worktrees umožňují oddělit rozpracované změny, nikoli oprávnění procesů.

Lokální běh má standardně síťový přístup. Serverový profil má jinou hranici důvěry: správcem řízenou politiku, rootless Podman, dočasný HOME a prostředí bez přímé IP sítě. Volitelný broker zprostředkovává omezená volání bez předávání provider credentials do workloadu. Projektový Dockerfile se v tomto profilu nepovažuje za důvěryhodnou konfiguraci.

Co je hotové a co ještě ne

Veřejná dokumentace popisuje always-on serverové preview a referenční review controller. U DEV pilotu je doložená izolace a jednorázové review diffu přes Anthropic bez publikace komentáře. Rotace secrets, plánované spouštění a publikování zůstávají mezi nedokončenými akceptačními body.

Tohle není hotový orchestrátor libovolných modelů. Integrace builderu, schvalovací brány a více nezávislých modelových reviews jsou další práce, ne vlastnosti, které bych tady chtěl slibovat.

Kompromisy

Kontejnery sdílejí kernel hostitele. Samotný kontejner tedy není úplná bezpečnostní hranice pro nedůvěryhodný kód. Záleží na mountovaných datech, síti, limitech a pravomocích brokeru. Lokální profil s perzistentním stavem a serverové preview mají odlišný threat model; nejde je zaměňovat.

Projekt používá BSL 1.1. Podmínky použití je potřeba ověřit v licenci; neoznačuji jej automaticky za open source.

Souvislosti

Jak přistupuji k agentickému vývoji · coding-worker: delegování úloh přes MCP