Agent intent
A narrow request enters through HTTP, CLI, SDK, or MCP.
authenticated requestRun agent code with Sandbox. Verify website delivery with Site. Review Kubernetes package changes with Infra. Three independent open-source projects, built for operators who want explicit boundaries and inspectable results.
New: Infra Public Alpha — explore the GitOps compiler ↗Models propose. Hullwork makes the surrounding system explicit: who is asking, where code runs, what gets deployed, and how success is proven.
A narrow request enters through HTTP, CLI, SDK, or MCP.
authenticated requestUntrusted work executes inside a tenant-scoped gVisor Pod.
fail closedThe workload converges through Kubernetes and becomes reachable.
desired → observedThe live address is fetched and bounded proof is recorded.
status + sha256Adopt each project independently. Infra works with external packages and an existing Argo CD installation; it is not a prerequisite for Sandbox or Site.
Run an agent's shell and file operations inside its own Kubernetes gVisor Pod. Durable workspaces outlive disposable runtimes. Missing dependencies never become permission to execute on the host.
$ make quickstart
[1/5] checking host prerequisites
✓ kubeadm cluster ready
✓ gVisor kernel verified
✓ workspace survived restart
✓ host fallback blocked
sandbox-ready
Turn an agent request into a real Kubernetes deployment. Site handles admission, builds, workloads, ingress, observability, and scale-to-zero—then proves the address serves traffic.
5e7f06f9…12178242Catch invalid package combinations before deployment. Infra validates declared capabilities and artifact locks, then compiles your records into deterministic Argo CD YAML for review.
Use your existing Argo CD; no companion repository or Lima management cluster required. Static checks validate your records, not live cluster readiness.
Package catalog + Stack
ClusterProfile + VersionLock
↓
Validate contracts & capabilities
↓
Compile Argo CD YAML
↓
Review and commit to Git
↓
Existing Argo CD reconciles
Identity, runtime, resource, and network boundaries are concrete architecture—not prose around a model call.
tenant ≠ request fieldA green API response proves admission. Hullwork follows the system until the running result can be measured.
deployed → fetch → recordIf isolation, control, or runtime dependencies disappear, the operation stops. There is no convenient local escape hatch.
fallback_to_host = falseWorkspaces, credentials, control-plane state, and the Kubernetes substrate stay in the environment you operate.
your infra · your dataAll three projects are independent and MIT-licensed. Sandbox and Site offer local deployment quickstarts. Infra starts with offline validation; its working example takes you through deployment with Argo CD.
git clone https://github.com/hullwork/infra.git
cd infra
python3 -m venv .venv
.venv/bin/pip install -r requirements-dev.txt
make validate
make render-applications
This demo renders a placeholder package. Use the hello walkthrough ↗ for a real deployment.
git clone https://github.com/hullwork/sandbox.git
cd sandbox
make quickstart
git clone https://github.com/hullwork/site.git
cd site
make quickstart
Bring a real workload. Help improve package examples, first-run docs, and validation errors, or contribute reproducible OCI and remote-cluster checks for Infra.