zipbox-caddy

Add and remove HTTPS reverse-proxy sites in Caddy using the validated tribes-caddy CLI.

1|Updated Jun 17, 2026
One-click install
npx skills add https://github.com/tribes-protocol/trading-harness --skill zipbox-caddy-tribes-protocol
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: zipbox-caddy
Source: https://github.com/tribes-protocol/trading-harness/tree/main/skills/zipbox-caddy
Command: npx skills add https://github.com/tribes-protocol/trading-harness --skill zipbox-caddy-tribes-protocol

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Caddy is the only thing standing between the browser and this sandbox VM: it terminates TLS and reverse-proxies the web terminal. A single bad hand-edit to the Caddyfile kills all browser access to the machine, and because Caddy runs under runit with admin off, the usual reload/stop commands do not work. This Skill provides a safe, validated path for changing Caddy's site configuration without risking a lockout. ## Core Features & Use Cases - Validated site management: Add or remove HTTPS reverse-proxy sites with tribes-caddy add <host> <upstream> and tribes-caddy rm <host>, which write a candidate config, validate it, swap it atomically, and health-poll the web terminal after restart. - Automatic rollback: A last-known-good config is kept and restored automatically if anything goes wrong, so a bad change causes a ~1s blip instead of a lockout. - Built-in guardrails: add and rm refuse to touch the terminal's own hostname, and no DNS step is needed because a platform wildcard already resolves every name under the sandbox apex. - Use Case: You start a dev server on port 3000 inside the sandbox and want it reachable over HTTPS. Run tribes-caddy add app.hish.zipbox.ai 127.0.0.1:3000 and Caddy obtains an ACME certificate and serves the site immediately. ## Quick Start Ask the agent to add an HTTPS site for your local server, for example: "Add a Caddy site for app.hish.zipbox.ai proxying to 127.0.0.1:3000 using tribes-caddy."

Frequently Asked Questions about zipbox-caddy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add an HTTPS reverse-proxy site in Caddy safely?▼

Use `tribes-caddy add <host> <upstream>`, for example `tribes-caddy add app.hish.zipbox.ai 127.0.0.1:3000`. The CLI validates the candidate config, swaps it in atomically, health-polls the web terminal, and rolls back automatically if anything fails.

Why does caddy reload or caddy stop not work in this sandbox?▼

Caddy is supervised by runit and runs with `admin off`, so there is no admin endpoint for reload or stop commands. The only way to change behavior is edit-then-restart, which the tribes-caddy CLI handles with validation and health checks.

Do I need to create a DNS record before adding a Caddy site?▼

No DNS step is needed. A platform wildcard already resolves every name under the sandbox's apex hostname to this VM, so Caddy can obtain an ACME certificate as soon as the site is added.

What happens if a Caddy config change breaks the web terminal?▼

The tribes-caddy CLI health-polls the web terminal after every restart and automatically restores the last-known-good config if the check fails. Worst case is a roughly one-second websocket blip, and SSH access survives regardless.

Can I accidentally remove the site serving the web terminal?▼

No. The `add` and `rm` commands refuse to touch the terminal's own hostname, so you cannot redirect or delete the site that serves the browser terminal.