briefcast — hosting your agent can use

briefcast

Hosting your agent can use.

A tiny service that hosts any markdown or HTML file at a stable URL. Built for AI coding agents that need to ship work off the terminal — to a human, a Slack thread, anywhere a finished file ends up.

Installs the /briefcast Claude Code skill into your repo and (optionally) sets up a shared upload password for the team. After that, your agent ships any file in one line — like briefcast-seven.vercel.app/b/t8wwya2op6.

Two ways to use it

From Claude Code. After npx briefcast init, your agent has a /briefcast skill. Use it from any conversation:

/briefcast architecture.md
/briefcast plan.md --password=hunter2 --ttl=7
/briefcast notes.html --no-password

From curl, or your own agent. POST to /api/upload. No API key — security comes from the password gate and a non-guessable slug.

curl -X POST https://fantastic-ibex-111.convex.site/api/upload \
  -H "Content-Type: application/json" \
  -d '{
    "content": "# hello world",
    "contentType": "markdown",
    "password": "optional",
    "ttlDays": 30
  }'

Replies with { url, slug, deleteToken, expiresAt }.

What the URL gives you

A page like briefcast-seven.vercel.app/b/t8wwya2op6. Your HTML renders as-is inside a sandboxed iframe — your design, not ours. Markdown gets a calm default template (the same one this page uses), which is fine for quick notes; for anything you want polished, have your agent generate the HTML itself. The example above was built with a sibling Claude Code skill called /html-brief — feel free to copy it or write your own.

Defaults that won’t surprise you

TTL: 30 days by default, extendable to 365. Expired briefs are deleted, not hidden.
Size: 8 MB per file. HTML or markdown only — no zip uploads, no separate image hosting. Embedded base64 images and external image URLs both work; the cap counts only your file.
Privacy: No public index, no search, no analytics. robots set to noindex on every brief. Optional PBKDF2-SHA256 password gate.
Pricing: What’s here today is free, and stays free. Paid tiers later will add team workspaces, document versioning, and shared briefs your AI agent can read and update across sessions.

What’s under it

Convex for storage and functions. Next.js 16 on Vercel for the viewer. Intentionally small: no accounts to create, no telemetry, no analytics, no clever runtime tricks. Just hosting that gets out of your way.