sharelisted

# share Turn any HTML an agent made — a rendered plan, a data viz, a report — into a link a human can open through the managed Phoenix share endpoint, or the user's own Cloudflare R2 when BYO is configured. The page outlives the agent that made it. `/share` is the one command. Public is the default; `--private` is a modifier. ## When to reach for this - An agent rendered an HTML plan/viz/report and the user wants to *see* it or *send* it — don't leave it in `/tmp` where only this machine can open it. - An `artifacts` / dashboard / infographic step just produced a file. - The user says "share it", "make me a link", "publish this". ## Steps 1. **Resolve the file.** Strip `--private` from `$ARGUMENTS` if present (it is a mode flag, not a path). If a file remains, use it. If the args are empty, pick the most recent HTML artifact this session produced (a rendered plan, a viz — often under `/tmp` or `~/Downloads`). If you can't confidently identify one, ask which file. 2. **Check setup.** Run `agents artifacts share status`. If it prints no endpoint, offer `agents auth login` for the managed Phoenix endpoint. The explicit BYO alternatives remain `agents artifacts setup` (provisions an R2 bucket + Worker on the user's Cloudflare) or `agents artifacts share join <baseUrl>` (uses an existing endpoint). Then stop; do not sign in, provision, or join silently. 3. **Publish.** - **Public** (default): `agents artifacts share <file>` HTML pages get an