Publish static HTML to a public URL. One command. No server.

"I did it before Claude Artifacts became a thing..." 😭

Your agent makes HTML — a dashboard, a report, a one-off page. Sharing the file is a pain, and the links break the moment it leaves your machine.

htmlup turns it into a link:

$ htmlup publish ./report.html
https://you.github.io/pages/report.html

It pushes your files to a backend you already have and prints the public URL. Two ship today — GitHub Pages (served from a repo) and S3 (fronted by CloudFront) — and adding more is a single provider package. No server to run, no hosting account to sign up for.

brew tap truehhart/tap
brew trust truehhart/tap   # one-time: Homebrew 6+ requires trusting non-official taps
brew install --cask htmlup

No Homebrew? Grab a prebuilt binary (verify it) or build from source.

htmlup publish ./site                              # your default profile
htmlup publish github ./site --repo owner/repo     # GitHub Pages
htmlup publish s3 ./site --bucket my-bucket        # S3 (via CloudFront)

Pass a file or a directory; directories upload recursively. URLs print to stdout, one per line — htmlup … > urls.txt captures just the links. Add --dry-run to preview, -v for progress.

GitHub Pages targets are auto-detected from the repo's Pages settings, so you rarely need --branch/--dir. htmlup only ever uploads — it never deletes; setup github installs an opt-in cron workflow to expire old pages.

No credentials stored — each SDK uses its own standard mechanism:

• GitHub — GITHUB_TOKEN / GH_TOKEN, or whatever the gh CLI already has.
• AWS — the default credential chain (env vars, ~/.aws/credentials, SSO, instance role).

This repo is also a Claude Code plugin marketplace — install the skill and Claude can drive the CLI for you:

/plugin marketplace add truehhart/htmlup
/plugin install htmlup@htmlup

htmlup setup github --repo owner/name [--branch gh-pages] [--ttl-days 30] [--cron "0 3 * * 0"] [--cname example.com] [--exclude staging,*.keep] [--dry-run] [-v]

mise install        # go 1.26, nushell, golangci-lint, gofumpt, goreleaser
mise run setup      # download deps + install pre-commit hook
mise run build      # produces ./bin/htmlup
mise run check      # fmt + vet + lint + test (also runs on pre-commit)

# 1. Verify checksums (download the binary + SHA256SUMS first)
sha256sum --check htmlup_*_SHA256SUMS        # Linux
shasum -a 256 --check htmlup_*_SHA256SUMS    # macOS

# 2. Verify cosign signature (keyless)
cosign verify-blob \
  --certificate htmlup_*_SHA256SUMS.pem \
  --signature htmlup_*_SHA256SUMS.sig \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com \
  --certificate-identity-regexp 'github\.com/truehhart/htmlup' \
  htmlup_*_SHA256SUMS

# 3. Verify GPG signature
gpg --import release/pubkey.asc
gpg --verify htmlup_*_SHA256SUMS.gpgsig htmlup_*_SHA256SUMS

_{Working software, early days — expect rough edges. Design notes: docs/ARCHITECTURE.md · MIT © Dmitrii Parshenkov}