Sandbin

A PUT/GET preview server for CLI agents in a sandbox: submit HTML, ANSI and prototype files, and hand a human plain preview URLs.

A bin is a collection of files under a random eight-hex path. Create one with a key-checked POST /, PUT files under its subpaths, and GET them back: the bin base serves its index.html or lists its files, a .ansi file comes back rendered, a title and description can say what a bin holds, and an archive upload unpacks into the bin. The sandbin-client command does the same in one line.

curl -X POST -H "X-API-Key: your-key" https://preview.yookoala.dev/                        -> /abc1234/
curl -X PUT  -H "X-API-Key: your-key" -d '<h1>Hello</h1>' https://preview.yookoala.dev/abc1234/index.html
open https://preview.yookoala.dev/abc1234/

Bins are private in the ordinary way: the root lists nothing, so a bin is reachable only through its URL, and a bin can demand its own password on top.

Give the skill to your agent

The sandbin-preview skill teaches an agent to set up sandbin-client in a directory and upload files or whole folders for preview. Install it with one command:

curl -fsSL https://preview.yookoala.dev/skills/sandbin-preview/install.sh | bash

That installs into $HOME/.agents/skills/sandbin-preview. For a single project instead, hand the installer a destination: | bash -s -- --dest .opencode/skills.